Conclusão automática de itens de trabalho com PR (solicitações de pull)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Ao vincular um item de trabalho a uma PR, você pode concluir automaticamente esses itens de trabalho ao concluir a PR. Ou você pode especificar o estado do fluxo de trabalho para o qual fazer a transição do item de trabalho ao mesclar a PR.
Ao vincular um item de trabalho a uma PR, você pode concluir automaticamente esses itens de trabalho ao concluir a PR.
Para saber mais, consulte Criar, exibir e gerenciar solicitações de pull.
Pré-requisitos
Acesso ao projeto: seja um membro do projeto.
Permissões:
- Para exibir, seguir e editar itens de trabalho, defina as permissões Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó 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 marcas a itens de trabalho, defina a permissão Criar nova definição de marca no nível do projeto como Permitir. Por padrão, o grupo Colaboradores tem essa permissão.
Níveis de acesso:
- Para adicionar novas marcas a itens de trabalho ou para exibir ou seguir solicitações de pull, tenha pelo menos acesso básico .
- Para exibir ou seguir itens de trabalho, tenha pelo menos acesso ao Stakeholder . Saiba mais em Sobre nível de acesso.
- Todos os membros do projeto, incluindo os do grupo Leitores , podem enviar emails contendo itens de trabalho.
Observação
- Forneça acesso das partes interessadas aos membros que desejam contribuir para a discussão e revisar o progresso. Normalmente, eles são membros que não contribuem para o código, mas querem exibir itens de trabalho, listas de pendências, quadros e painéis.
- As partes interessadas não podem adicionar novas tags, mesmo que a permissão seja definida explicitamente, devido ao seu nível de acesso. Para mais informações, veja Referência rápida de acesso das partes interessadas.
- Permissões do GitHub: seja um colaborador do repositório do GitHub.
Conclusão automática de itens de trabalho
Conforme mostrado na imagem a seguir, marque a caixa para Concluir itens de trabalho vinculados após a mesclagem. O sistema usa sua seleção como padrão para PRs futuras.
Nas seguintes circunstâncias, o sistema não atualizará automaticamente o estado do item de trabalho para as categorias Concluído, Fechado ou Concluído para o tipo de item de trabalho (WIT):
- O item de trabalho, cujo WIT é gerenciado com 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.
- O item de trabalho já está no estado Concluído. Nenhuma ação de transição é necessária.
- 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 outro campo seja definido ao fechar o item de trabalho.
- Para implantações locais e modelo de processo hospedado em 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, consulte Personalizar sua experiência de acompanhamento de trabalho.
Especificar o estado do fluxo de trabalho dos itens de trabalho vinculados
Para fazer a transição de um item de trabalho para um estado específico do fluxo de trabalho, você pode inserir 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.
Observação
Esse recurso requer o Azure DevOps Server 2020.1 ou versão posterior.
O exemplo a seguir mostra histórias de usuários que fizeram a transição uma para o estado Resolvido e a outra para o estado Revisar. Além disso, duas tarefas são marcadas como Concluídas.
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:
- Vá para Configurações do projeto>Repositórios> selecione o repositório.
- Na guia Configuração mova a alternância para Desativado para Resolução de itens de trabalho de menções a commits.
Menções em comentários de confirmação para fechar itens de trabalho (por exemplo, "Correções #123") não são permitidas.