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

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

In dit artikel leert u hoe u werkitems koppelt aan GitHub-commits, pullaanvragen, branches en builds nadat u uw Azure Boards-project hebt gekoppeld aan een GitHub-repository. Gebruik #mention syntaxis voor doorvoeringen en vertakkingen, gebruik ! vermeldingen om te verwijzen naar GitHub pull-aanvragen in werkitemdiscussies, of voeg een GitHub doorvoer-, pull-aanvraag- of vertakkingskoppeling rechtstreeks vanuit het Azure Boards werkitem toe.

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.

Tip

U kunt AI gebruiken om bij deze taak te helpen verderop in dit artikel, of zie AI-assistentie inschakelen met Azure DevOps MCP Server om te beginnen.

Prerequisites

Category Requirements
Permissions U hebt inzendertoegang tot zowel het Azure Boards-project als de GitHub opslagplaats.
Projectverbinding Verbind uw Azure Boards project met de GitHub opslagplaats die de doorvoeringen, pull-aanvragen en vertakkingen bevat die u wilt koppelen. Zie Azure Boards-GitHub integration voor meer informatie.

Note

Als uw project gebruikmaakt van het gehoste XML-procesmodel, werkt u de typen werkitems bij om de sectie Ontwikkeling en GitHub koppelingstypen weer te geven. Zie XML-definities bijwerken voor geselecteerde typen werkitems voor meer informatie.

Gebruik AB# vermeldingen in GitHub tekst om een koppeling te maken naar Azure Boards werkitems.

Ga als volgende te werk om een koppeling te maken:

  1. Toevoegen AB#{ID} aan een doorvoerbericht, beschrijving van pull-aanvraag of beschrijving van probleem.
  2. Push de doorvoer of sla de pull-aanvraag of het probleem op.
  3. Open het werkitem om te bevestigen dat de koppeling wordt weergegeven in de sectie Ontwikkeling .

Het gebruik van AB#ID in een opmerking of in de titel van een pull request maakt geen koppeling op het werkitem.

AB#{ID}

Bijvoorbeeld AB#125 koppelingen naar werkitem-id 125.

U kunt ook werkitems overzetten van doorvoer- of pull-aanvraagtekst. Azure Boards herkent {state} of {state category} en trefwoorden zoals fix, fixes en fixed, en past die overgang vervolgens toe op de volgende AB#-verwijzing.

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 van 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.

Zie Hoe werkstroomcategoriestatussen worden gebruikt in Azure Boards achterstanden en borden voor meer informatie.

Gebruik de volgende voorbeelden met alleen links:

Bericht over doorvoeren of pull-aanvragen Action
AB#123 Koppelt Azure Boards-workitem 123. Er treedt geen statusovergang op.
Adds a new feature, AB#123. Koppelt Azure Boards-werkitem 123 aan. Er treedt geen statusovergang op.
AB#123, AB#124, and AB#126 Koppelt Azure Boards-werkitems 123, 124 en 126. Er treedt geen statusovergang op.
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.

Gebruik de volgende voorbeelden van koppelingen en overgangen:

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 125. Hiermee zet u alle items over naar de categorie Opgeloste werkstroomstatus of, als er geen is gedefinieerd, de categorie Voltooide werkstroomstatus.

Note

Als u dezelfde GitHub-opslagplaats hebt verbonden met projecten die zijn gedefinieerd in twee of meer Azure DevOps-organisaties, kunnen er onverwachte koppelingen van AB#-vermeldingen zijn. 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 behulp van AB# in een beschrijving van een pull-aanvraag, worden deze koppelingen weergegeven in de sectie Ontwikkeling van de GitHub pull-aanvraag. Deze koppelingen zijn alleen beschikbaar wanneer u de beschrijving van de pull-aanvraag gebruikt AB# . Ze worden niet weergegeven als u rechtstreeks vanuit het werkitem een koppeling naar de pull-aanvraag maakt. Als u de AB# verwijzing uit de beschrijving verwijdert, wordt deze ook verwijderd uit de sectie Ontwikkeling.

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

Maak GitHub branch van werkitem

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

  1. Zoek op je bord het werkitem dat je wilt gebruiken om een GitHub branch te maken.

  2. Selecteer Werkitem-acties>Nieuwe GitHub-tak.

    Afbeelding van werkitem met Meer acties geselecteerd en de optie Nieuwe GitHub branch gemarkeerd.

  3. Voer in het dialoogvenster Maak een GitHub branch de naam van de vertakking in. 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 integration voor meer informatie.

  1. Open uw werkitem en ga naar het gebied Ontwikkeling .

  2. Selecteer Koppeling toevoegen. Selecteer in elk vervolgkeuzemenu uw linktype, GitHub opslagplaats en GitHub pull-aanvraag. U kunt in de opslagplaats zoeken en inzoomen om een specifieke pull-aanvraag of doorvoer te zoeken en te selecteren, zonder dat u een URL hoeft te kopiëren en plakken.

  3. Selecteer Koppeling toevoegen.

    Schermopname van een reeks van vijf stappen voor het toevoegen van een koppeling naar een pull-aanvraag aan een werkitem.

    Azure Boards controleert of u een geldige koppeling hebt ingevoerd. De gekoppelde naar GitHub opslagplaats must verbonden te zijn met het Azure Boards project of de validatie mislukt.

