Campos y atributos de elementos de trabajo en Azure Boards

Atributos para informes

Todos los atributos de informes solo son válidos para implementaciones locales cuyos proyectos se han configurado para admitir SQL Server reporting y SQL Server Analysis Services. Para obtener más información, vea Agregar informes a un proyecto.

Para obtener una descripción de cada atributo que se puede notificar, vea Agregar o modificar campos de elemento de trabajo para admitir informes.

Para obtener una lista de los campos que tienen atributos que se pueden notificar definidos de forma predeterminada, vea Referencia de campos que se pueden informar.

Campos indizados

Puede habilitar o deshabilitar la indexación de un campo de elemento de trabajo mediante el comando witadmin indexfield. Al habilitar la indización para un campo, puede aumentar el rendimiento de la búsqueda de elementos de trabajo cuyas consultas especifiquen ese campo. De forma predeterminada, se indizan los campos siguientes: Asignado a, Fecha de creación, Modificado por, Estado, Motivo, Identificador de área, Id de iteración y Tipo de elemento de trabajo.

Si agrega un campo personalizado que utilice en muchas de sus consultas de elemento de trabajo, quizá desee habilitar la indización para ese campo. Para obtener más información, vea Administrar campos de elemento de trabajo (witadmin).

Puede enumerar los atributos asignados a un campo mediante la API REST Fields - Get. Escriba el nombre de la organización en OrganizationName.

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

Por ejemplo, aquí enumeramos los atributos de la ruta de acceso de iteración, especificando el nombre de referencia, System.IterationPath , para la organización fabrikam.

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

Datos devueltos:

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
}

Puede enumerar los atributos asignados a un campo mediante la API REST Fields - Get. Escriba el nombre de la organización en OrganizationName. Para empezar a usar REST, consulte la referencia Azure DevOps Services API REST

https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}

Por ejemplo, aquí enumeramos los atributos de la ruta de acceso de iteración, especificando el nombre de referencia, System.IterationPath , para el servidor fabrikam.

https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1

Datos devueltos:

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}

Enumeración de atributos mediante witadmin la herramienta de línea de comandos

Puede enumerar los atributos de campo seleccionados,como el tipo de datos, los atributos que se pueden informar y la indexación, mediante el comando witadmin listfields.

Por ejemplo, puede escribir el siguiente comando para enumerar los atributos definidos para un campo especificado, como Microsoft.VSTS.Common.Issue.

witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue  

Se muestra la información de campo y atributo del campo especificado, como se ve en este ejemplo.

Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False  

El parámetro Use indica el nombre de cada proyecto y el tipo de elemento de trabajo donde se usa el campo.

Project integración y asignación de campos de proyecto

