Sobre a personalização do processo e processos herdados

  • Artigo

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

Para personalizar o sistema de controle de trabalho, você personaliza um processo herdado por meio da interface do usuário administrativo da organização. Todos os projetos que usam um processo herdado recebem as personalizações feitas nesse processo. Por outro lado, você configura suas ferramentas ágeis — Backlogs, Sprints, quadros Kanban e Taskboard — para cada equipe.

Importante

Para personalizar um projeto local ou atualizar arquivos de definição XML para oferecer suporte à personalização, consulte Modelo de processo XML local. Este artigo se aplica somente aos Serviços de DevOps do Azure e ao Servidor de DevOps do Azure 2019.

Há uma série de personalizações que você pode fazer. Os principais são adicionar tipos de item de trabalho personalizados (WITs) ou modificar um WIT existente para adicionar campos personalizados, modificar o layout ou alterar o fluxo de trabalho.

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.

Abaixo você encontrará um índice para as tarefas que você pode executar para personalizar um processo herdado. Algumas opções de elementos herdados estão bloqueadas e não podem ser personalizadas.

Sistema versus processos herdados

Você verá dois tipos de processos:

  • locked iconProcessos do sistema — Agile, Basic, Scrum e CMMI — que estão bloqueados de serem alterados.
  • inherited icon Processos herdados, que você pode personalizar e que herdam definições do processo do sistema a partir do qual foram criados. Os processos do sistema são de propriedade e atualizados periodicamente pela Microsoft. Quaisquer atualizações feitas em um processo do sistema causam automaticamente uma atualização em seus processos herdados e seus processos herdados filho. As atualizações de processos estão documentadas nas Notas de Versão do Servidor de DevOps do Azure.

Observação

O processo Básico está disponível no Azure DevOps Server 2019 Atualização 1 e em versões posteriores.

Além disso, todos os processos são compartilhados. Ou seja, um ou mais projetos podem utilizar um único processo. Em vez de personalizar um único projeto, você personaliza um processo. As alterações feitas no processo atualizam automaticamente todos os projetos que usam esse processo. Depois de criar um processo herdado, você pode personalizá-lo, criar projetos com base nele, fazer uma cópia dele e alterar projetos existentes para usá-lo.

Por exemplo, como mostrado na imagem a seguir, você verá uma lista de projetos definidos para a organização fabrikam . A segunda coluna mostra o processo usado por cada projeto. Para alterar as personalizações do projeto Fabrikam Fiber, você precisa modificar o processo MyScrum (que herda do processo do sistema Scrum). Quaisquer alterações feitas no processo MyScrum também atualizam outros projetos que usam esse processo. Você não pode personalizar o projeto de teste de consulta, por outro lado, até alterá-lo para um processo que herda do Agile.

Screenshot of Admin context, Organization settings, Project list and the process they use.

Restrições de nome de processo

Os nomes de processo devem ser exclusivos e ter 128 caracteres Unicode ou menos. Além disso, os nomes não podem conter os seguintes caracteres: .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Para renomear um processo, abra o ... menu de contexto para o processo e escolha Editar.

Alterar o processo de referência de um projeto

Se você quiser alternar o processo que um projeto usa de um processo do sistema para outro, você pode fazer isso. Para fazer essas alterações, você deve criar um processo herdado com base no processo para o qual deseja alternar. Por exemplo, são fornecidas instruções para suportar as seguintes alterações:

Seguindo as orientações fornecidas nos artigos listados acima, você também pode fazer alterações adicionais, por exemplo, do CMMI para o Agile ou do Agile para o CMMI.

Antes de fazer essa alteração, recomendamos que você se familiarize com o processo para o qual está mudando. Os processos do sistema são resumidos em Sobre processos e modelos de processo.

Práticas recomendadas ao fazer alterações

Fazer alterações em um processo herdado é simples e seguro. No entanto, é sempre uma prática recomendada testar essas alterações antes de aplicá-las a um projeto ativo. Seguir estas etapas irá ajudá-lo a revelar quaisquer efeitos negativos que suas alterações de processo possam ter.