Note

Als u Azure DevOps Server en GitHub Enterprise Server gebruikt, bestaat er een vertraging bij het voltooien van de AB#-koppelingen. Het proces maakt gebruik van een push-and-pull-ontwerp om elk uur de incrementele wijzigingen in commits, pull requests en issues op te halen uit de GitHub-gebeurtenissen.

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

GitHub gebeurtenis Action
Koppeling naar vertakking 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 bevat de koppelingen die zijn gemaakt met GitHub doorvoer- en pull-aanvragen met behulp van het pictogram GitHub.

Schermafbeelding van werkitemformulier, sectie Ontwikkeling bevat GitHub links.

Selecteer de koppeling om de doorvoer- of pull-aanvraag in GitHub te openen.

inzichten voor pull-aanvragen GitHub

Gekoppelde GitHub pull-aanvragen in de sectie Ontwikkeling bevatten extra statusdetails. U kunt de voortgang evalueren zonder de pull-aanvraag in GitHub te openen.

Vereisten voor inzichten voor pull-aanvragen

Als u inzichten in pull-aanvragen wilt zien, gaat u naar de Azure Boards-app in GitHub en accepteert u de bijgewerkte machtigingen voor lees- en schrijftoegang tot Controles.

Schermafbeelding van het machtigingendialoogvenster van de Azure Boards GitHub-app met de bijgewerkte Checks-machtigingen.

Details van de status van de pull-aanvraag weergeven

  1. Open een werkitem met een gekoppelde GitHub pull-aanvraag.

  2. Zoek in de sectie Ontwikkeling de gekoppelde pull-aanvraag. De volgende statusdetails worden weergegeven naast de koppeling naar de pull-aanvraag:

    • Conceptstatus: Geeft aan of de pull-aanvraag nog steeds een concept is.
    • Beoordelingsstatus: Geeft aan of de pull-aanvraag moet worden gecontroleerd, goedgekeurd of dat er wijzigingen zijn aangevraagd.
    • Controleert status: Geeft aan of CI-controles slagen, mislukken of in afwachting zijn.

    Schermafbeelding van de sectie Ontwikkeling met een gekoppelde GitHub pull request en statusdetails voor gesloten, in beoordeling en controles.

  3. Beweeg de muisaanwijzer over een statusindicator om meer details weer te geven of selecteer de koppeling voor de pull-aanvraag om deze rechtstreeks in GitHub te openen.

Vermeld GitHub pull-aanvragen met behulp van !

Gebruik ! vermelding om te verwijzen naar en GitHub pull requests rechtstreeks vanuit een tekstveld of commentaar bij een werkitem te bespreken. Wanneer u ! in een tekstveld typt, wordt er een kiezer weergegeven die u kunt gebruiken om een GitHub pull-aanvraag uit een verbonden opslagplaats te zoeken en te selecteren. De geselecteerde pull-aanvraag wordt ingevoegd als een klikbare koppeling.

Met deze functie kunt u eenvoudig verwijzen naar gerelateerde pull-aanvragen in werkitembeschrijvingen, acceptatiecriteria of discussiethreads zonder url's handmatig te kopiëren.

Gif die laat zien hoe u de ! vermelding kunt gebruiken om te verwijzen naar een GitHub pull request vanuit een werkitemdiscussie.

Buildstatus voor YAML-pijplijnen weergeven (geïntegreerd in buildproces)

Wanneer u Azure-pipelines YAML gebruikt om code te bouwen die wordt gehost in een GitHub-opslagplaats, kunt u automatisch Integrated in build-koppelingen maken op gekoppelde werkitems. Deze functie biedt traceerbaarheid voor GitHub opslagplaatsen, waardoor pariteit wordt bereikt met de ervaring die beschikbaar is voor Azure-opslagplaatsen.

Ga als volgt te werk om deze functie in te schakelen:

  1. Open uw YAML-pijplijn, selecteer Meer acties en selecteer vervolgens Instellingen.

  2. Schakel in het dialoogvenster Pijplijninstellingen de optie Automatisch nieuwe werkitems in deze build koppelen in.

    Schermopname van het dialoogvenster YAML Pipeline-instellingen met de optie Automatisch nieuwe werkitems koppelen in deze buildoptie.

