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

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Você adiciona um campo personalizado para dar suporte aos requisitos de dados de rastreamento 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 tíquete 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, consulte Índice de campo de item de trabalho.

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.

Para saber mais sobre o que você pode personalizar, consulte Sobre personalização de processos e processos herdados.

Gorjeta

Para personalizar um único projeto, comece sempre 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ê 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.

Criar um processo herdado

O primeiro passo é criar um processo herdado que você pode personalizar. O padrão, os processos do sistema são impedidos 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 suportados para o modelo de processo XML local.

  2. Insira um nome para o seu 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. Opcionalmente, 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 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 processo MyAgile .

    All Processes-Process-WIT breadcrumb links

    Se o campo Novo e outras opções estiverem desativados, você não terá as permissões necessárias para editar o processo. Consulte 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 suportados. Os nomes dos campos devem ser exclusivos e não devem ter mais de 128 caracteres. Para restrições adicionais, consulte O que é um campo? Como são utilizados os nomes dos campos?. Opcionalmente, adicione uma Descrição.

    Nota

    Uma vez criado, não é possível alterar o nome do campo ou o tipo de dados.

    Aqui adicionamos um campo Inteiro chamado Ticket do Cliente.

    Add a field to Bug, choose field type

    Os tipos de dados adicionais que você pode adicionar incluem: Picklist, Identity, Rich-text, HTML e Checkbox.

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

    Gorjeta

    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, adicione esses elementos primeiro e, em seguida, adicione 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.

Verificar a personalização feita

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 o botã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 certo 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.

Gorjeta

À 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 visualizar 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 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 para o processo e escolha a opção Alterar projetos da 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 Fibra. Somente os projetos criados a partir do processo Agile ou um que herda do Agile aparecem na coluna Projetos disponíveis.

    Change process to an inherited process dialog

  3. Depois de confirmar que os projetos que 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 Test Case não pode ser usado em um tipo de item de trabalho personalizado.

Tente isso a seguir

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

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.