Adicionar e gerenciar campos (processo de herança)

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Você pode personalizar seu sistema de acompanhamento de trabalho adicionando campos personalizados ou modificando atributos específicos de um campo herdado. Por exemplo, você pode adicionar um campo personalizado para capturar outros dados ou alterar o rótulo exibido no formulário do item de trabalho para um campo herdado.

Para exibir todos os campos definidos para sua organização, incluindo o sistema e os campos herdados, consulte Exibir campos e atributos de item de trabalho.

Depois de adicionar um campo personalizado, você pode usá-lo para criar consultas, gráficos ou exibições do Analytics e relatórios do Power BI para rastrear e analisar dados relacionados.

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.

Categoria	Requisitos
Permissões	– Para criar, excluir ou editar um processo: membro do grupo Administradores de Coleção de Projetos ou permissões específicas no nível da coleção Criar processo, Excluir processo, Editar processo, ou Excluir um campo da organização definido como Permitir. Para obter mais informações, consulte a seção sobre a definição de permissões e acesso para acompanhamento de trabalho, e como personalizar um processo herdado. – Para atualizar os painéis: Administrador da equipe ou um membro do grupo de Administradores do projeto.
Acesso	- Mesmo que você tenha básico ou acesso inferior, você ainda poderá alterar um processo se alguém lhe der permissões para fazer isso. - Para atualizar e alterar os tipos de itens de seus trabalhos existentes: Membro do projeto.
Modelo de processo do projeto	- É preciso ter o Modelo de processo de herança para a coleção de projetos que contém o projeto. - Se estiver migrando dados para o Azure DevOps Services, use o serviço de importação de banco de dados do Team Foundation Server.
Conhecimento	Familiaridade com os modelos de personalização e processos.

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.

   

3. Selecione Processar.

   

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, o Azure DevOps atribui a ele um nome de referência prefixado com Personalizado e remove todos os espaços do nome do campo. Por exemplo, um campo chamado "Triagem de DevOps" recebe o nome de referência Custom.DevOpsTriage. Espaços não são permitidos em nomes de referência.

Adicionar um campo personalizado

Você pode adicionar campos e especificar o grupo e a página onde eles devem aparecer. Depois de adicionar um campo, você pode arrastá-lo e solte-o em uma página para ajustar seu posicionamento no formulário. Se você planeja adicionar vários campos a uma página ou grupo personalizado, crie essas páginas ou grupos primeiro antes de adicionar os campos.

Cada processo pode definir até 1.024 campos, incluindo sistemas e campos herdados. Os campos só podem ser adicionados em uma página em um formulário. Você não pode adicionar campos à área cinza do formulário em que os campos Atribuídos a, Estado e Motivo estão localizados.

1. Na página Processo do processo herdado selecionado, selecione o tipo de item de trabalho (WIT) em que você deseja adicionar o campo personalizado.

   No exemplo a seguir, selecionamos o Bug WIT. Observe os links de navegação que permitem que você volte para Todos os Processos e para a página de processo MyAgile.

   

   Se o campo Novo e outras opções estiverem desabilitados, você não terá as permissões necessárias para editar o processo.

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

   

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

   Os nomes de campo devem ser exclusivos dentro da organização. Um campo personalizado em um processo não pode compartilhar o mesmo nome que um campo em outro processo. Para obter mais informações, consulte o que é um campo? Como os nomes de campo são usados?

   No exemplo a seguir, adicionamos um tipo de campo Inteiro rotulado tíquete de cliente.

   

4. (Opcional) Na guia Opções , indique se o campo é necessário e especifique um valor padrão. Se deixado em branco, o campo permanecerá opcional. Quando você faz um campo Obrigatório, os usuários devem especificar um valor para salvar o item de trabalho. O valor padrão é definido quando um item de trabalho é criado ou aberto e o campo está vazio.

   

5. (Opcional) Na guia Layout , você pode especificar um rótulo de formulário diferente do nome do campo. Você também pode escolher a página e o grupo em que o campo aparece no formulário.

   No exemplo a seguir, adicionamos o campo Tíquete de Cliente a um novo grupo intitulado Foco do Cliente.

   

   Observação

   Embora você possa alterar o rótulo do formulário, 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 Adicionar campo para concluir o processo. Se você não especificar um local de layout, o sistema adicionará o campo ao primeiro grupo de campos no formulário.

7. Após a conclusão das alterações, abra um item de trabalho do tipo personalizado para examinar as atualizações.

   O exemplo a seguir mostra que o campo Tíquete de Cliente foi adicionado com êxito ao grupo Status. Se as alterações não estiverem imediatamente visíveis, atualize o navegador para garantir que as atualizações sejam exibidas corretamente. Esta etapa garante que o novo campo esteja devidamente integrado ao formulário do item de trabalho e pronto para uso.

   

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.

