Vincular confirmações, solicitações pull e problemas do GitHub a itens de trabalho nos Painéis do Azure

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Depois de conectar seu projeto do Azure Boards a um repositório do GitHub, você pode vincular itens de trabalho às suas confirmações e solicitações pull do GitHub. Você pode adicionar links usando a sintaxe #mention familiar aos usuários do GitHub ou pode adicionar um tipo de link de confirmação do GitHub ou solicitação pull do GitHub no item de trabalho Painéis do Azure.

Nota

Com a aplicação Azure Boards para GitHub, os Azure Boards e os Azure DevOps Services suportam a integração com os repositórios GitHub.com e GitHub Enterprise Server. Os Servidores de DevOps do Azure 2019 e versões posteriores suportam apenas a integração com repositórios do GitHub Enterprise Server. A integração com outros repositórios Git não é suportada.

Pré-requisitos

• Seu projeto do Azure Boards deve estar conectado ao repositório GitHub onde existem as solicitações de confirmação e pull que você deseja vincular/de. Para obter mais informações, consulte Integração Azure Boards-GitHub.
• Você deve ser um Colaborador do projeto Azure Boards e do repositório GitHub.

Nota

Projetos que usam o modelo de processo XML hospedado exigem atualizações para os tipos de item de trabalho para exibir a seção Desenvolvimento e os tipos de link do GitHub. Para obter mais informações, consulte Atualizar definições XML para tipos de item de trabalho selecionados.

Use AB# para vincular itens de trabalho do GitHub aos Quadros do Azure

A partir de uma confirmação, solicitação pull ou problema do GitHub, use a sintaxe a seguir para criar um link para seu item de trabalho do Azure Boards. Insira o AB#ID texto dentro do texto de uma mensagem de confirmação. Ou, para uma solicitação pull ou problema, insira o AB#ID dentro do título ou descrição (não um comentário).

AB#{ID}

Por exemplo, AB#125 links para o item de trabalho ID 125.

Você também pode inserir uma mensagem de confirmação ou solicitação pull para fazer a transição do item de trabalho. O sistema reconhece fix, fixes, fixed e aplica-o ao item #-mention que se segue. Os itens de trabalho mencionados transitam para o primeiro Estado associado ao estado da categoria de fluxo de trabalho Resolvido . Se não houver nenhum Estado associado a Resolvido, ele fará a transição para o Estado associado ao estado da categoria de fluxo de trabalho Concluído. Para entender como os estados de fluxo de trabalho e os estados de categoria são mapeados, consulte Como os estados de categoria de fluxo de trabalho são usados em listas de pendências e quadros do Azure Boards.

Veja a tabela de exemplos a seguir.

Mensagem de solicitação de confirmação ou pull	Ação
Fixed AB#123	Vincula e faz a transição do item de trabalho para a categoria Estado do fluxo de trabalho Resolvido ou, se nenhum estiver definido, para a categoria Estado do fluxo de trabalho Concluído.
Adds a new feature, fixes AB#123.	Vincula e faz a transição do item de trabalho para a categoria Estado do fluxo de trabalho Resolvido ou, se nenhum estiver definido, para a categoria Estado do fluxo de trabalho Concluído.
Fixes AB#123, AB#124, and AB#126	Links para os itens de trabalho 123, 124 e 126 dos Painéis do Azure. Transiciona apenas o primeiro item, 123 para a categoria Estado do fluxo de trabalho Resolvido ou, se nenhum estiver definido, a categoria Estado do fluxo de trabalho Concluído .
Fixes AB#123, Fixes AB#124, Fixes AB#125	Links para os itens de trabalho 123, 124 e 126 dos Painéis do Azure. Transiciona todos os itens para a categoria Estado do fluxo de trabalho Resolvido ou, se nenhum estiver definido, para a categoria Estado do fluxo de trabalho Concluído.
Fixing multiple bugs: issue #123 and user story AB#234	Links para a edição 123 do GitHub e o item de trabalho 234 dos Quadros do Azure. Nenhuma transição é feita.

Nota

Se você conectou o mesmo repositório GitHub a projetos definidos em duas ou mais organizações do Azure DevOps, poderá ver uma vinculação inesperada de menção AB# . Para obter mais informações, consulte Resolver problemas de conexão. Por esse motivo, recomendamos que você conecte apenas um repositório GitHub a projetos definidos em uma única organização do Azure DevOps.

Adicionar link de um item de trabalho a uma confirmação, solicitação pull ou problema do GitHub

1. Para vincular a uma solicitação de confirmação ou pull, abra o item de trabalho e escolha Adicionar link na seção Desenvolvimento.

   

   Para vincular a um problema, escolha a guia Links e, em seguida, escolha Adicionar>item Link Existente.

   

2. Na caixa de diálogo Adicionar link, selecione um dos tipos de link do GitHub, insira a URL para a confirmação, solicitação pull ou problema e escolha OK.
   Aqui, adicionamos um link para uma solicitação pull do GitHub.

   

   Os Painéis do Azure concluem uma verificação para garantir que você inseriu um link válido. O repositório GitHub vinculado deve estar conectado ao projeto Azure Boards ou a validação falhará.

   Aqui, adicionamos um link para um problema do GitHub.

   

Exibir ou abrir links na seção Desenvolvimento

A seção Desenvolvimento dentro do formulário de item de trabalho lista os links criados para confirmações e solicitações pull do GitHub com o ícone do GitHub.

Escolha o link fornecido para abrir a solicitação commit ou pull no GitHub.

Visualizar objetos do GitHub no quadro Kanban

Com as anotações do GitHub ativadas no quadro Kanban, você pode abrir rapidamente confirmações vinculadas do GitHub, solicitações pull ou problemas para obter mais detalhes. Para obter mais informações, consulte Personalizar cartões.

Próximos passos

Configurar selos de status

Artigos relacionados

• Adicionar ou remover repositórios
• Alterar o acesso ao repositório GitHub
• Integração Azure Boards-GitHub
• Como os estados de categoria de fluxo de trabalho são usados em listas de pendências e quadros do Azure Boards
• Vincular itens de trabalho a objetos
• Solucionar problemas de integração do GitHub & Azure Boards