Objetos herdados versus objetos personalizados

Cada processo herdado criado herda os WITs definidos no processo do sistema — Básico, Agile, Scrum ou CMMI. Por exemplo, o processo Agile fornece WITs relacionados a bugs, tarefas, histórias de usuários, recursos, épicos, problemas e testes.

Conceptual image of Agile process work item hierarchy.

Você pode adicionar campos e modificar o fluxo de trabalho e o formulário de item de trabalho para todos os WITs herdados exibidos na página Tipos de Item de Trabalho . Se você não quiser que os usuários criem um WIT, poderá desativá-lo. Além disso, você pode adicionar WITs personalizados.

Personalizações de campo

Os campos definidos no processo do sistema aparecem com um ícone herdado, indicando que você pode fazer modificações limitadas nele no processo herdado.

Os campos são definidos para todos os projetos e processos da organização. Isso significa que qualquer campo personalizado definido para um WIT em um processo pode ser adicionado a qualquer outro WIT definido para outro processo.

Tipo de campo

Suporte à personalização

Campos herdados

Campos personalizados

Controle personalizado

Ao adicionar campos personalizados, observe os seguintes limites:

  • Um máximo de 64 campos pode ser definido para cada WIT
  • Um máximo de 512 campos pode ser definido por processo

Além disso, você pode adicionar um campo existente a outro WIT dentro do processo. Por exemplo, você pode adicionar Data de Conclusão à história do usuário ou WITs de bug.

O que você não pode personalizar

  • Não é possível alterar o nome do campo ou o tipo de dados depois de defini-lo
  • Não é possível modificar a área cinza no formulário onde os campos Estado, Motivo, Caminho da Área e Caminho de iteração estão localizados
  • Não é possível importar ou definir uma lista global com suporte nos modelos de processo XML hospedado e XML local. Para saber mais, consulte Definir listas globais.
  • Não é possível alterar o nome do campo ou o tipo de dados depois de defini-lo
  • Não é possível modificar a área cinza no formulário onde os campos Estado, Motivo, Caminho da Área e Caminho de iteração estão localizados
  • Com relação às listas de opções, atualmente não é possível executar estas operações:
    • Alterar a lista de opções de um campo herdado, como o campo Atividade ou Disciplina
    • Alterar a ordem da lista de opções, as listas de opções são exibidas em ordem alfabética
  • Não é possível modificar o texto de ajuda Descrição dos campos herdados
  • Importe ou defina uma lista global com suporte nos modelos de processo XML hospedado e XML local. Para saber mais, consulte Definir listas globais.

Observação

Com o processo herdado, não é possível modificar as listas de opções de campos predefinidos, como Atividade, Status de Automação, Disciplina, Prioridade e outros.

Listas de opções configuráveis

As listas de opções a seguir são configuradas para cada projeto e não podem ser personalizadas por meio de um processo herdado.

As listas de opções associadas a campos de nome de pessoa, como Atribuído a e Alterado por, são gerenciadas com base nos usuários que você adiciona a um projeto ou equipe.

Posso renomear um campo ou alterar seu tipo de dados?

Renomear um campo ou alterar o tipo de dados não são ações com suporte. No entanto, você pode alterar o rótulo que aparece para um campo no formulário de item de trabalho na guia Layout. Ao selecionar o campo em uma consulta, você precisa selecionar o nome do campo e não o rótulo do campo.

Posso excluir ou restaurar um campo excluído?

Você pode excluir um campo e restaurá-lo posteriormente. A exclusão de um campo exclui todos os dados associados a esse campo, incluindo valores históricos. Depois de excluído, você só pode restaurar o campo e recuperar os dados usando a API REST Fields - Update.

Em vez de excluir um campo, convém ocultar ou remover o campo de um formulário de item de trabalho. Para obter detalhes, consulte Adicionar e gerenciar campos, Mostrar, ocultar ou remover um campo.

O que é um campo? Como os nomes de campo são usados?

Cada tipo de item de trabalho está associado a 31 campos do sistema e vários outros campos específicos do tipo. Você usa itens de trabalho para planejar e acompanhar seu projeto.