Wanneer de build is voltooid, wordt er automatisch een koppeling geïntegreerd in de build weergegeven in de sectie Ontwikkeling van elk gekoppeld werkitem, waardoor uw team volledig traceerbaar is van werkitem tot build.

Schermopname van werkitem met de koppeling Geïntegreerd in build in de sectie Ontwikkeling.

Zie Pijplijnen configureren ter ondersteuning van werktracking voor meer informatie over het configureren van deze instelling.

GitHub objecten op een bord weergeven

Wanneer u GitHub-annotaties op het bord inschakelt, kunt u gekoppelde GitHub-commits, pull requests of issues snel openen voor meer details. Zie Kaarten aanpassen voor meer informatie.

Schermafbeelding van bord met GitHub koppelingen op werkitemkaarten.

Als u de Azure DevOps MCP-server configureert, kunt u GitHub taken voor het koppelen van werkitems in natuurlijke taal beschrijven in plaats van handmatig door het werkitemformulier te navigeren.

Gebruik deze prompts als scenariovoorbeelden. Ondersteunde bewerkingen variëren per geconfigureerde toolsets, extensieversie en uw machtigingen.

Sommige prompts kunnen richtlijnen retourneren in plaats van een schrijfactie uit te voeren, of ze vereisen mogelijk meerdere prompts, afhankelijk van de MCP-hulpprogramma's die u hebt ingeschakeld.

Voordat u een prompt uitvoert, vervangt u tijdelijke aanduidingen zoals <Contoso>, <owner/repo>en <sha> door de werkelijke waarden.

Gebruik deze snelle uitvoer- en verificatiestroom:

  1. Voer één prompt uit vanuit de tabel.
  2. Bekijk het antwoord voor de actie die is ondernomen.
  3. Open het werkitem en bevestig het resultaat in de sectie Ontwikkeling .
  4. Open het bijbehorende GitHub-artifact en bevestig de verwachte koppeling of update.

Probeer eerst deze prompts:

  • Link work item AB#125 in project <Contoso> to GitHub pull request <owner/repo>#42
  • Link work item AB#312 in project <Contoso> to GitHub commit <owner/repo>@<sha>
  • Summarize all GitHub commits and pull requests linked to work item AB#312 in project <Contoso>
Task Voorbeeldprompt
Een werkitem koppelen aan een pull-aanvraag Link work item AB#125 in project <Contoso> to GitHub pull request <owner/repo>#42
Een werkitem aan een commit koppelen Link work item AB#312 in project <Contoso> to GitHub commit <owner/repo>@<sha>
Een werkitem koppelen aan een probleem Link work item AB#500 in project <Contoso> to GitHub issue <owner/repo>#10
Een GitHub vertakking maken op basis van een werkitem Create a GitHub branch named feature/checkout for work item 500 in project <Contoso> from repo <owner/repo> base branch main
De status van het gekoppelde werkitem bijwerken na het samenvoegen van de pull request After PR <owner/repo>#42 merges, update linked work item AB#125 to Resolved
Gerelateerde werkitems bulksgewijs koppelen Link all active user stories in area path <Contoso\\Web> to GitHub PR <owner/repo>#42
Niet-gekoppelde werkitems zoeken List all closed work items in project <Contoso> from the last 30 days that have no linked GitHub pull request
Een overzicht van GitHub activiteit voor een werkitem Summarize all GitHub commits and pull requests linked to work item AB#312 in project <Contoso>
AB#-referentie toevoegen aan een pull request Suggest an AB# reference line to add to PR <owner/repo>#42 description that links to work items 125 and 126
Controleer de status van gekoppelde PR's Show the review and check status of all GitHub pull requests linked to active user stories in project <Contoso>

Note

Als u Visual Studio Code gebruikt, gebruikt u de agentmodus. voor Azure DevOps MCP-serverbewerkingen is de agentmodus vereist om toegang te krijgen tot Azure DevOps gegevens en bewerkingen uit te voeren.

Problemen met koppelen met AI oplossen

  • Als een prompt niet wordt uitgevoerd, controleert u of de agentmodus is ingeschakeld in uw AI-client.
  • Als een prompt mislukt met toegangsfouten, controleert u of uw account toegang heeft tot het Azure DevOps project en GitHub opslagplaats.
  • Als er geen koppelingen worden gemaakt, vervangt u alle tijdelijke aanduidingen (bijvoorbeeld <Contoso>, <owner/repo><sha>) door echte waarden en voert u de prompt opnieuw uit.
  • Als een bulkprompt mislukt, probeert u het eerst opnieuw met één werkitem en herhaalt u het vervolgens met een kleinere batch.
  • Als de resultaten nog steeds niet overeenkomen met de verwachtingen, controleert u het resultaat in de sectie Ontwikkeling van werkitems en in het gerelateerde GitHub artefact.

Volgende stap

Statusbadges configureren

Verwante inhoud

  • Last updated on