Adicionar e gerenciar tipos de item de trabalho

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

Você pode adicionar tipos de item de trabalho personalizados (WITs) ou modificar WITs existentes para adicionar campos, remover ou ocultar campos, adicionar regras personalizadas e muito mais. Por exemplo, talvez você queira capturar problemas do cliente em um WIT de ticket personalizado.

Custom Ticket work item form

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.

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.

Abrir Processo de Configurações>

Você cria, gerencia e faz personalizações para processos do Processo de configurações>da organização.

  1. Escolha o logotipo do Azure DevOps para abrir o Projects. Em seguida, escolha Configurações da organização.

    Open Projects>Organization settings.

  2. Em seguida, escolha Processar.

    Then, choose Process.

    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.

  1. 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.

    Open Projects>Organization settings

  2. Em seguida, escolha Processar.

    Then, choose Process.

Você cria, gerencia e faz personalizações para processos de Administração configurações>Process.

  1. Escolha o logotipo do Azure DevOps para abrir o Projects. Em seguida, escolha Administração configurações.

    Open Project>Organization settings.

  2. Em seguida, escolha Processar.

    Then, choose Process.

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.

Adicionar um tipo de item de trabalho

  1. Na página Tipos de Item de Trabalho, escolha Novo tipo de item de trabalho.

    Process, Inherited process, Work Item Types, Add new work item type

  2. Nomeie o WIT e, opcionalmente, especifique uma descrição, ícone e cor. O ícone e a cor especificados aparecem em todo o portal da Web, inclusive no formulário de item de trabalho e quando itens de trabalho associados aparecem em uma lista de pendências, quadros, resultados de consulta e muito mais. Escolha Criar para salvar.

    Create new work item type dialog
  3. Na página Layout, você pode adicionar campos, grupos ou páginas para especificar o formulário e os campos que deseja acompanhar. Cada novo WIT vem predefinido com uma página Detalhes com o campo Descrição e grupos de Discussão, Desenvolvimento e Trabalho Relacionado. Para obter detalhes, consulte Adicionar e gerenciar campos ou Personalizar o layout da Web para um processo.

    New WIT, customize layout

    Também são adicionados, mas não mostrados nem editáveis na página Layout, os elementos padrão incluídos no cabeçalho do formulário, conforme mostrado na imagem a seguir, bem como o histórico, os links e as páginas de anexos.

    WIT header details

  4. Abra a página Estados para exibir os estados padrão do fluxo de trabalho. Opcionalmente, personalize os estados do fluxo de trabalho.

  5. Opcional. Para adicionar o WIT a uma lista de pendências, consulte Personalizar suas listas de pendências ou quadros para um processo. Por padrão, WITs personalizados não são adicionados a nenhuma lista de pendências. Para saber mais sobre diferentes níveis de lista de pendências, consulte Listas de pendências, quadros e planos.

  6. Verifique se o tipo de item de trabalho personalizado aparece conforme o esperado. Abra a página Itens> de Trabalho (contexto do usuário) e escolha Novo Item de Trabalho e selecione o WIT que você personalizou. Aqui escolhemos Ticket.

    Work>Work Items page, add new work item, Ticket

    Se você não vir o WIT personalizado, atualize seu navegador para garantir que ele registre todas as alterações personalizadas que você fez.

  7. Verifique se o campo adicionado aparece no formulário. Observe que o ícone (ponto de exclamação) indica que o campo é obrigatório.

    Ticket form, Customer Ticket field added to Customer Focus group

Alterar descrição, ícone ou cor

Para alterar a descrição, o ícone ou a cor de um WIT personalizado, escolha Editar no menu de contexto do WIT.

Aqui mudamos a descrição, o ícone e a cor do WIT personalizado do Ticket.

Overview page, edit custom ticket description, icon and color

Habilitar ou desabilitar um WIT

Você pode desabilitar um WIT personalizado, que impede que os usuários possam adicionar itens de trabalho usando-o. No entanto, todos os itens de trabalho existentes definidos usando o WIT personalizado permanecem disponíveis. Você pode consultá-los e editá-los.

Talvez você queira desabilitar um WIT personalizado até ter definido todos os campos, fluxo de trabalho e layout planejados.

Para desabilitar um WIT personalizado, escolha Desativar no menu de contexto do WIT.

Para reativar o WIT, escolha Ativar no menu de contexto do WIT.

Observação

Desabilitar um WIT remove o WIT da lista suspensa Novo e adiciona experiências. A criação de um item de trabalho desse WIT também é bloqueada por meio de APIs REST.

Nenhuma alteração é feita em itens de trabalho existentes desse tipo. Você pode atualizá-los ou excluí-los e eles continuam a aparecer em listas de pendências e quadros. Além disso, você pode alterar o tipo de item de trabalho de WITs desabilitados para um tipo habilitado, mas não pode alterar o tipo para um WIT desabilitado.

Excluir ou destruir um WIT personalizado

Importante

A destruição de um WIT exclui todos os itens de trabalho e dados associados a esse WIT, incluindo valores históricos. Uma vez destruído, você não pode recuperar os dados.

  1. Para remover completamente um WIT personalizado e todos os itens de trabalho baseados nesse WIT, escolha Destruir no menu de contexto do WIT.

    Para destruir um WIT, você deve ser membro do grupo Administradores da Coleção de Projetos ou receber permissões explícitas para editar um processo específico.

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

    Delete field, confirmation dialog

Extensibilidade WIT

Para trabalhar com WITs programaticamente, consulte API REST de tipos de item de trabalho.

Perguntas e respostas

P: Como faço para que meu tipo de item de trabalho personalizado apareça na minha lista de pendências?

R: Modifique sua lista de pendências de requisitos para incluir o tipo de item de trabalho personalizado. Para obter detalhes, consulte Personalizar suas listas de pendências ou quadros, Editar ou renomear a lista de pendências de requisitos.

Observação

O nível de lista de pendências ao qual você adiciona um tipo de item de trabalho personalizado determina o(s) tipo(s) de item de trabalho pai para o tipo de item de trabalho.

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.