Adicionar um campo personalizado a um tipo de item de trabalho (Processo de herança)

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

Você adiciona um campo personalizado para dar suporte aos requisitos de dados de controle que não são atendidos com o conjunto de campos existente. Por exemplo, você pode adicionar um campo personalizado para rastrear um número de ticket de cliente. 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. Para obter uma descrição de cada campo definido com um processo do sistema, confira Índice de campo de item de trabalho.

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 saber mais sobre o que você pode personalizar, consulte Sobre personalização de processos e processos herdados.

Dica

Para personalizar um único projeto, sempre comece criando um processo herdado e atualizando seu projeto para esse processo. Em seguida, todas as personalizações feitas no processo herdado aparecem automaticamente para o projeto migrado.

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.

Criar um processo herdado

A primeira etapa é criar um processo herdado que você possa personalizar. O padrão, os processos do sistema são bloqueados de serem personalizados.

  1. Na página Processo , abra o menu de contexto ... do processo que você usará para criar um processo herdado e escolha Criar processo herdado. Escolha o mesmo processo do sistema — Agile, Basic, Scrum ou CMMI — que foi usado para criar o projeto que você deseja personalizar.

    Aqui, criamos um processo herdado do processo do sistema Agile.

    Context menu, Choose Create inherited process, Azure DevOps.

    Context menu, Choose Create inherited process, Azure DevOps Server 2020.

    Context menu, Choose Create inherited process, Azure DevOps Server 2019.

    Importante

    Se você não vir a opção de menu Criar processo herdado, a coleção selecionada será definida para funcionar com o modelo de processo XML local. Você pode importar e exportar modelos de processo e usar os recursos com suporte para o modelo de processo XML local.

  2. Insira um nome para o processo e, opcionalmente, uma descrição. Os nomes dos processos devem ser exclusivos e não devem ter mais de 128 caracteres. Para obter restrições adicionais, consulte Criar e gerenciar processos de herança, Restrições de nome de processo. Como opção, adicione uma descrição.

    Create inherited process dialog

Adicionar um campo

Você sempre adiciona um campo a um tipo de item de trabalho existente.

  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 Todos os processos e MyAgile .

    All Processes-Process-WIT breadcrumb links

    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.

    Process Work Item Types page, Add a field to a WIT

  3. Nomeie o campo e selecione o tipo de campo de um dos tipos de dados com suporte. Os nomes dos campos devem ser exclusivos e não devem ter mais de 128 caracteres. Para obter restrições adicionais, consulte O que é um campo? Como os nomes de campo são usados?. Como opção, adicione uma Descrição.

    Observação

    Depois de criado, você não pode alterar o nome do campo ou o tipo de dados.

    Aqui, adicionamos um campo Inteiro rotulado Ticket do cliente.

    Add a field to Bug, choose field type

    Os tipos de dados adicionais que você pode adicionar incluem: Lista de opções, Identidade, Rich-text, HTML, e Caixa de seleção.

  4. (Opcional) Na guia Opções , indique se o campo é obrigatório e especifique um valor padrão. Ou deixe-os em branco.

    Add a field to Use story, specify options

    Ao tornar um campo Obrigatório, os usuários devem especificar um valor para o campo para salvá-lo. O valor padrão especificado é definido quando você cria um item de trabalho, bem como sempre que um item de trabalho é aberto e o campo está vazio.

  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 Ticket do cliente a um novo grupo denominado Foco do cliente.

    Add a field to Use story, specify layout
  6. Escolha Adicionar campo para concluir a adição do campo. Se você não tiver especificado seu local de layout, ele será adicionado ao primeiro grupo de campos no formulário de layout.

    Dica

    Depois de adicionar um campo, você pode arrastá-lo e soltá-lo dentro de uma página para realocá-lo no formulário. Se você tiver vários campos que deseja adicionar a uma página ou grupo personalizado, convém adicionar esses elementos primeiro e, em seguida, adicionar seus campos. 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.

Verifique a personalização que você fez

Recomendamos que você crie um projeto de teste e aplique seu processo herdado personalizado a ele para verificar as alterações feitas.

  1. Abra a página Todos os processos e escolha a opção ... menu de contexto para o processo que você deseja usar e, em seguida, selecione Novo projeto de equipe.

    Create a project from the selected process

    Create a project from the selected process

    Create a project from the selected process

  2. A página Criar novo projeto é aberta. Preencha o formulário.

    Create new project form

    Create new project form

    Create new project form

  3. Abra Itens de Trabalho. (1) Verifique se você selecionou o projeto correto e, em seguida, (2) escolha Itens de>trabalho de trabalho.

    Open Work>Work Items

  4. Selecione o WIT que você personalizou. Aqui escolhemos Bug.

    Work, Work Items Page, Add New Work Item, Bug

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

    Bug form, Customer Ticket field added to Customer Focus group

Aplique o processo personalizado ao seu projeto

Depois de verificar suas personalizações, agora você pode aplicar o processo ao seu projeto existente.

Dica

À medida que você personaliza um WIT, todos os projetos que fazem referência ao processo herdado que você está personalizando são atualizados automaticamente para refletir os WITs personalizados que você adicionou. Para exibir suas personalizações, atualize seu navegador da Web.

  1. Para o processo atualmente utilizado pelo projeto, escolha o número de projetos.

    Aqui abrimos o menu para o processo padrão Agile.

    Agile process, Choose number of team projects

  2. Abra o menu de contexto … menu de contexto para o projeto que você deseja alterar e escolha a opção Alterar processo .

    Aqui abrimos o menu para o MyFirstProject1.

    Project, Change process

  3. Na caixa de diálogo Alterar o processo do projeto, escolha o processo no menu de opções. E, em seguida, escolha Salvar.

    Change process dialog

  1. Abra o menu de contexto … menu de contexto para o processo e escolha Alterar projetos de equipe... opção.

    Aqui abrimos o menu para o processo herdado do MyAgile.

    Agile process context menu, Choose Change team projects to use MyAgile

  2. Marque a caixa de seleção dos projetos que você deseja alterar para usar o processo Agile. O sistema lista apenas os projetos que são válidos para o processo atual.

    Aqui optamos por usar o processo Agile para os projetos Fabrikam Fiber A e Fabrikam Fiber. Somente os projetos criados a partir do processo Agile ou que herdam do Agile aparecem na coluna Projetos disponíveis.

    Change process to an inherited process dialog

  3. Depois de confirmar que os projetos que você deseja alterar estão corretos, escolha Ok.

Perguntas e respostas

P: Existem alguns campos que não podem ser usados?

R: Sim, o controle Steps que está disponível no tipo de item de trabalho Caso de Teste não pode ser usado em um tipo de item de trabalho personalizado.

Tentar o próximo

Adicionar um tipo de item de trabalho personalizado Ou Adicionar ou gerenciar campos

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.