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
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: é preciso pelo menos acesso de 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.
- Por padrão, todos os Colaboradores e Stakeholders em projetos públicos podem adicionar etiquetas novas e existentes. Em projetos privados, os stakeholders só podem adicionar tags existentes. Para controlar a capacidade de criar novas tags, defina a permissão Criar definição de tag no nível do projeto. Para obter mais informações, consulte Alterar permissões no nível do projeto.
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.
- 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.