Partilhar via

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

Azure DevOps Serviços | Azure DevOps Server | Azure DevOps Server 2022

Quando você vincula um item de trabalho a uma solicitação pull (PR), você pode concluir automaticamente esses itens de trabalho quando concluir a RP. Como alternativa, você pode especificar o estado do fluxo de trabalho para fazer a transição do item de trabalho após a mesclagem do 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.

Sugestão

Pode usar IA para ajudar nesta tarefa mais adiante neste artigo, ou consultar Enable AI assistance with Azure DevOps MCP Server para começar.

Para obter mais informações, consulte Criar, visualizar e gerir pull requests.

Pré-requisitos

Categoria Requerimentos
Permissões - Para visualizar, seguir e editar itens de trabalho: Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó permissões definidas como Permitir. Por padrão, o grupo de Colaboradores tem essas permissões. Para obter mais informações, consulte Definir permissões de controle de trabalho.
- Para adicionar tags a itens de trabalho: Criar nova definição de tag de nível de projeto, com a permissão definida como Permitir. Por padrão, o grupo de Colaboradores tem essa permissão.
Níveis de acesso - Membro do projeto.
- Para adicionar novas tags a itens de trabalho ou para visualizar ou seguir pedidos de pull: Pelo menos acesso Básico.
- Para visualizar ou acompanhar itens de trabalho: É necessário ter, pelo menos, acesso de Stakeholder. Para obter mais informações, consulte Sobre os níveis de acesso.
- Todos os membros do projeto, incluindo os do grupo Readers, podem enviar e-mails contendo itens de trabalho.

Preenchimento automático de itens de trabalho

Para habilitar a conclusão automática de itens de trabalho vinculados quando você mescla uma solicitação pull, marque 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 padrão para futuras RPs.

Caixa de diálogo de conclusão da solicitação pull, Concluir itens de trabalho associados após a fusão

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á no estado Resolvido: O item de trabalho, cujo WIT usa o modelo de processo de Herança, já está no estado Resolvido . Neste 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 o fará a transição para Fechado.
  • Item de trabalho já concluído: O item de trabalho já está na categoria Estado concluído . Não é necessária qualquer outra transição.
  • As 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 implementações on-premises e Azure Boards modelo de processo alojado, deve modificar o fluxo de trabalho para especificar ações (elemento ACTION) a ocorrer durante a transição do fluxo. Para obter mais informações, consulte Alterar o fluxo de trabalho para 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 pull. Prefixe o #ID com um estado de fluxo de trabalho válido para o item de trabalho mencionado. Essa abordagem oferece controle preciso sobre como os itens de trabalho transitam quando você mescla alterações de código.

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

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

Sintaxe para transições de estado

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

  • Resolves #123 - O item de trabalho 123 é transicionado para o estado Resolvido
  • Fixes #456 - Muda o item de trabalho 456 para o estado apropriado de concluído
  • Closes #789 - Transiciona o item de trabalho 789 para estado Fechado
  • Review #101 - Transições do item de trabalho 101 para o estado de revisão

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

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

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

  1. Navegue até Configurações do> projetoRepositórios,> selecione seu repositório.
  2. Na guia Configurações, desative o interruptor para Resolução de itens de trabalho mencionados em confirmações.

Quando você desabilita essa configuração, o sistema não permite menções em comentários de confirmação para fechar itens de trabalho (por exemplo, "Correções #123"). Essa configuração afeta a conclusão da solicitação pull e as menções de confirmação direta.

Melhores práticas

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

  • Revisar 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 do 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 pull em vez de confiar no 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: certifique-se de que todos os membros da equipe entendam como a conclusão automática afeta o rastreamento de itens de trabalho.

Soluçã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. Revisar regras de fluxo de trabalho: certifique-se de que nenhuma regra de campo de fluxo de trabalho impeça a transição de estado.
  3. Validar links de Itens de Trabalho: Confirme se os itens de trabalho estão corretamente ligados ao pull request.
  4. Verifique o estado atual: verifique se o item de trabalho ainda não está em um estado concluído.
  5. Revise as configurações do repositório: verifique se a conclusão automática está ativada nas configurações do repositório.

Use IA para gerir itens de trabalho ligados a pull requests

Se configurar o Azure DevOps MCP Server, pode consultar e gerir itens de trabalho ligados a pull requests usando linguagem natural.

Tarefa Exemplo de prompt
Encontre itens ligados Show all work items linked to open pull requests in project <Contoso>
Verificar o estado da 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>
Itens ligados ao PR de auditoria Show all pull requests merged this sprint with their linked work items for <Contoso>
Encontrar itens sem ligações de PageRank List all completed user stories in Sprint 12 that have no linked pull request in project <Contoso>
Detetar ligações de relações públicas obsoletas Find work items linked to pull requests that were abandoned or closed without merging in <Contoso>
Verificar que o auto-preenchimento 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 relações públicas por designado For each team member on <Contoso Team>, list their work items that have linked PRs currently in review
Encontre itens com múltiplos PRs Show work items in project <Contoso> that are linked to more than one pull request
Relatório de cobertura PR da Sprint What percentage of completed work items in Sprint 12 have at least one linked pull request in <Contoso>?

Observação

Se estiver a usar o Visual Studio Code, o modo agente é especialmente útil para gerir relações entre itens de trabalho e pull requests.

Conteúdo relacionado

  • Last updated on