Adicionar e gerenciar campos (processo de herança)

  • Artigo

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

Você pode adicionar um campo personalizado para dar suporte ao rastreamento de requisitos de dados adicionais ou modificar atributos selecionados de um Ícone herdado campo herdado. Por exemplo, você pode adicionar um campo personalizado ou alterar o rótulo que aparece no formulário de item de trabalho para um campo herdado.

Importante

O modelo de processo de herança está disponível para projetos configurados para dar suporte a ele. Se você estiver usando uma coleção mais antiga, verifique a compatibilidade do modelo de processo. Se sua coleção local estiver configurada para usar o modelo de processo XML local, você só poderá usar esse modelo de processo para personalizar a experiência de acompanhamento de trabalho. Para obter mais informações, consulte Escolher o modelo de processo para sua coleção de projetos.

Para obter uma lista de todos os campos definidos para sua organização, que inclui todos os campos definidos para processos herdados e do sistema, consulte Exibir campos e atributos de item de trabalho.

Depois de adicionar um campo personalizado, você pode criar consultas, gráficos ou exibições do Analytics e relatórios do Power BI para acompanhar os dados relacionados a ele.

Pré-requisitos

Para obter diretrizes sobre como adaptar Azure Boards para se alinhar aos seus requisitos de negócios específicos, consulte Sobre como configurar e personalizar Azure Boards.

  • Requisito da organização: verifique se você tem uma organização no Azure DevOps.

  • Permissões:

    • Ser membro do grupo Administradores de Coleção de Projetos.
    • Ter permissões no nível da coleção, como Criar processo, Excluir processo, Editar processo ou Excluir um campo da organização definidas como Permitir.
    • Essas permissões permitem que você modifique processos e campos dentro de sua organização.

  • Requisito do modelo de processo do projeto:

    • Verifique se você tem o modelo de processo de herança para a coleção de projetos em que o projeto é criado.

  • Permissões:

    • Ser membro do grupo Administradores de Coleção de Projetos.
    • Ter permissões no nível da coleção, como Criar processo, Excluir processo, Editar processo ou Excluir um campo da organização definidas como Permitir.
    • Essas permissões permitem que você modifique processos e campos dentro de sua organização.

