Personalizar um modelo de processo

Azure DevOps Server 2022 – Azure DevOps Server 2019

Os modelos de processo definem os objetos e processos disponíveis para você quando você cria um projeto. Ao personalizar um modelo de processo, você personaliza um dos mais objetos. Os tipos comuns de personalizações que você pode fazer incluem:

• Adicionar um novo campo a um tipo de item de trabalho existente (WIT)
• Modificar a lista de seleção de valores de um campo
• Alterar os estados, motivos, transições e ações do fluxo de trabalho de um tipo de item de trabalho padrão ou personalizado
• Editar o layout de um formulário de item de trabalho
• Adicionar ou remover um tipo de item de trabalho
• Alterar a configuração do processo ou os padrões associados aos hubs do Azure Boards

Observação

Este artigo descreve modelos de processo usados para criar projetos definidos nos Serviços de DevOps do Azure. Se você estiver procurando modelos de projeto para desenvolvimento de software, consulte Criando modelos do Visual Studio.

Os modelos de processo padrão definem as configurações padrão e os tipos de item de trabalho usados pelos Quadros do Azure e pelos Planos de Teste do Azure. Por exemplo, o modelo de processo Agile define o conjunto de tipos de item de trabalho mostrado na imagem a seguir.

Muitos desses artefatos dependem de tipos de item de trabalho que são usados para controlar o trabalho. Por exemplo, os campos de dados definidos na definição de Recurso, Bug, História do Usuário ou Tarefa também são usados para definir consultas de item de trabalho. Além desses artefatos, você também pode definir as áreas e iterações iniciais do projeto, a configuração de segurança e outras configurações padrão que oferecem suporte a planos de teste.

Depois de criar um projeto, você pode alterar configurações e personalizar artefatos. No entanto, personalizando o modelo de processo antes de criar seus projetos, todos os projetos resultantes que você criar a partir dele corresponderão a um conjunto padrão de processos de equipe. Os principais motivos pelos quais você pode querer personalizar um modelo de processo incluem:

• Você planeja criar vários projetos e deseja minimizar tarefas repetitivas que você terá que implementar posteriormente em cada projeto que você criar
• Você deseja garantir que todas as equipes sigam determinados padrões, fornecendo os modelos e estruturas dentro do conjunto de ferramentas que suas equipes de desenvolvimento de software usam
• Você precisa atualizar um modelo de processo personalizado para oferecer suporte ao uso do assistente Configurar Recursos após uma atualização

Se você trabalha com apenas um único projeto, pode considerar simplesmente criar o projeto e personalizar um ou mais objetos posteriormente.

Como os modelos de processo são usados?

O principal uso de modelos de processo é criar um projeto. Para o modelo de processo XML hospedado, ele também é usado para atualizar um projeto. Um projeto fornece o conjunto de objetos, artefatos e configurações definidos no conjunto interdependente de arquivos de modelo. Você usa seu projeto para organizar o código-fonte, controlar o trabalho e as informações, criar software e dar suporte a atividades de teste.

Modelo de processo XML hospedado

• Criar um projeto
• Adicionar ou atualizar um processo

Modelo do processo XML local

• Criar um projeto

Onde devo começar?

Antes de começar a personalizar um modelo de processo, você vai querer se familiarizar com o que você pode configurar e personalizar e, em seguida, planejar suas alterações de acordo.

• Se você é novo em modelos de processo, primeiro revise os modelos de processo padrão.

• Se você quiser se familiarizar com a estrutura de arquivos de um modelo de processo, revise uma descrição para cada arquivo ou baixe um modelo de processo.

  Você pode modificar os processos para seu projeto depois que ele é criado. À medida que você trabalha com um projeto, as configurações iniciais definidas pelo modelo de processo podem não atender mais às suas necessidades.