Cada organização ou coleção pode definir até 2.048 listas de seleção. Cada lista de seleção pode conter até 2.048 itens. Os itens da lista de opções devem ter 256 caracteres ou menos. Para adicionar listas de seleção dependentes, consulte listas em cascata.

1. Selecione Novo campo, especifique o tipo de lista de seleção — inteiro ou cadeia de caracteres — e adicione os itens a serem exibidos na lista de seleção. Você pode adicionar um item e, em seguida, selecionar Enter para adicionar outro item.

   

   Para excluir um item na lista, realce o item e, em seguida, selecione o ícone de 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.

   

2. (Opcional) Especifique os valores obrigatórios ou padrão e escolha onde o campo aparece no formulário.

   

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.

Selecione Novo campo, em seguida, o nome do campo, tipo de identidade e, opcionalmente, uma descrição.

(Opcional) Especifique os valores obrigatórios ou padrão e escolha onde o campo aparece no formulário.

Adicionar um campo HTML de rich text

1. Selecione a WIT à qual você deseja adicionar o campo e escolha o 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.

   

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

   A captura de tela mostra o formulário de Bug com o campo de solicitação do cliente adicionado à primeira coluna do formulário.

4. (Opcional) Especifique os valores obrigatórios ou padrão e escolha onde o campo aparece no formulário.

Adicionar um campo de caixa de seleção

1. Selecione a WIT à qual você deseja adicionar o campo e, em seguida, escolha 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.

   

3. (Opcional) Selecione Opções e especifique se o campo é necessário.

   

4. Por padrão, o campo é adicionado ao último grupo definido na segunda coluna. Selecione Layout e arraste e solte o campo para outro grupo no formulário.

   Observação

   O campo aparece como uma caixa de seleção no formulário de item de trabalho. Selecionar a caixa de seleção indica um valor True . Se o campo for exibido no quadro ou quadro de tarefas, os valores True e False serão exibidos como texto em vez de 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 WITs pelo menu do 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.

No exemplo a seguir, adicionamos o campo Tíquete de Cliente ao WIT da User Story.

(Opcional) Especifique os valores obrigatórios ou padrão e escolha onde o campo aparece no formulário.

Rotular novamente um campo

Não há suporte para renomear um campo ou alterar seu tipo. No entanto, você pode alterar o rótulo exibido no formulário do item de trabalho da guia Layout . Ao criar consultas, use o nome do campo, não o rótulo.

No exemplo a seguir, renomeamos o campo Tíquete do Cliente para Número do Tíquete.

Modificar o texto de ajuda da descrição

O texto da ajuda de descrição aparece quando os usuários focalizam um campo no formulário do item de trabalho. Você pode personalizar o texto de ajuda para campos personalizados e herdados, mas o comportamento é diferente por tipo de campo:

• Campos herdados: o texto da ajuda pode ser personalizado para cada tipo de item de trabalho e processo.
• Campos personalizados: o texto da ajuda é consistente em todos os tipos e processos 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.

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 mais tarde, poderá exibi-lo novamente. Essas ações diferem da opção Excluir, que remove 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 retirado do histórico. Você pode exibi-lo nos resultados da consulta. Se você adicionar o campo de volta ao formulário, o histórico será restaurado. Para excluir um campo personalizado de uma coleção de projetos, consulte Excluir um campo.

Ocultar um campo ou controle personalizado

1. Abra o menu de contexto do campo ou controle e 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.

   

2. Confirme que deseja remover o campo.

   

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.

Excluir um campo personalizado

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

Excluir um campo remove todos os dados associados, incluindo valores históricos. Pode haver um pequeno atraso antes do início dos trabalhos de limpeza de dados. Durante esse tempo, você pode tentar restaurar o campo e recuperar seus dados usando a API REST de Atualização de Campos. A recuperação pode ser completa, parcial ou malsucedida, dependendo dos dados restantes. Tenha cuidado ao excluir campos, pois a recuperação nem sempre é possível ou concluída.

Observação

Esta ação NÃO PODE ser desfeita. Exclua apenas os campos que não estão em uso. Use o comando witadmin listfields para identificar campos não utilizados. Para obter mais informações, confira Gerenciar campos de item de trabalho (witadmin).
Se o Analytics estiver habilitado para sua organização ou coleção, você poderá consultar o Analytics para localizar 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

Para excluir um campo personalizado, execute as seguintes etapas:

1. Selecione Configurações da organização>Processo>Campos>Mais ações>Excluir.

   

   Seja membro do grupo Administradores de Coleção de Projetos ou tenha concedido permissões explícitas para excluir campos.

2. Insira o nome do campo, conforme mostrado no exemplo a seguir, e confirme selecionando Excluir campo de item de trabalho.

   

Artigos relacionados

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.

• Exibir campos e atributos de item de trabalho
• Adicionar ou modificar um tipo de item de trabalho personalizado
• Personalizar o layout da Web
• Acompanhamento de trabalho, processo e limites de projeto