Adicionar e gerenciar tipos de item de trabalho

Serviços de DevOps do Azure | 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, você pode querer capturar problemas de clientes em um WIT de tíquete personalizado.

Custom Ticket work item form

Importante

Este artigo aplica-se aos Serviços de DevOps do Azure e ao Azure DevOps Server 2019 e versões posteriores. Para personalizar qualquer projeto definido em uma coleção para o 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 controle de trabalho. Para saber mais, consulte Personalizar acompanhamento de trabalho, Escolher o modelo de processo para sua coleção de projetos.

Para personalizar qualquer projeto definido em uma coleção para o TFS 2018 ou anterior, consulte Modelo de processo XML local.

Pré-requisitos

Antes de personalizar um processo, recomendamos que você revise Configurar e personalizar Painéis do Azure, que fornece orientação sobre como personalizar os Painéis do Azure para atender às suas necessidades de negócios. Para obter uma descrição das diferentes listas de pendências e quadros, consulte Tarefas suportadas por listas de pendências, painéis, painéis de tarefas e planos.

Abrir processo de configurações>

Você cria, gerencia e faz personalizações em processos a partir de Configurações>da organização Processo.

  1. Escolha o logotipo do Azure DevOps para abrir Projetos. 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 Processo, então você está trabalhando a partir do TFS-2018 ou versão anterior. A página Processo não é suportada. Você deve usar os recursos suportados para o modelo de processo XML local.

Você cria, gerencia e faz personalizações em processos a partir do Processo de Configurações>de Coleta.

  1. Escolha o logotipo do Azure DevOps para abrir Projetos. Escolha a coleção de projetos cujos processos você deseja personalizar e, em seguida, escolha Configurações da coleção.

    Open Projects>Organization settings

  2. Em seguida, escolha Processar.

    Then, choose Process.

Você cria, gerencia e faz personalizações em processos a partir de Configurações>de administrador Processo.

  1. Escolha o logotipo do Azure DevOps para abrir Projetos. Em seguida, escolha Configurações de administrador.

    Open Project>Organization settings.

  2. Em seguida, escolha Processar.

    Then, choose Process.

Nota

À 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 os itens de trabalho associados aparecem em uma lista de pendências, quadros, resultados de consultas 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 de 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 foram adicionados, mas não mostrados nem editáveis a partir da página Layout, os elementos padrão incluídos com o cabeçalho do formulário, conforme mostrado na imagem a seguir, bem como o histórico, links e páginas de anexo.

    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 os 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, ícone ou cor de um WIT personalizado, escolha Editar no menu de contexto WIT.

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

Overview page, edit custom ticket description, icon and color

Ativar ou desativar 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.

Você pode querer desativar um WIT personalizado até ter definido todos os campos, fluxo de trabalho e layout que você planejou.

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

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

Nota

A desativação de 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 painéis. 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 WIT.

    Para destruir um WIT, você deve ser membro do grupo Administradores de 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 painéis, Editar ou renomear a lista de pendências de requisitos.

Nota

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.

Nota

Você pode revisar as alterações feitas em um processo herdado por meio do log de auditoria. Para saber mais, consulte Acesso, exportação e filtro de logs de auditoria.