• Se você estiver mais interessado em personalizar objetos usados para controlar o trabalho, o que inclui planos de teste, conjuntos de testes e casos de teste, revise Personalizar sua experiência de acompanhamento de trabalho. As personalizações feitas modificando um arquivo de definição XML para um projeto são os mesmos tipos de personalizações feitas em um arquivo de modelo de processo.

  Se você quiser adicionar ou modificar tipos de itens de trabalho, poderá conseguir isso sem alterar todo o modelo de processo. Você pode fazer e testar alterações usando um projeto existente. Para o modelo de processo XML local, você pode usar as ferramentas de linha de comando witadmin exportwitd e importwitd para baixar e carregar os arquivos de definição XML para tipos de item de trabalho.

• Se você estiver pensando em fazer personalizações extensas, analise como as alterações feitas afetarão a manutenção e a atualização de seus projetos.

Arquivos de modelo de processo e áreas funcionais que você pode personalizar

Os modelos de processo consistem em nove plug-ins. Cada plug-in define um conjunto de tarefas que são executadas e as telas que aparecem quando você cria um projeto. As tarefas definem permissões, criam pastas, carregam arquivos, ativam sites ou definem outras variáveis configuráveis. Os plug-ins também especificam as dependências que uma tarefa tem na conclusão bem-sucedida de outras tarefas.

Para personalizar um modelo de processo, personalize um ou mais arquivos associados a uma área funcional. Embora a personalização de qualquer objeto seja bastante simples, você vai querer ter certeza de que não quebra nenhuma interdependência ao personalizar. O arquivo de plug-in ProcessTemplate.xml define quais plug-ins devem ser incluídos no modelo. Esse arquivo contém todos os grupos de tarefas que você deseja executar para criar um projeto. Cada grupo de tarefas faz referência a um arquivo de plug-in XML subordinado onde as tarefas específicas para esse plug-in são definidas.

• Equipes, grupos, permissões, área de & e caminhos de iteração

  • Caminhos de área e iteração
  • Grupos, equipes, membros e permissões

• Acompanhamento de item de trabalho

  • Definições de WIT
  • Categorias
  • Configuração do processo
  • Tipo de link

• Gerenciamento de testes

  • Testar ambientes, configurações, estados de resolução e configurações

Dependências de plug-in

Muitos objetos dependem da definição de outros objetos dentro de um modelo de processo. Para obter uma visão geral dos plug-ins e dependências de plug-in necessários, consulte Definir dependências para grupos de tarefas e tarefas.

Restrições de plug-in e nomenclatura

Ao adicionar objetos a um modelo de processo, certifique-se de rotulá-los corretamente para evitar erros de validação XML.

• As restrições são colocadas nos nomes ou rótulos da maioria dos objetos do Team Foundation. Para obter uma visão geral das restrições de nomenclatura que se aplicam a modelos de processo, grupos de segurança, nós de área e iteração, tipos de item de trabalho e campos de item de trabalho, consulte Restrições de nomenclatura.

• A maioria dos componentes de modelo de processo que você personaliza afetará somente o projeto que você cria usando o modelo de processo. As exceções a essa regra são listas globais, tipos de link e campos de item de trabalho. Esses objetos são definidos para uma coleção de projeto.

• Cada campo de item de trabalho tem um nome de referência de campo associado que identifica exclusivamente cada campo. O nome de referência não pode ser alterado depois de atribuído.

  Nomes de campo de item de trabalho, nomes de tipo de link e listas globais têm escopo definido para uma coleção de projeto. Se você personalizar qualquer um desses objetos, a alteração será refletida em todos os projetos definidos na coleção e nos tipos de item de trabalho que contêm esse campo de item de trabalho.

• O tamanho máximo de um modelo de processo é de dois gigabytes. Ao personalizar um modelo de processo, certifique-se de que suas alterações não aumentem seu tamanho além desse valor.

Etapas para personalizar um modelo de processo

Personalizar um modelo de processo é um processo iterativo. Você precisará de uma coleção de projetos definida em um servidor que esteja executando o Servidor de DevOps do Azure, onde você pode testar seu modelo de processo para verificar se ele foi personalizado corretamente.

