Compartilhar via

Preenchimento automático de itens de trabalho com solicitações de pull

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Ao vincular um item de trabalho a uma solicitação de pull, você pode concluir automaticamente esses itens de trabalho ao concluir a PR. Como alternativa, você pode especificar o estado do fluxo de trabalho para o qual fazer a transição do item de trabalho ao mesclar a PR.

Essa automação simplifica seu fluxo de trabalho de desenvolvimento, garantindo que os itens de trabalho reflitam o estado atual das alterações de código sem intervenção manual.

Para saber mais, consulte Criar, exibir e gerenciar solicitações de pull.

Pré-requisitos

Categoria Requisitos
Permissões - Para exibir, seguir e editar itens de trabalho: as permissões para Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó devem estar definidas como Permitir. Por padrão, o grupo Colaboradores tem essas permissões. Para obter mais informações, consulte Definir permissões de acompanhamento de trabalho.
- Para adicionar marcações aos itens de trabalho: a permissão no nível do projeto Criar nova definição de etiqueta deve estar definida como Permitir. Por padrão, o grupo Colaboradores tem essa permissão.
Níveis de Acesso - Membro do projeto.
- Para adicionar novas marcações a itens de trabalho ou para exibir ou seguir solicitações de pull: é preciso pelo menos acesso Básico.
– Para exibir ou seguir itens de trabalho: no mínimo, acesso de Stakeholder. Para obter mais informações, consulte Sobre os níveis de acesso.
- Todos os membros do projeto, incluindo aqueles no grupo Leitores, podem enviar emails contendo itens de trabalho.

Preenchimento automático de itens de trabalho

Para habilitar a conclusão automática de itens de trabalho vinculados ao mesclar uma solicitação de pull, selecione a caixa de seleção Concluir itens de trabalho vinculados após a mesclagem, conforme mostrado na imagem a seguir. O sistema salva sua seleção como o padrão para PRs futuras.

Caixa de diálogo de conclusão de solicitação de pull, conclusão de itens de trabalho vinculados após mesclagem

Quando a conclusão automática não ocorre

O sistema não atualiza automaticamente o estado do item de trabalho para as categorias Concluído, Fechado ou Concluído para o tipo de item de trabalho (WIT) nas seguintes circunstâncias:

  • Item de trabalho já em Estado Resolvido: o item de trabalho, cujo WIT usa o modelo de processo de herança, já está no estado Resolvido . Nesse caso, o sistema não atualiza o estado. Por exemplo, se um bug derivado do processo Agile estiver em um estado Resolvido, o sistema não fará a transição para Fechado.
  • Item de trabalho já concluído: o item de trabalho já está na categoria estado Concluído . Nenhuma ação de transição é necessária.
  • Regras de fluxo de trabalho impedem a transição: o WIT inclui regras de campo de fluxo de trabalho que impedem que o item de trabalho avance para o próximo estado. Por exemplo, uma regra pode exigir que você defina outro campo ao fechar o item de trabalho.
  • Configuração do fluxo de trabalho local: para implantações locais e modelo de processo hospedado do Azure Boards, você deve modificar o fluxo de trabalho para especificar ações (elemento ACTION ) a serem realizadas durante a transição do fluxo de trabalho. Para obter mais informações, consulte Alterar o fluxo de trabalho de um WIT, especificar ações.

Para obter mais informações sobre como personalizar fluxos de trabalho, consulte Personalizar sua experiência de acompanhamento de trabalho.

Especificar o estado do fluxo de trabalho dos itens de trabalho vinculados

Você pode fazer a transição de um item de trabalho para um estado de fluxo de trabalho específico inserindo as informações na descrição da solicitação de pull. Prefixe o #ID com um estado de fluxo de trabalho válido para o item de trabalho mencionado. Essa abordagem fornece controle preciso sobre como os itens de trabalho fazem a transição ao mesclar alterações de código.

O exemplo a seguir mostra histórias de usuário que fazem a transição — uma para o estado Resolvido e a outra para o estado de Revisão . O sistema também marca duas tarefas como Concluídas.

Captura de tela da solicitação de pull, estado do fluxo de trabalho definido para fazer a transição de #ID de itens de trabalho.

Sintaxe para transições de estado

Use os seguintes padrões de sintaxe na descrição da solicitação de pull para especificar transições de estado:

  • Resolves #123 - Transiciona o item de trabalho 123 para o estado Resolvido
  • Fixes #456 - O item de trabalho 456 é movido para o estado de conclusão apropriado.
  • Closes #789 - Transiciona o item de trabalho 789 para o estado Fechado
  • Review #101 - Transiciona o item de trabalho 101 para o estado 'Revisão'

O sistema reconhece palavras-chave comuns e aplica a transição de estado apropriada com base na configuração de fluxo de trabalho do tipo de item de trabalho.

Desabilitar a conclusão automática de itens de trabalho associados

Para desabilitar a conclusão automática de itens de trabalho associados quando os usuários concluírem uma solicitação de pull, siga estas etapas:

  1. Navegue até configurações do Project>repositórios> e selecione seu repositório.
  2. Na guia Configurações, desative a alternância para confirmar a resolução do item de trabalho de menção.

Quando você desabilitar essa configuração, o sistema não permite que menções em comentários de confirmação fechem itens de trabalho (por exemplo, "Correções nº 123"). Essa configuração afeta tanto a conclusão da solicitação de pull quanto as menções de confirmação direta.

Práticas recomendadas

Considere estas práticas recomendadas ao usar a conclusão automática do item de trabalho:

  • Examine os estados do item de trabalho: antes de habilitar a conclusão automática, verifique se os estados do item de trabalho estão alinhados com as expectativas de fluxo de trabalho da sua equipe.
  • Use transições de estado específicas: quando precisar de controle preciso, use a sintaxe de transição de estado em descrições de solicitação de pull em vez de depender do comportamento de conclusão padrão.
  • Regras de fluxo de trabalho de teste: verifique se as regras de fluxo de trabalho personalizadas não impedem transições automáticas de estado.
  • Comunique-se com sua equipe: verifique se todos os membros da equipe entendem como a conclusão automática afeta o acompanhamento de item de trabalho.

Resolução de problemas

Se os itens de trabalho não forem concluídos automaticamente conforme o esperado:

  1. Verificar permissões: verifique se você tem as permissões necessárias para editar itens de trabalho.
  2. Revise as regras de fluxo de trabalho: verifique se nenhuma regra de campo de fluxo de trabalho impede a transição de estado.
  3. Validar links de item de trabalho: confirme se os itens de trabalho estão corretamente vinculados ao pull request.
  4. Verifique o estado atual: verifique se o item de trabalho ainda não está em um estado concluído.
  5. Examinar as configurações do repositório: verifique se a conclusão automática está habilitada nas configurações do repositório.

Conteúdo relacionado

  • Last updated on