Partilhar via

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

Serviços de DevOps do Azure | 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.

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: Visualizar itens de trabalho neste nó e Editar itens de trabalho neste nó com 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: Permissão de nível de projeto Criar nova definição de tag 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 solicitações pull: Pelo menos acesso Basic.
- Para visualizar ou acompanhar itens de trabalho: Pelo menos acesso de Stakeholder. Para obter mais informações, consulte Sobre 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 de 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 executadas durante a transição do fluxo de trabalho. 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.

Conteúdo relacionado

  • Last updated on