Cada campo dá suporte ao acompanhamento de uma informação sobre o trabalho a ser executado. Os valores atribuídos a um campo são guardados no armazenamento de dados de acompanhamento de trabalho que você pode criar consultas para determinar status e tendências.

Para obter descrições e uso de cada campo definido para os principais processos do sistema — processos do sistema Scrum, Agile e CMMI — consulte Índice de campo de item de trabalho.

Nomes de campo

Um nome de campo de item de trabalho identifica com exclusividade cada campo de item de trabalho. Verifique se os nomes de campo estão dentro destas diretrizes:

  • Os nomes de campo devem ser exclusivos dentro da organização ou coleção de projetos
  • Os nomes de campo devem ter 128 ou menos caracteres Unicode
  • Os nomes de campo não podem conter espaços à esquerda ou à direita, nem dois ou mais espaços consecutivos
  • Os nomes de campo devem conter pelo menos um caractere alfabético
  • Os nomes de campo não podem conter os seguintes caracteres: .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Como todos os campos são definidos para a organização, não é possível adicionar um campo personalizado com o mesmo nome de campo que já existe na organização ou foi adicionado a um WIT em outro processo herdado.

Observação

Quando você altera um projeto para usar um processo herdado, pode encontrar uma ou mais ferramentas Agile ou itens de trabalho que aparecem em um estado inválido. Por exemplo:

  • Se você fizer um campo necessário, os itens de trabalho com esse campo indefinido mostrarão uma mensagem de erro. Você precisará resolve os erros para fazer alterações adicionais e salvar o item de trabalho.
  • Se você adicionar ou remover/ocultar estados de fluxo de trabalho de um WIT que aparece no quadro Kanban, será necessário atualizar as configurações de coluna do quadro Kanban para todas as equipes definidas no projeto.

Regras personalizadas e regras do sistema

Cada WIT — bug, tarefa, história do usuário, etc. — tem várias regras do sistema já definidas. Alguns são simples, como tornar o campo Título obrigatório ou definir um padrão para o campo Área do valor. Além disso, várias regras do sistema definem ações a serem tomadas quando um estado de fluxo de trabalho é alterado.

Por exemplo, existem várias regras para copiar a identidade do usuário atual nas seguintes condições:

  • Quando um item de trabalho for modificado, copie a identidade do usuário para o campo Alterado por
  • Quando o estado do fluxo de trabalho for alterado para Fechado ou Concluído, copie a identidade do usuário para o campo Fechado por.

Importante

As regras de sistema predefinidas têm precedente sobre qualquer regra personalizada que você defina que a substituiria.

As regras personalizadas fornecem suporte para vários casos de uso de negócios, permitindo que você vá além de definir um valor padrão para um campo ou torná-lo obrigatório. As regras permitem limpar o valor de um campo, copiar um valor em um campo e aplicar valores com base nas dependências entre valores de campos diferentes.

Com uma regra personalizada, você pode definir várias ações com base em condições específicas. Por exemplo, você pode aplicar uma regra para oferecer suporte a esses tipos de cenários:

  • Quando um valor é definido para Prioridade, torne Risco um campo obrigatório
  • Quando uma alteração for feita no valor de Release, limpe o valor de "Milestone"
  • Quando uma alteração foi feita no valor de Trabalho Restante, torne Trabalho Concluído um campo obrigatório
  • Quando o valor de Aprovado for True, faça Aprovado por um campo obrigatório
  • Quando uma história de usuário for criada, torne os seguintes campos obrigatórios: Prioridade, Risco e Esforço

Dica

Não é possível definir uma fórmula usando uma regra. No entanto, você pode encontrar uma solução que atenda às suas necessidades com a extensão Power Automate ou TFS Aggregator (Web Service) Marketplace. Consulte também Rollup de trabalho e outros campos.

Para obter detalhes sobre como definir regras personalizadas, consulte Regras e avaliação de regras.

Restringir a modificação de campos selecionados para grupos de usuários selecionados