Para personalizar um modelo de processo, primeiro baixe um modelo de processo existente, modifique ou adicione arquivos, carregue os arquivos de modelo de processo e verifique suas alterações.

Etapa	Tarefa
	Baixe um modelo de processo. Antes de personalizar um modelo de processo, você deve baixá-lo para o computador local. Para minimizar as modificações que você deve fazer, selecione um modelo que mais se aproxime dos processos da sua equipe. Em geral, você escolhe um modelo de processo com base nos tipos de itens de trabalho e fluxo de trabalho.
	Modificar ou adicionar arquivos. Você personaliza um modelo de processo modificando, excluindo ou adicionando arquivos definidos para um modelo de processo. Você personaliza um plug-in ou arquivo de definição modificando seu conteúdo XML. Cada arquivo de plug-in e arquivo de definição de tipo deve estar em conformidade com sua definição de esquema XML. Na primeira vez que você personalizar um modelo de processo, faça uma pequena alteração. Se você fizer muitas alterações sem uma boa compreensão de como as alterações podem afetar seu modelo, corre o risco de encontrar vários erros que serão difíceis de depurar. Certifique-se de que o nome do seu modelo de processo é exclusivo. Se você baixar um modelo de processo, fazer alterações e carregá-lo, deverá alterar seu nome ou ele substituirá o modelo de processo existente da coleção de projetos.
	Carregue um modelo de processo. Depois de personalizar seu modelo, carregue-o para a coleção de projeto onde você criará o projeto. Idealmente, você deve usar uma coleção de projeto que não é usada por outros projetos. Ao trabalhar em uma coleção de projeto de banco de testes, você evita introduzir uma alteração que possa colidir com processos de equipe existentes que ainda estão em desenvolvimento. Além disso, você desejará que a coleção de projetos ofereça suporte aos mesmos recursos que deseja acessar, como um portal de projeto e um site de relatórios. Certifique-se de que o nome do seu modelo de processo é exclusivo. Se você baixou um modelo de processo de uma coleção de projetos, fez uma alteração e agora está carregando o modelo, você deve alterar seu nome ou excluir o modelo de processo existente da coleção de projetos. O processo de carregamento executa uma verificação para certificar-se de que o XML é válido. Se você receber algum erro ao tentar carregar o modelo de processo, as alterações feitas terão causado o erro. Revise suas alterações e corrija quaisquer erros de sintaxe XML encontrados.
	Crie um projeto. Para testar novos modelos de processo, você deve criar um projeto. Se ocorrerem erros, exiba o log para a criação do projeto. Ele contém uma lista das tarefas que tentou executar e mostra quais tarefas falharam. Você pode mapear tarefas com falha de volta para o XML para determinar a causa dos erros. Você pode limpar projetos desnecessários usando a ferramenta de linha de comando TFSDeleteProject.
	Verifique as alterações nos modelos de processo. Antes de colocar seu modelo de processo no modo de produção e usá-lo como base para vários projetos, você deve verificar se ele está bem definido. Você executa essa tarefa verificando sistematicamente se cada objeto e artefato funciona conforme o esperado.

Artigos relacionados

• Visão geral dos modelos de processo
• Modelo de processo e arquivos de plug-in
• Configurar recursos após uma atualização
• Plug-ins de modelo de processo: Indexar para elementos XML
• Referência de elemento XML

Ferramentas que oferecem suporte à personalização de um modelo de processo

Você pode personalizar um modelo de processo usando uma das seguintes ferramentas:

• Qualquer editor de texto ou editor XML para modificar arquivos XML.

• A ferramenta Editor de Processos.
  Com base na versão do Visual Studio que você instalou, obtenha a Ferramenta de Editor de Processos de uma das extensões a seguir.

  • Visual Studio 2019: Editor de Modelo de Processo.
  • Visual Studio 2017: Editor de Modelo de Processo TFS. Você também pode usar essa versão do Editor de Processos para modificar os formulários de item de trabalho de estilo antigo. Não é possível usá-lo para editar formulários associados aos novos formulários da Web.
  • Visual Studio 2015: TFS Power Tools.