Delen via

GitHub-commits, pull-aanvragen, branches en issues koppelen aan werkitems in Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

In dit artikel leert u hoe u, nadat u uw Azure Boards-project hebt verbonden met een GitHub-opslagplaats, werkitems kunt koppelen aan GitHub commits, pull requests en branches. U kunt de syntaxis van de #mention voor doorvoeringen en vertakkingen gebruiken of rechtstreeks vanuit het Azure Boards-werkitem een GitHub-doorvoer, pull-aanvraag of vertakkingskoppeling toevoegen.

Note

Ondersteuning voor GitHub-integratie:

  • Azure DevOps Services: integreert met zowel GitHub.com als GitHub Enterprise Server-opslagplaatsen via de Azure Boards-app voor GitHub.
  • Azure DevOps Server 2020 en hoger: ondersteunt alleen integratie met GitHub Enterprise Server-opslagplaatsen.
  • Andere Git-opslagplaatsen: Integratie wordt niet ondersteund.

Prerequisites

Category Requirements
Permissions Inzender voor zowel het Azure Boards-project als de GitHub-opslagplaats.
Projectverbinding Het Azure Boards-project is verbonden met de GitHub-opslagplaats waar de commits, pull-aanvragen en vertakkingen zijn waarnaar u een koppeling wilt maken of van waaruit u een koppeling wilt maken. Zie Azure Boards-GitHub-integratie voor meer informatie.

Note

Voor projecten die gebruikmaken van het model voor het gehoste XML-proces, moeten updates worden uitgevoerd voor de typen werkitems om de sectie Ontwikkeling en GitHub-koppelingstypen weer te geven. Zie XML-definities bijwerken voor geselecteerde typen werkitems voor meer informatie.

Gebruik vanuit een GitHub-doorvoer, pull-aanvraag of -probleem de volgende syntaxis om een koppeling naar uw Azure Boards-werkitem te maken. Voer de AB#ID tekst van een doorvoerbericht in. Of voer voor een pull-verzoek of probleem de AB#ID in de titel of beschrijving in. Wanneer u AB#ID in een opmerking gebruikt, wordt er geen koppeling gemaakt voor het werkitem.

AB#{ID}

Bijvoorbeeld AB#125 koppelingen naar werkitem-id 125.

U kunt ook een doorvoer- of pull-aanvraagbericht invoeren om het werkitem over te zetten. Het systeem herkent {state} of {state category}, samen met fix, fixes, en fixed, en past dit toe op het item met #-vermelding dat volgt.

Wanneer een beschrijving van een pull-aanvraag bijvoorbeeld een geldige statusnaam bevat, Closed AB#1234wordt het werkitem waarnaar wordt verwezen bijgewerkt naar die specifieke status. Als de statusnaam niet rechtstreeks wordt herkend, probeert Azure Boards deze te koppelen aan een werkstroomcategorie zoals Resolved of Completed. Als er een overeenkomst wordt gevonden, wordt het werkitem overgezet naar de eerste beschikbare status die onder die categorie is gedefinieerd.

Standaard gaan werkitems waarnaar wordt verwezen met fix, fixes of fixed over naar de eerste status die is gekoppeld aan de categorie Opgelost. Als er geen dergelijke status bestaat in het huidige proces, wordt het werkitem in plaats daarvan overgestapt op de eerste status in de categorie Voltooid .

Important

U kunt nog steeds werkitems koppelen en andere vertakkingen toepassen, maar regels voor statusovergang zijn niet van toepassing, tenzij de pull-aanvraag wordt samengevoegd in de standaardbranch.

Voor meer informatie, zie Hoe werkstroomcategoriestatussen worden gebruikt in backlogs en borden in Azure Boards.

Bekijk de volgende tabel met voorbeelden:

Bericht over doorvoeren of pull-aanvragen Action
Fixed AB#123 Hiermee wordt het werkitem gekoppeld aan de categorie Opgeloste werkstroomstatus of, als er geen is gedefinieerd, de categorie Voltooide werkstroomstatus.
Closed AB#123 Hiermee koppelt u het werkitem aan de werkstroomstatus Gesloten en zet het over naar die status. Als er geen overgang is gedefinieerd, zijn er geen overgangen mogelijk.
Adds a new feature, fixes AB#123. Hiermee wordt het werkitem gekoppeld aan de categorie Opgeloste werkstroomstatus of, als er geen is gedefinieerd, de categorie Voltooide werkstroomstatus.
Fixes AB#123, AB#124, and AB#126 Koppelingen naar Azure Boards werkitems 123, 124 en 126. Hiermee zet u alleen het eerste item, 123 over naar de categorie Opgeloste werkstroomstatus of, als er geen is gedefinieerd, dan de categorie Voltooide werkstroomstatus.
Fixes AB#123, Fixes AB#124, Fixes AB#125 Koppelingen naar Azure Boards werkitems 123, 124 en 126. Hiermee zet u alle items over naar de categorie Opgeloste werkstroomstatus of, als er geen is gedefinieerd, de categorie Voltooide werkstroomstatus.
Fixing multiple bugs: issue #123 and user story AB#234 Koppelingen naar GitHub-probleem 123 en Azure Boards werkitem 234. Er worden geen overgangen gemaakt.

Note

Als u dezelfde GitHub-opslagplaats hebt verbonden met projecten die zijn gedefinieerd in twee of meer Azure DevOps-organisaties, ziet u mogelijk onverwachte AB# -vermeldingskoppelingen. Zie Verbindingsproblemen oplossen voor meer informatie. Daarom raden we u aan alleen een GitHub-opslagplaats te verbinden met projecten die zijn gedefinieerd in één Azure DevOps-organisatie.

Wanneer u een koppeling naar een werkitem toevoegt met ab#, worden deze koppelingen weergegeven in de sectie Ontwikkeling van de pull-aanvraag.

Schermopname van AB#-koppelingen in de ontwikkelsectie van een GitHub-pull-aanvraag.

GitHub-vertakking maken van werkitem

Als u rechtstreeks vanuit een werkitem een GitHub-vertakking wilt maken, voert u de volgende stappen uit:

  1. Zoek op uw bord het werkitem van waaruit u een GitHub-vertakking wilt maken.

  2. Selecteer Werkitemacties>Nieuwe GitHub-vertakking.

    Schermopname van werkitem Meer acties en gemarkeerde optie voor nieuwe GitHub-branch.

  3. Voer in het dialoogvenster Een GitHub-vertakking maken de naam van de vertakking in en selecteer de GitHub-opslagplaats en de basisbranch.

  4. Klik op Creëren.

    Schermopname van het dialoogvenster Een GitHub Branch maken.

    Azure Boards maakt de vertakking in de opgegeven GitHub-opslagplaats en koppelt deze aan het werkitem. Zie Azure Boards-GitHub-integratie voor meer informatie.

  1. Open het werkitem en ga naar het tabblad Koppelingen .

    Schermopname van het werkitemformulier, tabblad Koppelingen, Koppeling toevoegen aan probleem.

  2. Selecteer in het dialoogvenster Koppeling toevoegen een van de GitHub-koppelingstypen , selecteer een GitHub-opslagplaats, voer de URL in naar de GitHub-vertakking, doorvoer of pull-aanvraag en selecteer vervolgens Koppeling toevoegen.

    In het volgende voorbeeld voegen we een koppeling toe naar een GitHub-pull-aanvraag.

    Schermopname van het werkitemformulier, het tabblad Koppelingen, het dialoogvenster Koppeling toevoegen, het type koppeling voor pull-aanvraag van GitHub geselecteerd.

    Azure Boards voltooit een controle om ervoor te zorgen dat u een geldige koppeling hebt ingevoerd. De gekoppelde GitHub-opslagplaats moet zijn verbonden met het Azure Boards-project of de validatie mislukt.

Note

Er is een vertraging bij het voltooien van de AB#-koppelingen als u Azure DevOps Server en GitHub Enterprise Server gebruikt. Wij hebben een push-and-pull-ontwerp om elk uur gegevens van de GitHub-gebeurtenissen op te halen over de incrementele wijzigingen in commits, pull-aanvragen en issues.

Verschillende gebeurtenissen werken de koppelingen in het werkitemformulier automatisch bij, zodat u ze niet handmatig hoeft te maken. Deze omvatten:

GitHub-gebeurtenis Action
Koppeling naar branch Wanneer een pull-aanvraag wordt gemaakt vanuit een vertakking, wordt deze automatisch gekoppeld aan het werkitem.
Doorvoer samenvoegen Nadat de pull-aanvraag is samengevoegd, wordt de resulterende samenvoegdoorvoering automatisch gekoppeld aan het werkitem.
Branch verwijderen Als de vertakking wordt verwijderd (meestal na samenvoegen), wordt de koppeling automatisch verwijderd uit het werkitem.

De sectie Ontwikkeling in het werkitemformulier vermeldt de koppelingen die zijn gemaakt naar GitHub-commits en pull-aanvragen met het GitHub-pictogram.

Schermopname van het werkitemformulier, de sectie Ontwikkeling toont GitHub-koppelingen.

Kies de koppeling die is opgegeven om de doorvoer- of pull-aanvraag in GitHub te openen.

GitHub-objecten op een bord weergeven

Als GitHub-aantekeningen zijn ingeschakeld op het bord, kunt u snel gekoppelde GitHub-commits, pull-aanvragen of issues openen voor meer informatie. Zie Kaarten aanpassen voor meer informatie.

Schermopname van bord met GitHub-koppelingen op werkitemkaarten.

Volgende stappen

Statusbadges configureren

Verwante inhoud