Usando uma das duas condições a seguir, você pode tornar os campos de seleção obrigatórios para um usuário de um grupo de segurança ou que não seja membro de um grupo de segurança.

  • current user is a member of a group...
  • current user is not a member of a group...

Por exemplo, você pode tornar o campo Título ou Estado Somente leitura para usuários ou grupos selecionados.

Restringir a modificação de itens de trabalho com base no Caminho da Área

Você pode impedir que os usuários modifiquem itens de trabalho selecionados definindo permissões em um caminho de área. Esta não é uma configuração de regra, mas uma configuração de permissão. Para saber mais, consulte Criar nós filho, modificar itens de trabalho em um caminho de área.

Personalizações de tipo de item de trabalho (WIT)

Aqui estão suas opções de personalização para WITs herdados e personalizados.

Tipo de item de trabalho

Suporte à personalização

Tipos de item de trabalho herdados

Tipos de item de trabalho personalizados

O que você não pode personalizar

  • Não é possível adicionar ou remover um WIT herdado de ou para uma lista de pendências
  • Não é possível alterar a posição de um campo herdado dentro do layout do formulário (no entanto, você pode ocultar o campo em uma área do formulário e adicioná-lo em outro lugar do formulário)
  • Não é possível remover o nível de portfólio herdado do produto (mas você pode renomeá-lo)
  • Não é possível alterar o nome de um WIT personalizado.

Personalizações de formulário de item de trabalho

Você pode fazer as seguintes personalizações em um formulário WIT.

Tipo de grupo ou página

Suporte à personalização

Grupos herdados

Grupos personalizados

Páginas herdadas

Páginas personalizadas

Layout e redimensionamento

O layout do formulário da Web é organizado em três colunas, conforme mostrado na imagem abaixo.

Illustration of 3-column page layout for work item form.

Se você adicionar apenas grupos e campos às duas primeiras colunas, o layout refletirá um layout de duas colunas. Da mesma forma, se você adicionar apenas grupos e campos à primeira coluna, o layout refletirá um layout de uma coluna.

O formulário da Web é redimensionado dependendo da largura disponível e do número de colunas no layout. Na largura máxima, na maioria dos navegadores da Web, cada coluna dentro de uma página é exibida dentro de sua própria coluna. À medida que a largura de exibição diminui, cada coluna é redimensionada proporcionalmente da seguinte maneira:

  • Para três colunas: 50%, 25% e 25%
  • Para duas colunas: 66% e 33%
  • Para uma coluna: 100%.

Quando a largura de exibição não acomoda todas as colunas, as colunas aparecem empilhadas dentro da coluna à esquerda.

Personalizações de fluxo de trabalho

Você pode personalizar o fluxo de trabalho de qualquer tipo de item de trabalho (WIT) ocultando estados herdados ou adicionando estados personalizados. Os estados herdados diferem com base no processo do sistema — Agile, Basic, Scrum ou CMMI — que você escolheu a partir do qual criar seu processo personalizado.

Cada fluxo de trabalho padrão para cada WIT define entre dois e quatro Estados e especifica as seguintes operações de fluxo de trabalho:

  • Transições para frente e para trás entre cada estado
  • Motivos padrão para cada transição de estado

Por exemplo, o processo Básico, Issue WIT é caracterizado pelos três Estados — To Do, Doing e Done — e transições mostradas na imagem a seguir.

Basic Process, Issue work item type, workflow state model

Tipos de estado

Personalizações suportadas

Inherited icon Estados herdados

Estados personalizados

Os estados do fluxo de trabalho devem estar em conformidade com as seguintes regras

