Länka GitHub-incheckningar, pull-begäranden och problem till arbetsobjekt i Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

När du har anslutit ditt Azure Boards-projekt till en GitHub-lagringsplats kan du länka arbetsobjekt till dina GitHub-incheckningar och pull-begäranden. Du kan lägga till länkar med hjälp av den #mention syntax som är bekant för GitHub-användare eller så kan du lägga till en GitHub-inchecknings- eller GitHub-länktyp för pull-begäran från Azure Boards-arbetsobjektet.

Kommentar

Med Azure Boards-appen för GitHub stöder Azure Boards och Azure DevOps Services integrering med GitHub.com- och GitHub Enterprise Server-lagringsplatser. Azure DevOps Servers 2019 och senare versioner stöder endast integrering med GitHub Enterprise Server-lagringsplatser. Integrering med andra Git-lagringsplatser stöds inte.

Förutsättningar

• Ditt Azure Boards-projekt måste vara anslutet till GitHub-lagringsplatsen där de incheckningar och pull-begäranden som du vill länka till/från finns. Mer information finns i Azure Boards-GitHub-integrering.
• Du måste vara deltagare i Azure Boards-projektet och till GitHub-lagringsplatsen.

Kommentar

Projekt som använder den värdbaserade XML-processmodellen kräver uppdateringar av arbetsobjekttyperna för att visa avsnittet Utveckling och GitHub-länktyper. Mer information finns i Uppdatera XML-definitioner för utvalda typer av arbetsobjekt.

Använd AB# för att länka från GitHub till Azure Boards-arbetsobjekt

Från en GitHub-incheckning, pull-begäran eller ett problem använder du följande syntax för att skapa en länk till ditt Azure Boards-arbetsobjekt. AB#ID Ange i texten i ett incheckningsmeddelande. Eller för en pull-begäran eller ett problem anger du AB#ID i rubriken eller beskrivningen (inte en kommentar).

AB#{ID}

Till exempel AB#125 länkar till arbetsobjekts-ID 125.

Du kan också ange ett inchecknings- eller pull-begärandemeddelande för att överföra arbetsobjektet. Systemet identifierar fix, fixes, fixed och tillämpar det på det #-mention-objekt som följer. Nämnda arbetsobjekt övergår till det första tillstånd som är associerat med kategoritillståndet Löst arbetsflöde. Om det inte finns något tillstånd som är associerat med Löst övergår det till det tillstånd som är associerat med kategoritillståndet Slutfört arbetsflöde. Information om hur arbetsflödestillstånd och kategoritillstånd mappas finns i How workflow category states are used in Azure Boards backlogs and boards .How workflow category states are used in Azure Boards backlogs and boards (Hur arbetsflödeskategoritillstånd används i Azure Boards-kvarvarande uppgifter och tavlor).

Se följande tabell med exempel.

Meddelande om inchecknings- eller pull-begäran	Åtgärd
Fixed AB#123	Länkar och övergår arbetsobjektet till kategorin Löst arbetsflödestillstånd eller, om inget har definierats, kategorin Status för slutfört arbetsflöde.
Adds a new feature, fixes AB#123.	Länkar och övergår arbetsobjektet till kategorin Löst arbetsflödestillstånd eller, om inget har definierats, kategorin Status för slutfört arbetsflöde.
Fixes AB#123, AB#124, and AB#126	Länkar till Arbetsobjekten 123, 124 och 126 i Azure Boards. Övergår endast det första objektet, 123 till kategorin Löst arbetsflödestillstånd eller, om inget har definierats, sedan kategorin Slutfört arbetsflödestillstånd .
Fixes AB#123, Fixes AB#124, Fixes AB#125	Länkar till Arbetsobjekten 123, 124 och 126 i Azure Boards. Övergår alla objekt till antingen kategorin Löst arbetsflödestillstånd eller, om inget har definierats, statuskategorin Slutfört arbetsflöde.
Fixing multiple bugs: issue #123 and user story AB#234	Länkar till GitHub-ärende 123 och Azure Boards-arbetsobjekt 234. Inga övergångar görs.

Kommentar

Om du har anslutit samma GitHub-lagringsplats till projekt som definierats i två eller flera Azure DevOps-organisationer kan du se en oväntad AB#- omnämnandelänk. Mer information finns i Lösa anslutningsproblem. Därför rekommenderar vi att du endast ansluter en GitHub-lagringsplats till projekt som definierats i en enda Azure DevOps-organisation.

Lägga till en länk från ett arbetsobjekt till en GitHub-incheckning, pull-begäran eller ett problem

1. Om du vill länka till en inchecknings- eller pull-begäran öppnar du arbetsobjektet och väljer Lägg till länk under avsnittet Utveckling.

   

   Om du vill länka till ett problem väljer du fliken Länkar och väljer sedan Lägg till länk>befintligt objekt.

   

2. I dialogrutan Lägg till länk väljer du någon av GitHub-länktyperna, anger URL:en till incheckningen, pull-begäran eller problemet och väljer sedan OK.
   Här lägger vi till en länk till en GitHub-pull-begäran.

   

   Azure Boards slutför en kontroll för att se till att du har angett en giltig länk. Den länkade GitHub-lagringsplatsen måste vara ansluten till Azure Boards-projektet eller så misslyckas verifieringen.

   Här lägger vi till en länk till ett GitHub-problem.

   

Visa eller öppna länkar från avsnittet Utveckling

I avsnittet Utveckling i arbetsobjektformuläret visas länkarna som skapats till GitHub-incheckningar och pull-begäranden med GitHub-ikonen.

Välj länken som tillhandahålls för att öppna inchecknings- eller pull-begäran i GitHub.

Visa GitHub-objekt på Kanban-tavlan

Med GitHub-anteckningar aktiverade på Kanban-tavlan kan du snabbt öppna länkade GitHub-incheckningar, pull-begäranden eller problem för mer information. Mer information finns i Anpassa kort.

Nästa steg

Konfigurera statusmärken

Relaterade artiklar

• Lägga till eller ta bort lagringsplatser
• Ändra åtkomst till GitHub-lagringsplats
• Azure Boards-GitHub-integrering
• Så här används arbetsflödeskategoritillstånd i Azure Boards kvarvarande uppgifter och anslagstavlor
• Länka arbetsobjekt till objekt
• Felsöka Integrering av GitHub och Azure Boards