Campos e atributos de item de trabalho nos Painéis do Azure

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Para obter uma descrição de cada campo definido com um processo do sistema, consulte Índice de campo de item de trabalho.

Pré-requisitos

• Para exibir os campos definidos para uma organização ou coleção, você deve ser membro do grupo de aplicativos Usuários Válidos da Coleção de Projetos ou ter a permissão Exibir informações no nível da instância definida como Permitir para a organização ou coleção.

Listar ou rever campos

Para listar ou revisar campos, você pode usar uma das seguintes ferramentas, dependendo do modelo de processo — Herança, XML hospedado ou XML local — usado. Para obter um índice de campos definidos dentro dos processos padrão, consulte Índice de campo de item de trabalho.

Tipos e nomes de dados de campo

Cada tipo de item de trabalho especifica os campos definidos para os itens de trabalho que fazem referência a esse tipo. Cada campo está associado a um número de atributos, muitos dos quais são definidos pelo sistema e não podem ser alterados.

Cada campo é definido pelos três atributos a seguir.

• Tipo de dados: especifica o tipo de dados que podem ser inseridos no campo, como Booleano, Duplo, Inteiro, HTML e String. Para obter descrições de cada tipo de dados, consulte Campos de consulta, operadores e macros.
• Nome amigável: especifica o nome atribuído ao campo e que você seleciona para um Campo em uma cláusula de consulta. Esse nome pode ser diferente do nome exibido no formulário de item de trabalho.
• Nome de referência: especifica o nome que você usa ao criar uma consulta WIQL ou um modelo de item de trabalho improvisado, usando comandos da API REST ou definindo definições de tipo de item de trabalho XML. Uma vez definido, o nome de referência não pode ser alterado.

Para obter uma descrição de cada atributo de campo e como listá-los, consulte Atributos de campo e Listar atributos de campo mais adiante neste artigo. Para obter uma visão geral de WITs e itens de trabalho, consulte Acompanhar o trabalho com histórias de usuários, problemas, bugs, recursos e épicos.

O que é um campo? Como são utilizados os nomes dos campos?

Cada tipo de item de trabalho está associado a 31 campos do sistema e vários outros campos específicos do tipo. Você usa itens de trabalho para planejar e acompanhar seu projeto.

Cada campo suporta o rastreamento de uma informação sobre o trabalho a ser executado. Os valores atribuídos a um campo são armazenados no armazenamento de dados de acompanhamento de trabalho, que pode ser criado consultas para determinar o status e as tendências.

Para obter descrições e uso de cada campo definido para os processos principais do sistema, Agile, Basic, Scrum e CMMI, consulte Índice de campo de item de trabalho.

Nomes de campo

Um nome de campo de item de trabalho identifica exclusivamente cada campo de item de trabalho. Certifique-se de que os nomes dos campos se enquadram nestas diretrizes:

• Os nomes de campo devem ser exclusivos dentro da coleção de contas/projetos
• Os nomes de campo devem ter 128 ou menos caracteres Unicode
• Os nomes de campo não podem conter espaços à esquerda ou à direita, nem dois ou mais espaços consecutivos
• Os nomes dos campos devem conter pelo menos um caractere alfabético
• Os nomes de campo não podem conter os seguintes caracteres: .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Como os campos personalizados são definidos para uma organização ou coleção, não é possível adicionar um campo personalizado a um processo com o mesmo nome de campo que você adiciona a outro processo.

Para obter mais informações, consulte Restrições e convenções de nomenclatura.

Sistema e campos predefinidos

Todos os campos definidos pelo sistema têm nomes de referência que começam com System, por exemplo, System.AreaPath, System.AssignedTo, e continuam nesse padrão.

Os campos predefinidos definidos pelo processo padrão começam com Microsoft.VSTS e, em seguida, diferem ainda mais com base em seu uso. Exemplos de campos predefinidos que são usados em comum, para fins de agendamento e integração com o Office Project, para integração com Team Foundation Build e integração com gerenciamento de casos de teste (TCM) são os seguintes:

• Microsoft.VSTS.Common.Priority
• Microsoft.VSTS.Scheduling.DueDate
• Microsoft.VSTS.Build.FoundIn
• Microsoft.VSTS.TCM.Passos

Para obter uma visão geral de todos os campos predefinidos e do sistema definidos para os processos/modelos de processo padrão, consulte Índice de campo de item de trabalho. Para obter mais informações sobre como especificar nomes de campos, consulte Restrições de nomenclatura.

Campos personalizados

Como os campos personalizados são definidos para uma organização ou coleção de projetos, não é possível adicionar um campo personalizado a um processo com o mesmo nome de campo que você adiciona a outro processo.

Ao adicionar campos personalizados, observe os seguintes limites:

• Um máximo de 64 campos pode ser definido para cada WIT
• É possível definir um máximo de 512 campos por processo

O tipo de dados de campo determina o tipo e o tamanho dos dados que você pode armazenar no campo. Um campo pode ter apenas um tipo definido dentro de uma coleção de projetos. Essa restrição incentiva as organizações a usar campos comuns entre projetos e tipos de item de trabalho.

Como posso determinar o tipo de dados do campo?

Explorador de Campo de Item de Trabalho

Você pode procurar as atribuições de atributos de campo usando a ferramenta Explorador de Campo de Item de Trabalho.

Para acessar o Gerenciador de Campo de Item de Trabalho, você deve instalar a Ferramenta Editor de Processos. Com base na versão do Visual Studio que você instalou, obtenha a ferramenta Editor de processos de uma das seguintes extensões.

• Visual Studio 2019 & 2022: A partir de agora, não há nenhuma extensão específica do Editor de Modelo de Processo disponível. Mas, você ainda pode personalizar modelos de processo usando outras ferramentas, como qualquer editor de texto ou editor XML. Você também pode usar o portal da Web do Azure DevOps para determinadas personalizações, especialmente para processos herdados.
• Visual Studio 2017: Editor de modelo de processo do TFS. Você também pode usar esta versão do Editor de processos para modificar os formulários de item de trabalho antigos. Não é possível usá-lo para editar formulários associados aos novos formulários da Web.
• Visual Studio 2015: Ferramentas Elétricas do TFS.

Atributos do campo

Há muitos atributos ocultos e inalteráveis para cada campo de item de trabalho. A tabela seguinte descreve cada atributo. Os atributos têm nomes diferentes com base em se você obtê-los através da API Fields - GetREST ou exibir através da ferramenta Work Item Field Explorer (WIFE).

Os atributos atribuídos a um campo dependem da plataforma e da versão que você usa. Por exemplo, alguns atributos não são suportados com o processo de herança. Para procurar o nome de referência de um campo, consulte Índice de campo de item de trabalho.

Listar atributos de campo

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

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

{
"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"
}

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

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

{
"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"
}

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

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  

Adicionar e modificar campos

Artigos relacionados