Adicionar e gerenciar campos (processo de herança)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Você pode adicionar um campo personalizado para dar suporte ao controle de requisitos de dados adicionais ou modificar atributos selecionados de um 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
Este artigo se aplica a Azure DevOps Services e Azure DevOps Server 2019 e versões posteriores. Para personalizar qualquer projeto definido em uma coleção do TFS 2018 ou anterior, consulte Modelo de processo XML local.
Importante
Você só pode usar o modelo de processo de herança para projetos definidos em uma coleção de projetos configurada para dar suporte ao modelo de processo de herança. 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 saber mais, confira Personalizar o acompanhamento de trabalho, Escolha o modelo de processo para sua coleção de projetos.
Para personalizar qualquer projeto definido em uma coleção do TFS 2018 ou anterior, consulte Modelo de processo XML local.
Para obter uma lista de todos os campos definidos para sua organização, que inclui todos os campos definidos para o sistema e processos herdados, 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 Google Analytics e relatórios do Power BI para controlar dados relacionados a ele.
Pré-requisitos
Antes de personalizar um processo, recomendamos que você examine Configurar e personalizar Azure Boards, que fornece diretrizes sobre como personalizar Azure Boards para atender às suas necessidades de negócios. Para obter uma descrição das diferentes listas de pendências e quadros, consulte Tarefas compatíveis com Listas de Pendências, Quadros, Quadros de Tarefas e Planos.
- Você deve ter uma organização criada no Azure DevOps Services. Se você ainda não criou um, faça isso agora.
- Para criar, editar e gerenciar processos, você deve ser membro do grupo Administradores de Coleção de Projetos ou ter as permissões de nível de coleção correspondentes Criar processo, Excluir processo, Editar processo ou Excluir um campo da organização definido como Permitir. Confira Definir permissões e acesso para acompanhamento de trabalho, Personalizar um processo herdado.
- Você deve ter selecionado o modelo de processo de herança para a coleção de projetos em que o projeto é criado. Para saber mais, confira Escolher o modelo de processo para sua coleção de projetos.
- Para criar, editar e gerenciar processos, você deve ser membro do grupo Administradores de Coleção de Projetos ou ter as permissões correspondentes Criar processo, Excluir processo, Editar processo ou Excluir um campo da organização definido como Permitir. Confira Definir permissões e acesso para acompanhamento de trabalho, Personalizar um processo herdado.
Abrir Processo de Configurações>
Você cria, gerencia e faz personalizações para processos do Processo de configurações>da organização.
Escolha o logotipo do Azure DevOps para abrir o Projects. Em seguida, escolha Configurações da organização.
Em seguida, escolha Processar.
Importante
Se você não vir Process, está trabalhando no TFS-2018 ou na versão anterior. Não há suporte para a página Processo . Você deve usar os recursos com suporte para o modelo de processo XML local.
Você cria, gerencia e faz personalizações para processos do Processo de Configurações>de Coleção.
Escolha o logotipo do Azure DevOps para abrir o Projects. Escolha a coleção de projetos cujos processos você deseja personalizar e escolha Configurações de Coleção.
Em seguida, escolha Processar.
Você cria, gerencia e faz personalizações para processos de Administração configurações>Process.
Escolha o logotipo do Azure DevOps para abrir o Projects. Em seguida, escolha Administração configurações.
Em seguida, escolha Processar.
Observação
À medida que você personaliza um processo herdado, todos os projetos que usam esse processo são atualizados automaticamente para refletir as personalizações. Por esse motivo, recomendamos que você crie um processo de teste e um projeto de teste quando tiver várias personalizações a serem feitas para testar as personalizações antes de implementá-las em sua organização. Para saber mais, consulte Criar e gerenciar processos herdados.
Nomes de campos personalizados
Quando você adiciona um campo personalizado a um processo herdado, o Azure DevOps atribui um nome de referência prefixado com Personalizado 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 dentro de 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. Não é possível adicionar um campo à área cinza dentro do formulário onde os campos Atribuído a, Estado e Motivo estão localizados.
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 Todos os processos e MyAgile .
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.
Com o WIT selecionado, escolha o campo Novo.
Nomeie o campo e selecione o tipo de campo de um dos tipos de dados com suporte. 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 campos, consulte O que é um campo? Como os nomes de campo são usados?
Aqui, adicionamos um campo Inteiro rotulado Ticket do cliente.
(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 toda vez que alguém abre um item de trabalho e o campo está vazio, o valor padrão é definido.
(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 Ticket do cliente a um novo grupo denominado Foco do cliente.
Observação
Embora seja possível alterar o rótulo do formulário, você deve usar o nome do campo quando estiver adicionando campos a cartões (Kanban, Quadro de Tarefas) ou criando consultas com base no campo.
Escolha Adicionar campo para concluir a adição do campo . Se você não especificar seu local de layout, o sistema o adicionará ao primeiro grupo de campos no formulário.
Quando terminar de fazer todas as alterações, abra um item de trabalho do tipo que você personalizou.
Aqui, mostramos que o campo Ticket do Cliente foi adicionado ao grupo Status. Talvez seja necessário atualizar o navegador para ver as alterações.
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.
Comece escolhendo 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.
Para excluir um item na lista, realce o item e clique no ícone de exclusão.
Para modificar a lista de seleção de um campo herdado, escolha Editar para editar o campo. Na guia Definição, você pode optar por Adicionar valor.
(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.
(Opcional) Consulte a etapa 5 anterior para especificar onde você 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 agem 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 campos baseados em identidade com os nomes definidos nesses diretórios.
Comece escolhendo Novo campo, depois o nome do campo, Tipo de identidade e, opcionalmente, uma descrição.
(Opcional) Consulte a etapa 5 anterior para especificar onde você deseja que o campo apareça no formulário (guia Layout).
Adicionar um campo HTML rich text
Como antes, escolha o WIT ao qual você deseja adicionar o campo e, em seguida, escolha o campo Novo.
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.
O campo é adicionado à primeira coluna em todos os campos rich text definidos pelo sistema, mas antes do controle Discussion.
Adicionar um campo de caixa de seleção
Como antes, escolha o WIT ao qual você deseja adicionar o campo e, em seguida, escolha Novo campo.
Escolha Boolean como o tipo e dê a ele um rótulo. Aqui rotulamos o campo como Triaged para rastrear o estado de triagem do bug.
(Opcional) Abra a guia Opções e especifique se o campo deve ser obrigatório.
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 Kanban 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ê poderá adicioná-lo a outros no 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 procurar descrições de qualquer campo de item de trabalho definido pelo sistema, consulte o Índice do campo Item de trabalho.
Aqui, adicionamos o campo Ticket do Cliente ao WIT da História do Usuário.
Opcionalmente, especifique os valores Obrigatório/Padrão e o posicionamento no formulário do campo.
Rerotular um campo
Renomear um campo ou alterar o tipo de campo não são ações com suporte. 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 Bilhete.
Modificar 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 texto de ajuda diferente para os mesmos campos para diferentes tipos de item de trabalho. Há suporte para modificação 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 o mesmo para o campo em todos os tipos de item de trabalho e em todos os processos.
Observação
Determinados recursos exigem a instalação da atualização do Azure DevOps Server 2020.1. Para obter mais informações, consulte Azure DevOps Server 2020 Update 1 RC1 Release Notes, Boards.
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. Isso ajuda o texto a se propagar para todos os tipos de item de trabalho e todos os processos. Não é possível 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 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 Pontos de História para História de Usuário.
Aqui modificamos o campo Publicado personalizado para User Story.
Mostrar, ocultar ou remover um campo
Você pode optar por mostrar ou ocultar a exibição de qualquer campo ou controle personalizado 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 a exibição de um campo herdado ou de um controle personalizado em um formulário. Para campos personalizados, você pode removê-lo do formulário. Se você quiser recolocá-lo escolhendo 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ê o 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 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 a partir dos 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
Abra o menu de contexto do campo ou controle e escolha Ocultar do layout.
Para adicionar um campo ou controle oculto ao formulário, escolha Mostrar no layout.
Remover um campo personalizado de um formulário
Escolha Remover no menu de contexto do campo que você deseja remover.
Confirme que você deseja remover o campo.
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 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 Fields - Update.
Observação
Recomendamos que você exclua apenas os campos que não estão em uso. Você pode determinar campos que não estão em uso exercitando o comando witadmin listfields . Para saber como, consulte Gerenciar campos de item de trabalho (witadmin).
Ou, se o Google Analytics estiver habilitado para sua organização ou coleção, você poderá consultar o Google 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
Excluir o campo da página Todos os processos>Campos .
Para excluir campos, você deve ser membro do grupo Administradores da Coleção de Projetos ou receber permissões explícitas para o campo Excluir da conta.
Para concluir a operação de exclusão, você deve digitar o nome do campo conforme mostrado.
Artigos relacionados
Observação
Você pode examinar as alterações feitas em um processo herdado por meio do log de auditoria. Para saber mais, confira 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
- Personalizar um projeto usando um processo herdado
- Personalizar cartões em quadros
- Mostrar bugs em listas de pendências e quadros
- Acompanhamento de trabalho, processo e limites de projeto
Se você estiver trabalhando com planos de teste ou casos de teste, consulte estes artigos:
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de