Personalização do processo XML local

  • Artigo

Azure DevOps Server 2022 – Azure DevOps Server 2019

O modelo de processo XML local dá suporte para personalizar objetos de acompanhamento de trabalho e ferramentas Agile para um projeto. Com esse modelo, você pode atualizar a definição XML de tipos de item de trabalho, a configuração do processo, categorias e muito mais. Você também pode atualizar os atributos dos campos.

Você personaliza sua experiência de acompanhamento de trabalho para dar suporte às suas necessidades de negócios e relatórios. As personalizações mais comuns incluem adicionar um campo personalizado, modificar um formulário de item de trabalho ou adicionar um tipo de item de trabalho personalizado.

Para Azure DevOps Server 2019 e versões posteriores, você tem uma escolha de modelos de processo. Ao criar uma coleção de projetos, você precisará escolher entre o modelo de processo XML local e o modelo de processo de herança. Para saber mais, confira Personalizar o acompanhamento de trabalho, Escolha o modelo de processo para sua coleção de projetos.

Importante

A migração de projetos ou coleções de XML hospedado para o modelo herdado não é compatível com Azure DevOps Server. Ele só está disponível no Azure DevOps Sevice.

Para personalizar um projeto de Azure DevOps Services, consulte Sobre personalização de processos e processos herdados. Este artigo se aplica somente a implantações locais.

Personalizações com suporte

Você pode executar as tarefas a seguir ao trabalhar com o modelo de processo XML local.

Área

Suporte à personalização

Campos

Escolher listas

Tipos de item de trabalho

Listas de pendências e configuração de processo

Modelo do processo

Tipo de link

Sequência de personalização

Ao gerenciar uma implantação local, você executa a maioria das personalizações usando a sequência a seguir. Essa sequência dá suporte à atualização da definição de XML para WIT, listas globais, configuração de processo e categorias. Essa sequência dá suporte a atualizações individuais por meio da importação de seus respectivos arquivos de definição XML modificados. Recomendamos que você mantenha seus arquivos de definição XML em um repositório para controle de versão.

Exportar arquivo de definição XMLEditar arquivo de definição XMLImportar arquivo de definição WITAtualizar e verificar alterações

Além disso, você pode usar a ferramenta witadmin para listar objetos, renomear WITs, remover wits permanentemente e muito mais.

Dica

Com o witadmin, você pode importar e exportar arquivos de definição. Outras ferramentas que você pode usar incluem o Editor de Processos (exige que você tenha instalado uma versão do Visual Studio). Instale o editor de Modelo de Processo do Visual Studio Marketplace.

Implicações de manutenção e atualização

Antes de personalizar, você deve entender como suas personalizações podem afetar seu projeto ao atualizar o servidor da camada de aplicativo.

As atualizações para uma implantação local podem introduzir novos recursos que exigem atualizações nos objetos usados para acompanhar o trabalho. Esses objetos incluem tipos de item de trabalho, categorias e configuração de processo. Minimizar as alterações no fluxo de trabalho para um WIT ou a configuração do processo pode ajudar a minimizar o trabalho que você deve fazer ao atualizar sua implantação.

Para minimizar a quantidade de trabalho manual que você precisará fazer após uma atualização, entenda quais personalizações dão suporte a um caminho de atualização fácil e quais não.

Compatível para atualização rápida

Com as personalizações a seguir, você pode usar o Assistente para Configurar Recursos para aplicar automaticamente as alterações necessárias ao projeto para novos recursos.

  • Campos: adicionar campos personalizados, personalizar uma lista de opções, adicionar ou modificar área e caminhos de iteração e adicionar regras a um campo
  • WITs: adicionar WITs personalizados, alterar o layout de formulário
  • Categorias: adicionar categorias personalizadas
  • Ferramentas Agile: personalizar as colunas no quadro Kanban, personalizar o painel de adição rápida
  • Integração do Office: adicionar ou alterar o modo como os campos do Projeto são mapeados para campos do TFS

Para saber mais sobre o Assistente para Configurar Recursos, consulte Configurar recursos após uma atualização.

Compatível, mas pode exigir atualizações manuais

O Assistente para Configurar Recursos requer que existam tipos de item de trabalho específicos, estados de fluxo de trabalho e campos no projeto. Ao fazer as personalizações a seguir, talvez seja necessário modificar o processo personalizado para que o assistente seja executado ou talvez seja necessário atualizar o projeto manualmente.

  • Campos: alterar atributos de um campo existente, remover campos referenciados na configuração do processo
  • WITs: alterar o fluxo de trabalho
  • Ferramentas Agile: altere os WITs definidos para Categoria de Requisito, Categoria de Tarefa ou Categoria de Recurso.
  • Ferramentas Agile: altere o mapeamento de metaestado definido na configuração do processo.
  • Ferramentas Agile: altere um campo especificado para um TypeField na configuração do processo.

Além disso, as alterações feitas em WITs ou no fluxo de trabalho podem exigir atualizações para outros artefatos fornecidos com o processo, como o Excel ou SQL Server Reporting Services relatórios.

Personalizações a serem evitadas

Você deve evitar fazer as personalizações a seguir porque elas podem resultar em conflitos de esquema no data warehouse ou causar problemas ao atualizar projetos após uma atualização do TFS.

  • Campos:
    • Alterar o nome amigável de um campo (um campo especificado em um arquivo de definição WIT)
    • Alterar um ou mais atributos de relatório ou o atributo para sincronizar nomes de pessoas com o Active Directory de um campo padrão
  • WITs: renomear ou excluir WITs
  • Categorias: altere o nome das categorias padrão ou altere os WITs especificados nas categorias padrão

Para saber mais sobre atributos de relatório, consulte Adicionar ou modificar campos de item de trabalho para dar suporte a relatórios.

  • Identifique as melhores opções para personalizar WITs que oferecem suporte aos seus requisitos de acompanhamento. Ao alterar objetos que acompanham itens de trabalho, você deve identificar como essas alterações afetarão projetos existentes e futuros.
  • Coloque processos e todos os arquivos de definição XML sob controle de versão. Não implante os objetos que você definiu, mas não armazenou em um repositório.
  • Teste seus objetos personalizados exatamente como você testaria seu software.
  • Minimize o número de campos personalizados que você introduz. Minimize o número de campos que você torna reportável.

Substituir o caminho da área da equipe por um campo de equipe

A configuração padrão para projetos associa cada equipe a um caminho de área. Se sua organização tiver várias equipes que trabalham de uma lista de pendências comum e em várias áreas do produto, essa configuração pode não se ajustar à maneira como você deseja organizar seu trabalho. {1>Adicionando um campo personalizado para representar equipes<1} em sua organização, você pode reconfigurar as ferramentas e páginas de planejamento do Agile para oferecer suporte às suas equipes e desacoplar a atribuição para equipes e caminhos de área.

Usar campos de equipe em vez de caminhos de área para dar suporte às equipes descreve como alterar a configuração padrão.