Puede cambiar cómo se asignan los campos de seguimiento de trabajo a los Project y cómo se publican los campos específicos. Consulte [The Microsoft Project Field Mapping File](/previous-versions/azure/devops/reference/xml/customize-project-field-mapping-file.

Para agregar campos a un proceso, debe agregarlos a uno o varios tipos de elemento de trabajo. Para más información, consulte Personalización de un proceso de herencia.

Puede agregar o modificar los campos contenidos en un WIT o agregar un WIT personalizado. Para más información, vea:

• Para colecciones de proyectos que usan el modelo de proceso de herencia: Personalizar un proceso de herencia.
• Para las colecciones de proyectos que usan el modelo de proceso XML local: personaliceel modelo de proceso XML local .

Puede cambiar el nombre del campo, el índice y los atributos de informe de cualquier campo, excepto los campos del sistema, mediante la herramienta de línea de comandos witadmin. Para obtener más información, vea Administrar campos de elemento de trabajo-witadmin.

Para agregar campos a un proyecto, debe agregarlos a uno o varios tipos de elemento de trabajo. Vea Agregar o modificar un campo para realizar un seguimiento del trabajo.

Puede cambiar el nombre del campo, el índice y los atributos de informe de cualquier campo, excepto los campos del sistema, mediante la herramienta de línea de comandos witadmin. Para obtener más información, vea Administrar campos de elemento de trabajo-witadmin.

• Referencia rápida de KQL
• Índice de campo de elemento de trabajo
• Agregar y administrar campos para un proceso heredado

• Referencia rápida de KQL
• Índice de campo de elemento de trabajo
• Elección del modelo de proceso para la colección de proyectos
• Agregar o modificar un campo para realizar un seguimiento del trabajo
• Administración de campos de elementos de trabajo-witadmin

• Referencia rápida de KQL
• Índice de campo de elemento de trabajo
• Agregar o modificar un campo para realizar un seguimiento del trabajo
• Administración de campos de elementos de trabajo-witadmin

Los campos de elemento de trabajo se usan para realizar un seguimiento de la información. Los campos se definen para una organización y se comparten entre todos los proyectos definidos para esa organización. Puede usar una de estas dos herramientas para revisar los campos definidos para la organización. Estas herramientas están disponibles para los modelos de proceso XML heredado y hospedado.

• Página web Campos de proceso
• Explorador de campos de elementos de trabajo

Los campos de elemento de trabajo se usan para realizar un seguimiento de la información. Los campos se definen para una colección y se comparten entre todos los proyectos definidos para esa colección. Puede usar una de estas dos herramientas para revisar los campos definidos para la colección.

• Proceso Página web Campos:disponible para el modelo de proceso heredado
• Explorador de campos de elemento de trabajo:disponible para los modelos de proceso XML heredados y locales.

Los campos de elemento de trabajo se usan para realizar un seguimiento de la información. Los campos se definen para una colección y se comparten entre todos los proyectos definidos para esa colección. Para ver todos los campos definidos para una colección, puede usar la herramienta Explorador de campos de elemento de trabajo, un complemento para Visual Studio.

Al agregar un campo personalizado a un proceso heredado, Azure DevOps asigna un nombre de referencia con el prefijo Personalizado y, a continuación, el nombre del campo con espacios quitados. Por ejemplo, agregue un campo denominado DevOps Triage, el nombre de referencia es Custom.DevOpsTriage. No se permiten espacios dentro del nombre de referencia.

Para ver el tipo de datos de los campos definidos para su organización, abra la página Campos de proceso.

Cuando la colección de proyectos usa el modelo de proceso de herencia para personalizar el seguimiento del trabajo, puede ver el tipo de datos de los campos abriendo la página Campos de proceso.

Si se usa el modelo de proceso XML local, puede buscar el tipo de datos a través del índice del campo Elemento de trabajo. O bien, puede abrir el Explorador de campos de elemento de trabajo para revisar los campos definidos y sus asignaciones de atributos, o usar el comando witadmin listfields para enumerar los atributos de campo. Para obtener más información, vea Explorador de campos de elemento de trabajo y Enumerar atributos de campo más adelante en este artículo.

Puede buscar el tipo de datos a través del índice del campo Elemento de trabajo. O bien, puede abrir el Explorador de campos de elemento de trabajo para revisar los campos definidos y sus asignaciones de atributos, o usar el comando witadmin listfields para enumerar los atributos de campo. Para obtener más información, vea Explorador de campos de elemento de trabajo y Enumerar atributos de campo más adelante en este artículo.

Página > web Campos de proceso

Para revisar la lista de campos definidos para una organización o colección, abra Configuración de la organización Campos de > proceso.

1. Elija el logotipo Azure DevOps para abrir Proyectos. A continuación, elija Configuración de la organización.

   

2. A continuación, elija Procesar.

   

   Nota

   Si no ve Proceso, está trabajando desde TFS-2018 o una versión anterior. No se admite la página Proceso. Debe usar las características admitidas para el modelo de proceso XML local.

3. A continuación, elija Campos.

   Los campos enumerados corresponden a todos los campos definidos para la organización o la colección. Esto incluye todos los campos personalizados y los definidos para los procesos del sistema.

   

   Nota

   Si no ve Campos ,la colección usa el proceso XML local. La página Campos no se admite para ese proceso.

   Para obtener descripciones y uso de cada campo, así como el nombre de referencia de cada campo, puede buscarlo en el índice del campo Elemento de trabajo. También puede obtener el nombre de referencia de los campos de la API REST Campo de tipos de elemento de trabajo - Enumerar.