Share via


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

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

Zodra u uw Azure Boards-project hebt verbonden met een GitHub-opslagplaats, kunt u werkitems koppelen aan uw GitHub-doorvoeringen en pull-aanvragen. U kunt koppelingen toevoegen met behulp van de #mention syntaxis die bekend is met GitHub-gebruikers of u kunt een GitHub-doorvoer of een koppelingstype voor GitHub-pull-aanvragen toevoegen vanuit het Azure Boards-werkitem.

Notitie

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

Vereisten

  • Uw Azure Boards-project moet zijn verbonden met de GitHub-opslagplaats waar de doorvoer- en pull-aanvragen die u wilt koppelen aan/van bestaan. Zie Azure Boards-GitHub-integratie voor meer informatie.
  • U moet een inzender zijn voor het Azure Boards-project en in 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 (geen opmerking).

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, fixes, fixed en past dit 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 deze over naar de status die is gekoppeld aan de status Voltooide werkstroomcategorie. Als u wilt weten hoe werkstroomstatussen en categoriestatussen worden toegewezen, raadpleegt u Hoe werkstroomcategoriestatussen worden gebruikt in achterstanden en borden van Azure Boards.

Zie 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 KOPPELING van AB# -vermeldingen. 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.

Notitie

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

  1. Als u een koppeling wilt maken naar een doorvoer- of pull-aanvraag, opent u het werkitem en kiest u Koppeling toevoegen onder de sectie Ontwikkeling.

    Screenshot of work item form, Development section, Add link option.

    Als u een koppeling naar een probleem wilt maken, kiest u het tabblad Koppelingen en kiest u Bestaand item toevoegen>.

    Screenshot of work item form, Links tab, Add link to issue.

  2. Selecteer in het dialoogvenster Koppeling toevoegen een van de GitHub-koppelingstypen, voer de URL in naar de doorvoer, pull-aanvraag of het probleem en kies VERVOLGENS OK.
    Hier voegen we een koppeling toe naar een GitHub-pull-aanvraag.

    Screenshot of work item form, Links tab, Add link dialog, GitHub pull request link type selected.

    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.

    Hier voegen we een koppeling toe naar een GitHub-probleem.

    Screenshot of work item form, Links tab, Add link dialog, GitHub issue link type selected.

Notitie

Er is een vertraging bij het voltooien van de AB#-koppelingen als u Azure DevOps Sever 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.

Screenshot of work item form, Development section shows GitHub links.

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

GitHub-objecten weergeven op kanbanbord

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

Screenshot of Kanban board that shows GitHub links on work item cards.

Notitie

GitHub-aantekeningen vereisen Azure DevOps Server 2019 Update 1 of hoger.

Volgende stappen