Abrir as configurações do processo da organização

  1. Entre em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione Configurações da organização.

    Captura de tela mostrando o botão Configurações da organização para seleção.

  3. Selecione Processar.

    Captura de tela mostrando o botão Processo realçado para seleção.

  1. Entre na sua coleção (https://dev.azure.com/{Your_Collection}).

  2. Selecione Configurações de coleção ou Configurações de administrador.

  3. Selecione Processar.

    Captura de tela mostrando o botão Processo realçado nas configurações da Coleção.

Observação

Quando você personaliza um processo herdado, todos os projetos que usam esse processo refletem automaticamente as personalizações. Para garantir uma transição tranquila, recomendamos criar um processo de teste e um projeto, que permite testar suas personalizações antes de implementá-las em toda a organização. Para obter mais informações, consulte Criar e gerenciar processos herdados.

Nomes de campos personalizados

Quando você adiciona um campo personalizado a um processo herdado, Azure DevOps atribui um nome de referência prefixado com Custom e, em seguida, o nome do campo com espaços removidos. Por exemplo, você adiciona um campo chamado Triagem de DevOps, o nome de referência é Custom.TriagemdeDevOps. Espaços não são permitidos no nome de referência.

Adicionar um campo personalizado

Você pode adicionar campos e especificar o grupo e a página onde eles devem aparecer. Além disso, depois de adicionar um campo, você pode arrastá-lo e soltá-lo em uma página para mover seu posicionamento dentro do formulário. Se você tiver vários campos que deseja adicionar a uma página ou grupo personalizado, adicione essas páginas ou grupos primeiro e, em seguida, adicione seus campos.

Observação

Cada processo pode definir até 1024 campos, incluindo campos herdados do sistema. Você só pode adicionar campos dentro de uma página em um formulário. Você não pode adicionar um campo à área cinza dentro do formulário onde os campos Atribuído a, Estado e Motivo estão localizados.

  1. Na página Processo do processo herdado selecionado, escolha o tipo de item de trabalho ao qual você deseja adicionar o campo personalizado.

    Aqui escolhemos o Bug WIT. Observe os links de trilha que permitem que você volte para a página de processos All Processes e MyAgile .

    Todos os links de trilha Processos-Processo-WIT

    Se o campo Novo e outras opções estiverem desabilitados, você não terá as permissões necessárias para editar o processo. Confira Definir permissões e acesso para acompanhamento de trabalho, Personalizar um processo herdado.

  2. Com o WIT selecionado, escolha o campo Novo.

    Processar Tipos de Item de Trabalho, Adicionar um campo a um WIT

  3. Nomeie o campo e selecione o tipo de campo de um dos tipos de dados suportados. Como opção, adicione uma descrição.

    Observação

    Você deve especificar um nome de campo que seja exclusivo dentro da organização. Um campo personalizado definido para um processo não pode ser o mesmo que o nome definido para outro processo. Para obter mais informações sobre nomes de campo, consulte O que é um campo? Como os nomes dos campos são usados?

    Aqui, adicionamos um campo Inteiro denominado Tíquete do cliente.

    Adicionar um campo ao Bug, escolha o tipo de campo

  4. (Opcional) Na guia Opções , indique se o campo é obrigatório e especifique um valor padrão. Ou deixe os valores em branco. Ao tornar um campo Obrigatório, os usuários devem especificar um valor para o campo para salvar o item de trabalho. Quando você cria um item de trabalho, bem como sempre que alguém abre um item de trabalho e o campo está vazio, o valor padrão é definido.

    Adicione um campo a Usar história, especifique opções

  5. (Opcional) Na guia Layout , você pode inserir um rótulo de formulário diferente do nome do campo. Além disso, você pode escolher a página e o grupo onde o campo aparece no formulário.

    Aqui, adicionamos o campo Tíquete do cliente a um novo grupo denominado Foco no cliente.

    Adicione um campo para Usar história, especifique o layout

    Observação

    Embora seja possível alterar o rótulo do formulário, você deve usar o nome do campo ao adicionar campos a cartões (Quadro, Quadro de Tarefas) ou criar consultas com base no campo.

  6. Escolha Add field (Adicionar campo ) para concluir a adição do campo. Se você não especificar o local do layout, o sistema o adicionará ao primeiro grupo de campos do formulário.

  7. Quando você tiver concluído todas as alterações, abra um item de trabalho do tipo que você personalizou.

    Aqui, mostramos que o campo Tíquete do Cliente foi adicionado ao grupo Status. Pode ser necessário atualizar o navegador para ver as alterações.

    Formulário de bug, campo Tíquete do cliente adicionado ao grupo de foco do cliente

Adicionar uma lista de opções

Acompanhamento de trabalho, processo e limites de projeto

Você pode adicionar um novo campo e definir uma lista de seleção ou personalizar a lista de seleção de um campo herdado.

Observação

Cada organização ou coleção pode definir até 2048 listas de opções. Cada lista de opções pode conter até 2048 itens. Os itens da lista de opções devem ter 256 caracteres ou menos. Se você quiser adicionar listas de opções dependentes, consulte Listas em cascata.

  1. Comece escolhendo Adicionar novo ícone de campo Novo campo, especifique o tipo de lista de opções — inteiro ou cadeia de caracteres — e adicione os itens a serem exibidos na lista de opções. Você pode adicionar um item e pressionar Enter para adicionar outro item.

    Adicionar um campo à caixa de diálogo Bug, Adicionar uma lista de opções personalizada.

    Para excluir um item da lista, realce o item e clique no ícone de ícone Excluir exclusão.

    Para modificar a lista de seleção de um campo herdado, escolha Edit (Editar ) para editar o campo. Na guia Definição , você pode optar por Adicionar valor.

    Edite o campo Prioridade na caixa de diálogo Padrão do usuário, guia Definição.

  2. (Opcional) Escolha a guia Opções para definir o campo conforme necessário, especificar um padrão ou permitir que os usuários insiram seus próprios valores.

    Permitir valores em uma lista de opções personalizada

  3. (Opcional) Consulte a etapa 5 anterior para especificar onde deseja que o campo apareça no formulário (guia Layout).

Adicionar um campo Identidade

Use um campo baseado em identidade para adicionar um campo semelhante ao campo Atribuído a. Os campos baseados em identidade atuam da mesma forma que o campo Atribuído a, fornecendo uma função de pesquisa e seletor de identidade. Quando sua organização gerencia usuários com o Microsoft Entra ID ou Active Directory, o sistema sincroniza os campos baseados em identidade com os nomes definidos nesses diretórios.

  1. Comece escolhendo Adicionar novo ícone de campo Novo campo, depois o nome do campo, Tipo de identidade e, opcionalmente, uma descrição.

    Adicione um campo à caixa de diálogo Bug, guia Definição, adicione um campo Identidade.

  2. (Opcional) Consulte a etapa 5 anterior para especificar onde deseja que o campo apareça no formulário (guia Layout).

Adicionar um campo HTML de rich text

  1. Como antes, escolha o WIT ao qual você deseja adicionar o campo e, em seguida, escolha o Adicionar novo ícone de campo campo Novo.

  2. Escolha Texto (várias linhas) como o tipo. Aqui, rotulamos o campo como Solicitação do cliente para capturar comentários do cliente para solicitações de recursos do produto.

    Processar Tipos de Item de Trabalho, Adicionar um campo rich text ao formulário Bug

  3. O campo é adicionado à primeira coluna em todos os campos de rich text definidos pelo sistema, mas antes do controle Discussão.

    Formulário de bug, campo de solicitação do cliente adicionado à primeira coluna do formulário

Adicionar um campo de caixa de seleção

  1. Como antes, escolha o WIT ao qual você deseja adicionar o campo e escolha adicionar ícone Novo campo.

  2. Escolha Booleano como o tipo e dê um rótulo a ele. Aqui, rotulamos o campo como Triagem para rastrear o estado de triagem do bug.

    Adicionar um campo booleano

  3. (Opcional) Abra a guia Opções e especifique se o campo deve ser obrigatório.

    Definir opções para campo booleano

  4. Por padrão, o campo é adicionado ao último grupo definido na segunda coluna. Abra a guia Layout para arrastar e soltar o campo em outro grupo no formulário.

    Observação

    O campo aparece como uma caixa de seleção no formulário de item de trabalho. Marque a caixa para indicar um valor True. Se você exibir o campo no quadro ou no Quadro de Tarefas, os valores de campo de Verdadeiro e Falso serão exibidos (não uma caixa de seleção).

Adicionar um campo existente a outro WIT

Os campos existentes correspondem a qualquer campo herdado e campo personalizado definido na coleção. Depois de adicionar um campo personalizado a um WIT, você pode adicioná-lo a outros no menu de formulário. Ou você pode adicionar um campo definido para um processo a um tipo de item de trabalho em outro processo. Abra o tipo de item de trabalho e escolha o campo existente.

Para pesquisar descrições de qualquer campo de item de trabalho definido pelo sistema, consulte o índice de campo de item de trabalho.

Aqui, adicionamos o campo Tíquete do Cliente ao WIT da História do Usuário.

Adicionar campo existente a uma história de usuário

Opcionalmente, especifique os valores Obrigatórios/Padrão e o posicionamento no formulário do campo.

Rotular novamente um campo

Renomear um campo ou alterar o tipo de campo não são ações suportadas. No entanto, na guia Layout , você pode alterar o rótulo que aparece no formulário de item de trabalho. Ao selecionar o campo em uma consulta, você precisa selecionar o nome do campo e não o rótulo do campo.

Aqui, renomeamos o campo Ticket do cliente para Número do ticket.

Guia Layout, Rotular novamente um campo

Modificar o texto de ajuda da descrição

O texto de ajuda da descrição é exibido quando os usuários passam o mouse sobre um campo no formulário de item de trabalho. Você pode definir um texto de ajuda diferente para os mesmos campos para diferentes tipos de item de trabalho. A modificação é suportada para campos personalizados e campos herdados. Observe que a implementação difere com base no tipo de campo.

  • Para campos herdados: o texto de ajuda da descrição pode ser definido de forma diferente para cada tipo de item de trabalho e processo.
  • Para campos personalizados: o texto de ajuda da descrição aparece da mesma forma para o campo em todos os tipos de item de trabalho e todos os processos.

Observação

Determinados recursos exigem a instalação da atualização Azure DevOps Server 2020.1. Para obter mais informações, consulte Notas de versão do Azure DevOps Server 2020 Atualização 1 RC1, Quadros.

O texto de ajuda da descrição é exibido quando os usuários passam o mouse sobre um campo no formulário de item de trabalho. Você só pode modificar o texto de ajuda da descrição em um campo personalizado. Esse texto de ajuda se propaga para todos os tipos de item de trabalho e todos os processos. Você não pode personalizar o texto de ajuda por processo ou tipo de item de trabalho.

Para modificar o texto de ajuda Descrição, escolha o tipo de item de trabalho que você deseja modificar, escolha Editar para o campo e escolha a guia Definição. O valor modificado afeta apenas esse campo no processo e para esse tipo de item de trabalho.

Aqui, modificamos o campo Story Points para User Story.

Caixa de diálogo Editar campo, História do usuário, campo Pontos da história.

Aqui, modificamos o campo Publicado personalizado para a História do usuário.

Caixa de diálogo Editar campo, História de usuário, Campo personalizado publicado.

Mostrar, ocultar ou remover um campo

Você pode optar por mostrar ou ocultar qualquer campo ou controle personalizado de aparecer em um formulário. Se você quiser restabelecer um campo no formulário posteriormente, poderá reexibir Essas ações diferem da opção Excluir , que exclui o campo da organização.

Você pode optar por mostrar ou ocultar um campo herdado ou um controle personalizado de aparecer em um formulário. Para campos personalizados, você pode removê-lo do formulário. Se você quiser restabelecê-lo, escolha Mostrar no layout. Essas ações diferem da opção Excluir , que exclui o campo da organização.

Observação

Os dados definidos para um campo herdado, mesmo que você os oculte, são mantidos no armazenamento de dados e no histórico do item de trabalho. Você pode exibir um registro dele exibindo a guia de histórico de um item de trabalho.

Quando você remove um campo personalizado do layout, ele é mantido no armazenamento de dados, mas removido do histórico. Você pode exibi-lo nos resultados da consulta. Se você adicionar o campo de volta ao formulário, o histórico dele será restaurado. Para excluir um campo personalizado de uma coleção de projetos, consulte Excluir um campo.

Ocultar um campo ou controle personalizado

Ocultar um campo herdado ou um controle personalizado

  1. Abra o menu de contexto do campo ou controle e escolha Ocultar do layout.

    Layout de bug, campo herdado, abrir menu de contexto, escolha Ocultar do layout

  2. Para adicionar um campo ou controle oculto ao formulário, escolha Mostrar no layout.

Remover um campo personalizado de um formulário

  1. Escolha Remover no menu de contexto do campo que você deseja remover.

    Remover campo do tipo de item de trabalho de bug

  2. Confirme que deseja remover o campo.

    Confirme para remover o campo do formulário de item de trabalho de bug

  3. Para adicionar um campo personalizado que foi removido, escolha Novo campo e selecione Usar um campo existente.

Reverter campo para padrões predefinidos

Você pode descartar as alterações feitas em um campo herdado. Na página Layout do tipo de item de trabalho modificado, escolha a opção Reverter para o campo.

Página Layout, menu de contexto Campo, escolha a opção Reverter

Excluir um campo personalizado

Com o modelo de processo de herança, você só pode excluir campos personalizados. Não é possível excluir campos definidos para processos padrão do sistema.

A exclusão de um campo exclui todos os dados associados a esse campo, incluindo valores históricos. Depois de excluído, você só pode restaurar o campo e recuperar os dados usando a API REST Campos - Atualizar.

Observação

É recomendável excluir apenas os campos que não estão em uso. Você pode determinar campos que não estão em uso exercendo o comando witadmin listfields . Para saber como, consulte Gerenciar campos de item de trabalho (witadmin).
Ou, se o Analytics estiver ativado para sua organização ou coleção, você poderá consultar o Analytics para saber onde um campo personalizado está em uso com a seguinte sintaxe:

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItemTypeFields?$filter=FieldReferenceName eq {CustomFieldReferenceName}&$select=WorkItemType

  1. Você exclui o campo da página Campos de todos os processos>.

    Excluir campo

    Para excluir campos, você deve ser membro do grupo Administradores de Coleção de Projetos ou receber permissões explícitas para Excluir campo da conta.

  2. Para concluir a operação de exclusão, você deve digitar o nome do campo conforme mostrado.

    Excluir campo, caixa de diálogo de confirmação

Observação

Revise as alterações feitas em um processo herdado por meio do log de auditoria. Para obter mais informações, consulte Acessar, exportar e filtrar logs de auditoria.

Se você estiver trabalhando com planos de teste ou casos de teste, consulte estes artigos: