Delen via

GitHub-doorvoeringen, pull-aanvragen, vertakkingen en problemen koppelen aan werkitems in Azure Boards

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

Notitie

Met de Azure Boards-app voor GitHub kunnen Azure Boards en Azure DevOps Services worden geïntegreerd met GitHub.com- en GitHub Enterprise Server-opslagplaatsen. Azure DevOps Server 2019 en latere versies ondersteunen alleen integratie met GitHub Enterprise Server-opslagplaatsen. Integratie met andere Git-opslagplaatsen wordt niet ondersteund.

Vereisten

  • Projectverbinding: Zorg ervoor dat uw Azure Boards-project is verbonden met de GitHub-opslagplaats waar de doorvoeringen, pull-aanvragen en vertakkingen zijn waarnaar u een koppeling wilt maken. Zie Azure Boards-GitHub-integratie voor meer informatie.

  • Machtigingen: Wees inzender voor zowel het Azure Boards-project als de GitHub-opslagplaats.

Notitie

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-aanvraag of probleem de AB#ID titel of beschrijving in. Als AB#ID u een opmerking gebruikt, wordt er geen koppeling voor het werkitem gemaakt.

Notitie

Voor het koppelen aan GitHub-problemen is Azure DevOps Server 2019 Update 1 of hoger vereist.

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 fix, fixesen , en fixedpast het toe op het item #-vermelding dat volgt. Vermelde werkitems worden overgestapt naar de eerste status die is gekoppeld aan de status van de opgeloste werkstroomcategorie. Als er geen status is gekoppeld aan Opgelost, gaat het werkitem over naar de status die is gekoppeld aan de status Voltooide werkstroomcategorie. Zie Hoe werkstroomcategoriestatussen worden gebruikt in achterstanden en borden in Azure Boards voor meer informatie.

Bekijk de volgende tabel met voorbeelden:

Bericht over doorvoeren of pull-aanvragen Actie
Fixed AB#123 Hiermee wordt het werkitem gekoppeld aan de categorie Opgeloste werkstroomstatus of, als er geen is gedefinieerd, de categorie Voltooide werkstroomstatus.
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 werken items 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 werken items 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 werkenitem 234. Er worden geen overgangen gemaakt.

Notitie

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 de optie Meer acties selecteren en gemarkeerde nieuwe GitHub-vertakking.

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

  4. Selecteer Maken.

    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.

Notitie

Voor het koppelen aan een GitHub-probleem is Azure DevOps Server 2019 Update 1 of hoger vereist.

  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.

Notitie

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

De sectie Ontwikkeling in het werkitemformulier bevat de koppelingen die zijn gemaakt met GitHub-doorvoeringen 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-doorvoeringen, pull-aanvragen of problemen openen voor meer informatie. Zie Kaarten aanpassen voor meer informatie.

Schermopname van bord met GitHub-koppelingen op werkitemkaarten.

Volgende stappen

Statusbadges configureren