Compartir a través de


Campos personalizados

Azure DevOps Services

El uso de los campos personalizados permite almacenar los datos personalizados en la ejecución de pruebas o el resultado de la prueba. Puede haber hasta 100 campos personalizados definidos para un único proyecto de Azure DevOps. El administrador del proyecto puede administrar (agregar o eliminar) el conjunto de campos personalizados.

Administrar los campos personalizados

Hay dos maneras de administrar los campos personalizados: ya sea a través de la API REST o el administrador del proyecto pueden hacerlo a través de la configuración del proyecto al elegir Administración de pruebas en Canalizaciones. En esa página se puede agregar un nuevo campo personalizado haciendo clic en el botón + Agregar nuevo .

Captura de pantalla de la configuración del proyecto con la configuración de administración de pruebas seleccionada y el botón para agregar un nuevo campo personalizado marcado por rectángulo rojo.

Elija + Agregar nuevo para agregar un nuevo campo personalizado. Cada campo personalizado debe tener un nombre, un tipo configurado e indicar a qué tipo de artefacto se aplica.

Captura de pantalla de un cuadro de diálogo usado para agregar un nuevo campo personalizado.

El nombre del campo personalizado no puede tener más de 50 caracteres (no se permiten espacios, números y caracteres especiales) y debe ser único en el proyecto. Los nombres no distinguen mayúsculas de minúsculas, por lo que no puede tener un campo personalizado denominado "Test" y el otro denominado "test". El elemento Type puede ser uno de los siguientes:

  • bit
  • DateTime
  • Int
  • Flotante
  • Cadena
  • GUID

Los campos personalizados existentes se pueden editar (solo se puede cambiar el nombre) o quitarlos.

Nota:

Después de quitar el campo personalizado, no puede usar su nombre durante aproximadamente un día. El proceso en segundo plano que quita los campos personalizados eliminados de forma permanente se ejecuta uno al día.

Almacenamiento de datos personalizados en campos personalizados

Puede almacenar los datos personalizados en los campos personalizados configurados como parte de la creación de la ejecución o el resultado de la prueba o después de crear la ejecución o el resultado de la prueba. Ambos se pueden hacer con la API REST por ahora. En el futuro, permitiremos que los datos personalizados se recojan del archivo de resultados de la prueba. Para obtener los valores almacenados en los campos personalizados para la ejecución o el resultado de pruebas existentes, debe usar la API REST. Por el momento no se muestran los campos y valores personalizados almacenados en estos en la interfaz de usuario de Azure DevOps (agregaremos esa capacidad en el futuro).

Al crear la ejecución de pruebas o el resultado a través de la API REST y desea almacenar datos personalizados en un campo personalizado existente, la mejor opción es enviar los datos personalizados como parte de la ejecución de pruebas o la creación de resultados. Para crear una llamada de ejecución de prueba a las ejecuciones de la API REST: crear y crear resultados de la llamada de resultado de prueba: agregar.

Cuando la ejecución o el resultado de la prueba no se crean a través de la API REST, sino por otros medios, primero debe encontrar la identificación de la ejecución o el resultado de la prueba para el que desea establecer (o actualizar) los datos personalizados en los campos personalizados y, a continuación, llamar a ejecuciones de la API REST: actualizar para la ejecución de pruebas y resultados de la API REST: actualización para el resultado de la prueba.

Para recuperar los datos personalizados de los campos personalizados almacenados anteriormente en la ejecución de pruebas o el resultado, primero debe encontrar la identificación de la ejecución o el resultado de la prueba. A continuación, puede llamar a las ejecuciones de la API REST: consulta para la ejecución de pruebas y resultados de la API REST: obtener para el resultado de la prueba.

Los datos personalizados de los campos personalizados se envían o reciben en una matriz. Cada elemento de esa matriz contiene dos propiedades "fieldname" y "value" y puede ver un ejemplo de esto aquí. El valor es el objeto del tipo que coincide con el tipo configurado para el campo personalizado. Para comprender el tipo del campo personalizado, puede que quiera usar la API REST que proporciona una matriz de los campos personalizados. Para cada campo puede encontrar su identificador, nombre, tipo y ámbito. También puede codificar de forma dura el tipo si sabe cuál es el tipo del campo personalizado del nombre especificado.