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.

Dica

Você pode usar a IA para ajudar nessa tarefa mais adiante neste artigo ou consulte Ativar a assistência de IA com o Azure DevOps Server MCP para começar.

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 de fluxo de trabalho localmente: 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) que ocorram 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.

Usar IA para gerenciar itens de trabalho vinculados a pull requests

Se você configurar o servidor MCP Azure DevOps, poderá consultar e gerenciar itens de trabalho vinculados a solicitações pull usando linguagem natural.

Tarefa Exemplo de prompt
Localizar itens vinculados Show all work items linked to open pull requests in project <Contoso>
Verificar o status de conclusão List work items linked to merged PRs that are still in the Active state in <Contoso>
Vincular um item de trabalho a uma PR Link work item #3456 to pull request #789 in project <Contoso>
Auditar itens vinculados à PR Show all pull requests merged this sprint with their linked work items for <Contoso>
Localizar itens que estão sem links de PR List all completed user stories in Sprint 12 that have no linked pull request in project <Contoso>
Detectar links de PR obsoletos Find work items linked to pull requests that were abandoned or closed without merging in <Contoso>
Verificar se o preenchimento automático funcionou Which work items linked to PRs merged today are still not in the Done or Closed state in project <Contoso>?
Acompanhar a atividade de PR por responsável For each team member on <Contoso Team>, list their work items that have linked PRs currently in review
Localizar itens com várias PRs Show work items in project <Contoso> that are linked to more than one pull request
Relatório de cobertura do Sprint PR What percentage of completed work items in Sprint 12 have at least one linked pull request in <Contoso>?

Observação

Se você estiver usando o Visual Studio Code, o agent mode será especialmente útil para gerenciar relações de itens de trabalho e solicitações de pull.

Conteúdo relacionado

  • Last updated on