Pull-aanvragen maken

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

Visual Studio 2019 | Visual Studio 2022

Maak pull-aanvragen (PULL's) om code in een Git-opslagplaats te wijzigen, te controleren en samen te voegen. U kunt PULL's maken op basis van vertakkingen in de upstream-opslagplaats of vanuit vertakkingen in uw fork van de opslagplaats. Uw team kan de PULL's bekijken en feedback geven over wijzigingen. Revisoren kunnen de voorgestelde wijzigingen doorlopen, opmerkingen achterlaten en stemmen om de pull-aanvragen goed te keuren of af te wijzen. Afhankelijk van vertakkingsbeleid en andere vereisten moet uw pull-aanvraag mogelijk voldoen aan verschillende criteria voordat u de pull-aanvraag kunt voltooien en de wijzigingen kunt samenvoegen in de doelbranch.

Zie Pull-aanvragen voor richtlijnen en beheeroverwegingen voor pull-aanvragen.

Vereisten

• Toegang:
  • Basistoegang: Als u PULL's wilt weergeven of bekijken, moet u lid zijn van een Azure DevOps-project met ten minste basistoegang.
  • Toegang tot belanghebbenden: voor openbare projecten hebben gebruikers aan belanghebbenden volledige toegang tot Azure-opslagplaatsen.
• Machtigingen:
  • Opslagplaatsen ingeschakeld: Opslagplaatsen moeten zijn ingeschakeld voor uw project. Als de opslagplaatshub en de bijbehorende pagina's niet worden weergegeven, raadpleegt u Een Azure DevOps-service in- of uitschakelen om opslagplaatsen opnieuw in of uit te schakelen.
  • Projectlidmaatschap:
    • Als u geen project hebt, maakt u er een of meldt u zich gratis aan.
    • Als u geen projectlid bent, wordt u toegevoegd.
  • Beveiligingsgroep Lezers: Als u wilt bijdragen aan een pull-aanvraag, moet u lid zijn van de beveiligingsgroep Lezers of de bijbehorende machtigingen hebben.
  • Beveiligingsgroep inzenders: als u een pull-aanvraag wilt maken en voltooien, moet u lid zijn van de beveiligingsgroep Inzenders of de bijbehorende machtigingen hebben.
• Gereedschap:
  • Azure DevOps CLI: u kunt PULL's maken en beheren vanuit de Azure-opdrachtregelinterface (CLI) met de azure-devops extensie. Zie Aan de slag met Azure DevOps CLI voor meer informatie.
    • Cli-opdrachten voor Azure-opslagplaatsen voor pull-aanvragen worden gebruikt az repos pr.

Zie Standaardmachtigingen en vertakkingsmachtigingen voor Git voor meer informatie over machtigingen en toegangsniveaus.

Een pull-aanvraag maken

U kunt een nieuwe pull-aanvraag maken op basis van de Azure DevOps-projectwebsite, vanuit Visual Studio of vanuit de Azure DevOps CLI.

Browser

Op de Azure DevOps-projectwebsite kunt u een nieuwe pull-aanvraag maken op basis van:

• De pagina Pull-aanvragen.
• Een functievertakking die naar uw opslagplaats is gepusht.
• Een bestaande pull-aanvraag, met behulp van kersenkiezer.
• Het besturingselement Ontwikkeling in een gekoppeld Azure Boards-werkitem.

Een pull-aanvraag maken op de pagina Pull-aanvragen

U kunt pull-aanvragen maken voor elke vertakking op de pagina Pull-aanvragen van uw project op internet.

1. Selecteer op de pagina Pull-aanvragen voor opslagplaatsen>de optie Nieuwe pull-aanvraag rechtsboven.

   

2. Selecteer de vertakking met de wijzigingen en de vertakking waarnaar u de wijzigingen wilt samenvoegen, zoals de hoofdbranch.

   

3. Voer uw pull-gegevens in en maak de pull-aanvraag.

Een pull-aanvraag maken op basis van een gepushte vertakking

Nadat u een functievertakking hebt gepusht of bijgewerkt, wordt in Azure-opslagplaatsen een prompt weergegeven om een pull-aanvraag te maken.

• Op de pagina Pull-aanvragen :

  

• Op de pagina Bestanden :

  

Selecteer Een pull-aanvraag maken om naar een pagina te gaan waar u de pull-gegevens kunt invoeren en de pull-aanvraag kunt maken.

Een pull-aanvraag maken op basis van een gekoppeld werkitem

U kunt een pull-aanvraag rechtstreeks vanuit een Azure Boards-werkitem maken dat is gekoppeld aan de vertakking.

1. Open in Azure Boards, vanuit achterstanden of query's in de weergave Werk , een werkitem dat is gekoppeld aan de vertakking.

2. Selecteer een pull-aanvraag maken in het gebied Ontwikkeling van het werkitem.

   

Met de koppeling gaat u naar een pagina waar u uw pull-gegevens kunt invoeren en de pull-aanvraag kunt maken.

Visual Studio

Een pull-aanvraag maken:

1. Selecteer Vertakkingen beheren in het Git-menu.

2. Klik met de rechtermuisknop op een vertakking en selecteer Pull-aanvraag maken.

3. Bewerk de bron- en doelbranches indien nodig, voer een titel en een optionele beschrijving in en selecteer Maken.

Visual Studio 2019 versie 16.8 en nieuwere versies biedt een Git-versiebeheerervaring met behoud van de Git-gebruikersinterface van Team Explorer . Als u Team Explorer wilt gebruiken, schakelt u Extra Opties>Preview-functies>>nieuwe Git-gebruikerservaring uit in de menubalk. U kunt Git-functies van beide interfaces door elkaar oefenen.

Pull-aanvragen maken vanuit Visual Studio Team Explorer:

1. Maak verbinding met uw project vanuit Visual Studio.

2. Selecteer Teamverkenner weergeven>om Teamverkenner te openen. U kunt ook op Ctrl drukken, Ctrl\++ M.

3. Selecteer vanuit de startpagina pull-aanvragen om lijsten met pull-aanvragen weer te geven die door u zijn geopend of aan u zijn toegewezen.

4. Selecteer nieuwe pull-aanvraag in de weergave Pull-aanvragen.

   

5. Selecteer de bron- en doelbranches, voer een titel en een optionele beschrijving in en selecteer Maken.

   

6. Nadat de pull-aanvraag is gemaakt, selecteert u Openen in de browser om de nieuwe pull-aanvraag te openen in de Azure DevOps-webportal.

U kunt ook PULL-aanvragen maken vanuit de vertakkingsweergave in Team Explorer door met de rechtermuisknop op de naam van de vertakking te klikken en Pull-aanvraag maken te selecteren.

Azure DevOps CLI

Als u een nieuwe pull-aanvraag wilt maken in uw project, gebruikt u az repos pr create. Als u de pull-aanvraag wilt openen in uw browser nadat u deze hebt gemaakt, gebruikt u de --open parameter.

az repos pr create [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--open]
                   [--org]
                   [--project]
                   [--repository]
                   [--reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--subscription]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

Parameters

Parameter	Description
--auto-complete	Stel de pull-aanvraag in om automatisch te voltooien en samen te voegen in de doelbranch wanneer alle beleidsregels worden doorgegeven. Geaccepteerde waarden: false, true.
--bypass-policy	Sla alle vereiste beleidsregels over en voltooi de pull-aanvraag zodra deze is samengevoegd. Geaccepteerde waarden: false, true.
--bypass-policy-reason	Reden voor het omzeilen van vereist beleid.
--delete-source-branch	Verwijder de bronbranch nadat de pull-aanvraag is voltooid en samengevoegd in de doelbranch. Geaccepteerde waarden: false, true.
--description -d	Beschrijving van de nieuwe pull-aanvraag, waaronder Markdown. Elke waarde is een nieuwe regel. Voorbeeld: --description "First Line" "Second Line".
--detect	Organisatie automatisch detecteren. Geaccepteerde waarden: false, true.
--draft	Maak de pull-aanvraag in de conceptmodus terwijl er wordt gewerkt. Geaccepteerde waarden: false, true.
--merge-commit-message	Bericht dat wordt weergegeven wanneer u doorvoeringen samenvoegt.
--open	Open de pull-aanvraag in uw webbrowser.
--org --organization	Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.
--project -p	Naam of id van het project. U kunt het standaardproject configureren met behulp van az devops configure -d project=NAME_OR_ID. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie.
--repository -r	Naam of id van de opslagplaats om de pull-aanvraag in te maken. Vereiste parameter.
--reviewers	Aanvullende gebruikers of groepen die als revisoren moeten worden opgenomen in de nieuwe pull-aanvraag. Afstand gescheiden.
--source-branch -s	Naam van de bronbranch. Voorbeeld: "dev".
--squash	Verpletter de doorvoeringen in de bronbranch bij het samenvoegen in de doelbranch. Geaccepteerde waarden: false, true.
--subscription	Naam of id van het Azure-abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
--target-branch -t	Naam van de doelbranch. Als dit niet is opgegeven, wordt standaard de standaardbranch van de doelopslagplaats gebruikt.
--title	Titel voor de nieuwe pull-aanvraag.
--transition-work-items	Zet werkitems die zijn gekoppeld aan de pull-aanvraag over naar de volgende logische status wanneer de pull-aanvraag de status wijzigt. U kunt bijvoorbeeld actieve werkitems wijzigen in Opgelost. Geaccepteerde waarden: false, true.
--work-items	Id's van werkitems die u wilt koppelen aan de nieuwe pull-aanvraag. Afstand gescheiden.

Opmerking

Met de volgende opdracht maakt u een pull-aanvraag van de new vertakking naar de standaardbranch main van de Fabrikam-opslagplaats, opent u de pull-aanvraag in de browser en ziet u de uitvoer van de opdracht in een tabel. In het voorbeeld wordt de standaardconfiguratie gebruikt: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos pr create --repository Fabrikam --source-branch new --open --output table

ID    Created     Creator              Title                         Status    IsDraft    Repository
----  ----------  -------------------  ----------------------------  --------  ---------  ------------
30    2021-10-31  jamalh@fabrikam.com  Updated note-new-git-tool.md  Active    False      Fabrikam

U kunt veel andere pr-gegevens toevoegen aan of na het maken van een pull-aanvraag. Zie Details toevoegen of PULL's bewerken om details, revisoren, werkitems en voltooiingsopties toe te voegen aan de pull-aanvraag.

Updates toevoegen met cherry-pick

U kunt doorvoeringen van de ene vertakking naar de andere kopiëren met behulp van cherry-pick. In tegenstelling tot een samenvoeging of herbasis brengt kersenkie alleen de wijzigingen van de doorvoeringen die u selecteert, in plaats van alle wijzigingen in een vertakking.

Als u wijzigingen in een voltooide pull-aanvraag wilt kiezen, selecteert u Cherry-pick op de overzichtspagina van de pull-aanvraag. Als u wijzigingen uit een actieve pull-aanvraag wilt kopiëren, selecteert u Cherry-pick in het menu Meer opties van pr. Met deze actie maakt u een nieuwe vertakking met de gekopieerde wijzigingen. Vervolgens kunt u een nieuwe pull-aanvraag maken vanuit de nieuwe vertakking. Zie Wijzigingen kopiëren met cherry-pick voor gedetailleerde instructies.

Bron- en doelbranches van uw pull-aanvraag overschakelen

Voordat u een pull-aanvraag voor het eerst opslaat, kunt u de bron- en doelvertakkingen van de pull-aanvraag wijzigen door het pictogram Bron- en doelvertakkingen naast de namen van de vertakkingen te selecteren. Zodra de pull-aanvraag actief is, gaat dit pictogram weg, maar u kunt de doelbranch van de pull-aanvraag nog steeds wijzigen.

Sjablonen voor pull-aanvragen gebruiken

Een pull-aanvraagsjabloon is een bestand met Markdown-tekst waarmee de beschrijving van de pull-aanvraag wordt ingevuld wanneer u een pull-aanvraag maakt. Goede pr-beschrijvingen vertellen revisoren wat ze kunnen verwachten en kunnen helpen bij het bijhouden van taken, zoals het toevoegen van eenheidstests en het bijwerken van documentatie. Uw team kan een standaard pr-sjabloon maken waarmee tekst wordt toegevoegd aan alle nieuwe pr-beschrijvingen in de opslagplaats. U kunt ook kiezen uit vertakkingsspecifieke sjablonen of andere sjablonen die uw team definieert. Zie Beschrijvingen van pull-aanvragen verbeteren met behulp van sjablonen voor meer informatie over het maken en gebruiken van PULL-sjablonen.

Als uw opslagplaats een standaardsjabloon heeft, hebben alle PULL's in de opslagplaats de beschrijvingstekst van de standaardsjabloon bij het maken. Als u andere sjablonen wilt toevoegen, selecteert u Een sjabloon toevoegen en kiest u vervolgens een sjabloon in de vervolgkeuzelijst. U kunt de sjabloontekst in uw beschrijving bewerken, verwijderen of andere tekst toevoegen.

Concept-PULL's maken

Als uw pull-aanvraag nog niet gereed is voor beoordeling, kunt u een concept-pull-aanvraag maken om aan te geven dat er werk wordt uitgevoerd. Wanneer de pull-aanvraag gereed is voor beoordeling, kunt u deze publiceren en het volledige beoordelingsproces starten of hervatten.

Concept-PULL's hebben de volgende verschillen met gepubliceerde PULL's:

• Validatiebeleid voor bouwen wordt niet automatisch uitgevoerd. U kunt buildvalidaties handmatig in de wachtrij plaatsen door het menu meer opties in de pull-aanvraag te selecteren.

• Stemmen is uitgeschakeld in de conceptmodus.

• Vereiste revisoren worden niet automatisch toegevoegd. Meldingen worden alleen verzonden naar revisoren die u expliciet aan de concept-pull-aanvraag toevoegt.

• Concept-PULL's worden weergegeven in de lijst met pull-aanvragen met een conceptbadge .

  

Browser

Als u een concept-pull-aanvraag wilt maken, selecteert u de pijl naast Maken en selecteert u Maken als concept bij het maken van de pull-aanvraag. U hoeft geen titelvoorvoegsels zoals WIP of NIET SAMENVOEGEN te gebruiken.

Wanneer u klaar bent om de pull-aanvraag te laten beoordelen en voltooien, selecteert u Publiceren rechtsboven in de pull-aanvraag. Als u een pull-aanvraag publiceert, worden de vereiste revisoren toegewezen, worden beleidsregels geëvalueerd en wordt de stem gestart.

Als u een bestaande gepubliceerde pull-aanvraag wilt wijzigen in een concept, kiest u Markeren als concept. Als u een pull-aanvraag markeert als concept, worden alle bestaande stemmen verwijderd.

Visual Studio

Als u een pull-aanvraag wilt instellen op concept, opent u de pull-aanvraag en selecteert u Markeren als concept.

• Als u een pull-aanvraag vanuit Visual Studio wilt openen, selecteert u <uw Git-service>>Pull-aanvragen weergeven en selecteert u een pull-aanvraag om deze te openen.
• Als u een pull-aanvraag wilt openen vanuit Visual Studio Team Explorer, klikt u in de weergave Pull-aanvragen met de rechtermuisknop op de pull-aanvraag en selecteert u Openen in de browser.

Azure DevOps CLI

Als u een pull-aanvraag wilt maken als concept, stelt u de --draft parameter true in op wanneer u de pull-aanvraag maakt. (Vereist azure DevOps Server 2020 of nieuwere versie.)

Voorbeeld:

az repos pr create --repository Fabrikam --source-branch new --draft true

Als u een bestaande pull-aanvraag wilt instellen op concept, gebruikt u az repos pr update --id <PR Id> --draft true.

Als u de conceptstatus uit een pull-aanvraag wilt verwijderen, stelt u in op --draft false.

Titel en beschrijving van pull-aanvraag toevoegen of bewerken

Browser

Voer op de pagina Nieuwe pull-aanvraag een titel en gedetailleerde beschrijving van uw wijzigingen in, zodat anderen kunnen zien welke problemen de wijzigingen oplossen. Op een nieuwe pull-aanvraag zoals in bestaande pull-aanvragen ziet u de bestanden en doorvoeringen in uw pull-aanvraag op afzonderlijke tabbladen. U kunt revisoren toevoegen, werkitems koppelen en tags toevoegen aan de pull-aanvraag.

Wanneer u klaar bent om uw wijzigingen te laten beoordelen, selecteert u Maken om de pull-aanvraag te maken.

U hoeft zich geen zorgen te maken als u niet alle werkitems, revisoren of details hebt die klaar zijn wanneer u uw pull-aanvraag maakt. U kunt deze items toevoegen of bijwerken nadat u de pull-aanvraag hebt gemaakt.

Titel en beschrijving van pull-aanvraag bewerken

Houd de titel en beschrijving van de pull-aanvraag up-to-date, zodat revisoren de wijzigingen in de pull-aanvraag kunnen begrijpen.

U kunt de titel van een bestaande pull-aanvraag bijwerken door de huidige titel te selecteren en de tekst bij te werken. Selecteer het pictogram Opslaan om wijzigingen op te slaan of selecteer het pictogram Ongedaan maken om de wijzigingen te negeren.

Bewerk de beschrijving van de pull-aanvraag door het pictogram Bewerken te selecteren in de sectie Beschrijving .

Visual Studio

Wanneer u een pull-aanvraag maakt in Visual Studio, voert u een titel en gedetailleerde beschrijving van uw wijzigingen in, zodat anderen kunnen zien welke problemen de wijzigingen oplossen. Houd deze velden up-to-date zodat revisoren de wijzigingen in de pull-aanvraag kunnen begrijpen.

Als u de titel, beschrijving of andere details in een bestaande pull-aanvraag wilt bewerken, opent u de pull-aanvraag in uw browser.

Azure DevOps CLI

U kunt details toevoegen tijdens het maken van pr met az repos pr create of details bijwerken in bestaande PULL's met az repos pr update.

Wanneer u een pull-aanvraag maakt, az repos pr createvoegt u een --title en een gedetailleerde --description van uw wijzigingen toe, zodat anderen kunnen zien welke problemen de wijzigingen oplossen. De --description parameter accepteert de Markdown-vermelding en elke waarde in het argument is een nieuwe regel van de beschrijving van de pull-aanvraag.

Voorbeeld:

az repos pr create --repository Fabrikam --source-branch new --title "Update the readme" --description "This PR updates the readme." "These are *new* changes."

Houd deze velden up-to-date zodat revisoren de wijzigingen in de pull-aanvraag kunnen begrijpen. Als u de details van een pull-aanvraag wilt bijwerken, gebruikt az repos pr update u deze met de vereiste pull-aanvraagparameter --id .

Als u bijvoorbeeld de titel en beschrijving voor PR #21 wilt bijwerken, gebruikt u:

az repos pr update --id 21 --description "These updates are *no longer new*." --title "Old updates"

Revisoren toevoegen aan een pull-aanvraag

Browser

U kunt revisoren toevoegen in de sectie Revisoren van een nieuwe of bestaande pull-aanvraag. U kunt ook bestaande optionele revisoren verplicht stellen of de vereiste revisoren wijzigen in optioneel of verwijderen, tenzij ze vereist zijn voor beleid.

Vertakkingsbeleid kan een minimum aantal revisoren vereisen of automatisch bepaalde optionele of vereiste revisoren opnemen in PULL's. U kunt revisoren die vereist zijn voor vertakkingsbeleid niet verwijderen. U kunt optionele revisoren van vertakkingsbeleid wijzigen zodat ze vereist zijn of verwijderen.

Als u het vertakkingsbeleid wilt zien dat automatisch een revisor heeft toegevoegd, klikt u in de sectie Revisoren van de pagina Pr-overzicht met de rechtermuisknop op Meer opties naast de revisor.

Als de gebruiker of groep die u wilt controleren uw pull-aanvraag niet lid is van uw project, moet u deze toevoegen aan het project voordat u ze als revisoren kunt toevoegen.

Revisoren toevoegen aan een nieuwe pull-aanvraag:

1. Selecteer op de pagina Nieuwe pull-aanvraag onder Revisoren de optie Gebruikers en groepen zoeken om toe te voegen als revisoren.
2. Wanneer u een naam of e-mailadres invoert, wordt in een vervolgkeuzelijst een lijst met overeenkomende gebruikers en groepen weergegeven. Selecteer namen in de lijst om toe te voegen als optionele revisoren.
3. Als u vereiste revisoren wilt toevoegen, selecteert u Vereiste revisoren toevoegen en selecteert u vervolgens Zoeken om de vereiste revisoren toe te voegen om de namen te zoeken en te selecteren.

Revisoren toevoegen aan een bestaande pull-aanvraag:

1. Selecteer Toevoegen in de sectie Revisoren van de pagina Overzicht en selecteer vervolgens Vereiste revisor of Optionele revisor.

   

2. Wanneer u een naam of e-mailadres invoert, wordt een lijst met overeenkomende gebruikers of groepen weergegeven. Selecteer de namen die u als revisoren wilt toevoegen.

   

Als u een revisor wilt wijzigen tussen vereist en optioneel of een revisor wilt verwijderen, selecteert u meer opties rechts van de revisornaam. Als u het lidmaatschap van een groep of team wilt zien dat is aangewezen als revisor, selecteert u het pictogram van de groep.

Visual Studio

Als u revisoren wilt toevoegen, opent u de pull-aanvraag in uw browser en voert u de updates uit op de overzichtspagina van de pull-aanvraag.

Azure DevOps CLI

U kunt optionele revisoren toevoegen aan een pull-aanvraag bij het maken met
az repos pr create --reviewer "<Reviewer Name>" "<Another Reviewer>".

Voorbeeld:

az repos pr create --repository Fabrikam --source-branch new --reviewer "[Fabrikam]\Fabrikam Team" "[Fabrikam Fiber]\Web"

Als u vereiste revisoren wilt toevoegen of revisoren wilt wijzigen tussen optioneel en vereist, opent en werkt u de pull-aanvraag bij in de browser.

Als u revisoren voor een bestaande pull-aanvraag wilt beheren, gebruikt u az repos pr reviewer.

• Als u revisoren wilt toevoegen aan een bestaande pull-aanvraag, gebruikt u
  az repos pr reviewer add --id <PR Id> --reviewer "<Reviewer Name>" "<Another Reviewer>".
• Als u de revisoren voor een pull-aanvraag wilt weergeven, gebruikt u az repos pr reviewer list --id <PR Id>.
• Als u revisoren uit een pull-aanvraag wilt verwijderen, gebruikt u az repos pr reviewer remove --id <PR Id> --reviewer "<Reviewer Name>".

az repos pr reviewer add --id
                         --reviewers
                         [--detect {false, true}]
                         [--org]
                         [--subscription]

Parameters

Parameter	Description
--id	Id van de pull-aanvraag. Vereist.
--reviewers	Gebruikers of groepen die als revisoren moeten worden opgenomen in een pull-aanvraag. Afstand gescheiden. Vereist.
--detect	Organisatie automatisch detecteren. Geaccepteerde waarden: false, true.
--org --organization	Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=<ORG_URL>. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.
--subscription	De naam of id van het Azure-abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s <NAME_OR_ID>.

Werkitems koppelen aan een pull-aanvraag

Browser

Werkitems koppelen aan een nieuwe pull-aanvraag:

1. Selecteer op de pagina Nieuwe pull-aanvraag, onder Werkitems die u wilt koppelen, werkitems zoeken op id of titel.
2. Begin een werkitem-id of titel in te voeren en selecteer het werkitem dat u wilt koppelen in de vervolgkeuzelijst die wordt weergegeven. Zoeken op titel retourneert werkitems gefilterd op status; alle werkitems met statussen met statuscategorieën Voltooid en Verwijderd worden uitgesloten. Deze werkitems worden ook gefilterd op datum en gebruiker, waarbij alleen items worden gemaakt of bijgewerkt in de afgelopen 30 dagen, en ze moeten worden gemaakt door, toegewezen aan of geautoriseerd als de huidige gebruiker.

Werkitems koppelen aan een bestaande pull-aanvraag:

1. Selecteer op het tabblad Overzicht van pull-aanvraag in het gebied Werkitems de optie +.

   

2. Voer de id van het werkitem in of zoek naar de titel van het werkitem. Selecteer het werkitem in de lijst die wordt weergegeven.

Verwijder een koppeling naar een werkitem door het x-pictogram naast het werkitem te selecteren. Als u een koppeling verwijdert, wordt alleen de koppeling tussen het werkitem en de pull-aanvraag verwijderd. Koppelingen die in de vertakking of vanuit doorvoeringen zijn gemaakt, blijven in het werkitem staan.

Visual Studio

Als u werkitems wilt koppelen, opent u de pull-aanvraag in uw browser en voert u de updates uit op de overzichtspagina van de pull-aanvraag.

Azure DevOps CLI

U kunt Azure Boards-werkitems koppelen aan pull-aanvragen bij het maken van pull-aanvragen, az repos pr create --work-items <Id1> <Id2>waarbij <id> de id van het werkitem is.

Met de volgende opdracht worden bijvoorbeeld werkitems #63 en #64 gekoppeld aan een nieuwe pull-aanvraag in de new vertakking:

az repos pr create --repository Fabrikam --source-branch new --work-items 63 64

Als u werkitems voor een bestaande pull-aanvraag wilt beheren, gebruikt u az repos pr work-item.

• Als u werkitems wilt koppelen aan een bestaande pull-aanvraag, gebruikt u az repos pr work-item add --id <PR Id> --work-items <Id1> <Id2>.
• Als u de werkitems wilt weergeven die zijn gekoppeld aan een pull-aanvraag, gebruikt u az repos pr work-item list --id <PR Id>.
• Als u een werkitem uit een pull-aanvraag wilt ontkoppelen, gebruikt u az repos pr work-item remove --id <PR Id> --work-items <Id1>. Als u de koppeling verwijdert, wordt alleen de koppeling tussen het werkitem en de pull-aanvraag verwijderd. Koppelingen die in de vertakking of vanuit doorvoeringen zijn gemaakt, blijven in het werkitem.

az repos pr work-item add --id
                          --work-items
                          [--detect {false, true}]
                          [--org]
                          [--subscription]

Parameters

Parameter	Description
--id	Id van de pull-aanvraag. Vereist.
--work-items	Id's van de werkitems die u wilt koppelen. Afstand gescheiden. Vereist.
--detect	Organisatie automatisch detecteren. Geaccepteerde waarden: false, true.
--org --organization	Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=<ORG_URL>. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.
--subscription	De naam of id van het Azure-abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s <NAME_OR_ID>.

Tags toevoegen aan een pull-aanvraag

Gebruik tags om belangrijke details weer te geven en pull-aanvragen te organiseren. Tags kunnen extra informatie doorgeven aan revisoren, zoals dat de pull-aanvraag nog steeds bezig is of een hotfix is voor een toekomstige release.

Als u een tag wilt toevoegen bij het maken van een pull-aanvraag, typt u een tagnaam in de sectie Tags . Nadat u de pull-aanvraag hebt gemaakt, kunt u tags beheren in de sectie Tags .

Bijlagen toevoegen aan pull-aanvragen

U kunt bestanden, inclusief afbeeldingen, toevoegen aan uw pull-aanvraag tijdens of na het maken. Selecteer het paperclippictogram onder het veld Beschrijving of sleep bestanden rechtstreeks naar het veld Beschrijving van de pull-aanvraag.

De doelbranch van een actieve pull-aanvraag wijzigen

Voor de meeste teams richten bijna alle PULL's zich op een standaardbranch, zoals main of develop. Als u soms een andere vertakking moet richten, is het gemakkelijk om de doelbranch te wijzigen wanneer u de pull-aanvraag maakt. Als dat gebeurt, kunt u de doelbranch van een actieve pull-aanvraag wijzigen:

1. Selecteer Meer acties in de rechterbovenhoek op de pagina Overzicht van pull-aanvraag en selecteer vervolgens Doelvertakking wijzigen in de vervolgkeuzelijst.
2. Selecteer in het deelvenster Doelbranch een doelbranch kiezen, selecteer de nieuwe vertakking en selecteer Vervolgens Wijzigen.

Meldingen van pull-aanvragen via e-mail verzenden naar belanghebbenden

U kunt een pull-aanvraag per e-mail delen om revisoren op de hoogte te stellen en met teamleden te communiceren. Een pull-aanvraag delen:

1. Selecteer Meer opties op de pagina Overzicht van pull-aanvraag delen en selecteer vervolgens Pull-aanvraag delen.

   

2. Voeg in het scherm Pull-aanvraag delen geadresseerden toe door hun namen in het veld Aan te typen en te selecteren in de gebruikersnamen die worden weergegeven. U kunt ook geadresseerden verwijderen.

3. Voeg een optioneel bericht toe in het veld Opmerking (optioneel) en selecteer Verzenden. Geadresseerden ontvangen een e-mailbericht waarin hun aandacht wordt gevraagd en die worden gekoppeld aan de pull-aanvraag.

Notitie

Als u de ingebouwde e-mailfunctie gebruikt, kunt u de e-mail alleen verzenden naar de afzonderlijke adressen van projectleden. Het toevoegen van een teamgroep of beveiligingsgroep aan de regel Aan wordt niet ondersteund. Als u een e-mailaccount toevoegt dat het systeem niet herkent, ontvangt u een bericht dat een of meer geadresseerden van uw e-mail geen machtigingen hebben om de pull-aanvraag via e-mail te lezen.

Volgende stappen

Pull-aanvragen controleren

Verwante artikelen:

• Pull-aanvragen weergeven
• Pull-aanvragen controleren
• Pull-aanvragen voltooien
• De standaardbranch wijzigen
• Wijzigingen kopiëren met cherry-pick
• Over pull-aanvragen en machtigingen
• Meerdere samenvoegingsbasissen