Personalizações de fluxo de trabalho sem suporte

  • Não é possível modificar um estado herdado (não é possível alterar seu nome, cor ou categoria), mas você pode ocultá-lo
  • Você só pode ter um estado na categoria Estado concluído . Se você adicionar um estado personalizado à categoria Concluído, qualquer outro estado será removido ou oculto
  • Não é possível alterar o nome de um estado personalizado
  • Não é possível especificar um Motivo para um estado, em vez disso, os motivos padrão são definidos, como Movido para estado Triado, Movido para fora do estado Triagem
  • Não é possível alterar o local dos campos Estado e Motivo no formulário
  • Não é possível personalizar nomes de categorias de estado
  • Não é possível modificar um estado herdado (não é possível alterar seu nome, cor ou categoria), mas você pode ocultá-lo
  • Você só pode ter um estado na categoria Estado concluído . O sistema não permite adicionar qualquer estado personalizado a esta categoria
  • Não é possível alterar o nome de um estado personalizado
  • Não é possível alterar a ordem dos estados, os estados são listados em sua sequência natural com base em sua categoria de estado dentro da lista suspensa de um formulário de item de trabalho
  • Não é possível especificar um Motivo para um estado, em vez disso, os motivos padrão são definidos, como Movido para estado Triado, Movido para fora do estado Triagem
  • Não é possível alterar o local dos campos Estado e Motivo no formulário
  • Você não pode restringir transições, todas as transições são definidas de qualquer estado para outro estado.

Backlog e personalizações da placa

Backlogs e quadros são ferramentas ágeis essenciais para criar e gerenciar o trabalho de uma equipe. As lista de pendências standard, produto, iteração e portfólio, herdados do processo do sistema são totalmente personalizáveis. Além disso, você pode adicionar listas de pendências do portfólio personalizadas para um total de cinco listas de pendências do portfólio.

Tipos de lista de pendências

Suporte à personalização

Listas de pendências herdadas

Listas de pendências de portfólio personalizadas

O que você não pode personalizar

  • Não é possível remover um nível de portfólio herdado do produto (mas você pode renomear o nível de portfólio e desabilitar um tipo de item de trabalho herdado)
  • Não é possível inserir um nível de lista de pendências dentro do conjunto existente de listas de pendências definidas
  • Não é possível reordenar os níveis de lista de pendências
  • Não é possível adicionar um tipo de item de trabalho a dois níveis de lista de pendências diferentes
  • Não é possível criar um nível de lista de pendências de tarefas personalizadas, embora seja possível adicionar WITs personalizadas à lista de pendências de iteração
  • Você não pode adicionar o Bug WIT a qualquer nível de lista de pendências. Em vez disso, o sistema permite que cada equipe decida como deseja gerenciar bugs. Para saber mais, consulte Mostrar bugs em listas de pendências e placas.
  • Não é possível adicionar ou remover um WIT herdado de ou para uma lista de pendências, por exemplo, não é possível adicionar o WIT de problemas à lista de pendências do produto
  • Não é possível remover um nível de portfólio herdado do produto (mas você pode renomear o nível de portfólio e desabilitar um tipo de item de trabalho herdado)
  • Não é possível inserir um nível de lista de pendências dentro do conjunto existente de listas de pendências definidas
  • Não é possível reordenar os níveis de lista de pendências
  • Não é possível adicionar um tipo de item de trabalho a dois níveis de lista de pendências diferentes
  • Não é possível criar um nível de tarefa personalizado, embora você possa adicionar tipos de item de trabalho personalizados à lista de pendências de iteração
  • Você não pode adicionar o Bug WIT a qualquer nível de lista de pendências. Em vez disso, o sistema permite que cada equipe decida como deseja gerenciar bugs. Para saber mais, consulte Mostrar bugs em listas de pendências e placas.

Observação

Determinados recursos exigem a instalação da atualização do Azure DevOps Server 2020.1. Para obter mais informações, consulte Notas de versão do Azure DevOps Server 2020 Atualização 1 RC1, Quadros.

Quando você altera o WIT padrão para um nível de lista de pendências, ele faz com que o WIT apareça por padrão no painel de adição rápida. Por exemplo, o Ticket do Cliente aparece por padrão no painel de adição rápida a seguir para a lista de pendências do produto.

Screenshot of Product backlog, Quick Add Panel, Displays Default WIT for a backlog level

Limites do objeto

Para obter uma lista de limites colocados no número de campos, WITs, níveis de lista de pendências e outros objetos que você pode personalizar, consulte Limites de objetos de controle de trabalho.