Pull-aanvragen weergeven, filteren en openen

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

Visual Studio 2019 | Visual Studio 2022

U maakt pull requests (PR's) om te controleren en codewijzigingen samen te voegen in een Git-opslagplaats op Azure Repos. Teamleden en belanghebbenden kunnen wijzigingen bekijken en feedback geven voordat de code wordt samengevoegd in de doelbranch. Revisoren kunnen ook opmerkingen maken over wijzigingen en stemmen om de code goed te keuren of af te wijzen.

Teams kunnen pull-aanvragen vereisen voor wijzigingen in beveiligde vertakkingen en vertakkingsbeleidsregels instellen om te vereisen dat bepaalde pull-aanvragen aan specifieke criteria voldoen.

Er zijn verschillende manieren om pull-aanvragen voor een project op te sommen, te filteren, weer te geven en te openen.

Voorwaarden

• Repositories moeten ingeschakeld zijn voor uw project. Als de opslagplaatsen hub en gekoppelde pagina's niet worden weergegeven, raadpleegt u Een Azure DevOps-service in- of uitschakelen om opslagplaatsen opnieuw in of uit te schakelen.

• Om PR's te bekijken, moet u lid zijn van het Azure DevOps-project waarin de PR zich bevindt, met ten minste Basic access. Als u geen projectlid bent, wordt toegevoegd.

  Notitie

  Voor openbare projecten hebben gebruikers die Belanghebbende toegang hebben, volledige toegang tot Azure Repos.

• Zie Standaardmachtigingen voor Git-opslagplaatsen en vertakkingsmachtigingen en Over toegangsniveausvoor meer informatie over machtigingen en toegang.

• In Azure DevOps Services kunt u PR's en andere resources beheren vanuit de Azure-commandoregelinterface (CLI) met de azure-devops-extensie. Zie Aan de slag met Azure DevOps CLIvoor meer informatie over het werken met de Azure DevOps Services CLI. CLI-opdrachten voor Azure Repos voor pull-verzoeken gebruiken az repos pr.

Pull-aanvragen vermelden

U kunt pull-aanvragen weergeven met behulp van de Azure DevOps-projectwebsite, Visual Studio of de Azure DevOps-opdrachtregel.

browser

1. Als u pull-aanvragen in een specifieke opslagplaats in een project wilt weergeven, gaat u naar dat project in de webportal en selecteert u Opslagplaatsen>Pull-aanvragen.

   

2. Controleer of u de juiste opslagplaats hebt geselecteerd.

   

3. In de standaardweergave worden uw PR's weergegeven op het tabblad Mijn. Selecteer Actief om alle actieve PR's voor de actuele repository weer te geven. Selecteer voltooide of verlaten om lijsten met gesloten pull-aanvragen (PR's) weer te geven.

   Selecteer een PR in de lijst om naar de overzichtspagina () van die PR te gaan.

   

4. U kunt al uw pull-aanvragen in verschillende projecten in uw organisatie weergeven door Pull-aanvragen te kiezen in de weergave Mijn werk.

   

Visual Studio

Als u pull-aanvragen van Visual Studio wilt weergeven, selecteert u in het menu Git-<uw Git-service>>Pull-aanvragen weergeven.

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

Toegang tot Pull-aanvragen vanuit Visual Studio Team Explorer:

1. Verbinding maken met uw project vanuit Visual Studio.

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

3. In Homeselecteer je Pull Requests om lijsten met pull requests weer te geven die door jou zijn geopend of aan jou zijn toegewezen.

4. Als u de PR-lijst in de Azure DevOps-webportal wilt weergeven, selecteert u Acties en selecteert u vervolgens Openen in browser.

   

Azure DevOps CLI

Gebruik az repos pr listom een lijst van actieve pull-aanvragen met hun details in uw project weer te geven.

az repos pr list [--creator]
                 [--detect {false, true}]
                 [--include-links]
                 [--org]
                 [--project]
                 [--query-examples]
                 [--repository]
                 [--reviewer]
                 [--skip]
                 [--source-branch]
                 [--status {abandoned, active, all, completed}]
                 [--subscription]
                 [--target-branch]
                 [--top]

Parameters

Parameter	Beschrijving
--creator	Beperk de resultaten tot pull-aanvragen die door deze gebruiker zijn gemaakt.
--detect	Organisatie automatisch detecteren. Geaccepteerde waarden: false, true.
--include-links	Neem _links op voor elke pull-aanvraag.
--org --organization	Url van de Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=<ORG_URL>. Vereist als deze niet is geconfigureerd als standaard of wordt 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 als deze niet is geconfigureerd als standaard of wordt opgehaald via git-configuratie.
--query-examples	Aanbevolen JMESPath-tekenreeks. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat suggesties zijn gebaseerd op deze trefwoorden.
--repository -r	Naam of id van de opslagplaats.
--reviewer	Beperk resultaten tot pull-aanvragen waarbij deze gebruiker een revisor is.
--skip	Het aantal pull-aanvragen dat moet worden overgeslagen.
--source-branch -s	Beperk de resultaten tot pull-aanvragen die afkomstig zijn van deze bronbranch.
--status	Beperk resultaten tot pull-aanvragen met deze status. Geaccepteerde waarden: abandoned, active, all, completed.
--subscription	De 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	Beperk de resultaten tot pull-aanvragen die zich richten op deze branch.
--top	Maximum aantal pull-aanvragen dat moet worden vermeld.

Voorbeeld

Met de volgende opdracht worden alle pull requests in de repository weergegeven, ongeacht de status, en de uitvoer wordt getoond in een tabel. In het voorbeeld wordt de standaardconfiguratie az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"gebruikt.

az repos pr list --status all --output table

ID    Created     Creator              Title                                           Status     IsDraft    Repository
----  ----------  -------------------  ----------------------------------------------  ---------  ---------  ------------
11    2021-10-04  jamalh@fabrikam.com  Revert 'Updated parameterized-functions.md'     Completed  False      Fabrikam
10    2021-10-04  jamalh@fabrikam.com  Updated parameterized-functions.md              Completed  False      Fabrikam
9     2021-10-04  ke@fabrikam.com      New pull request                                Completed  False      Fabrikam
8     2021-10-04  jamalh@fabrikam.com  Updated parameterized-functions.md              Abandoned  False      Fabrikam
7     2021-09-30  jamalh@fabrikam.com  Added note-new-git-tool.md to /                 Completed  False      Fabrikam
6     2021-09-29  jamalh@fabrikam.com  Revert 'Added parameterized-functions.md to /'  Abandoned  False      Fabrikam
5     2021-09-29  jamalh@fabrikam.com  Updated README.md                               Completed  False      Fabrikam
4     2021-09-29  jamalh@fabrikam.com  Added parameterized-functions.md to /           Completed  False      Fabrikam
3     2021-09-28  jamalh@fabrikam.com  WIP New file                                    Abandoned  False      Fabrikam
2     2021-09-28  jamalh@fabrikam.com  Update README.md                                Abandoned  False      Fabrikam
1     2021-09-28  jamalh@fabrikam.com  Edit README.md                                  Completed  False      Fabrikam

Een aangepaste weergave voor pull-aanvragen definiëren

Door de pull-verzoekenlijst te filteren, kunt u pull-verzoeken vinden en organiseren zodat u de belangrijkste bestanden in uw werkstroom kunt prioriteren.

browser

Als u de lijst met pull-aanvragen wilt filteren, selecteert u op de pagina Pull-aanvragen het pictogram Filter rechtsboven. Selecteer vervolgens doelbranch of een andere kolomkop en selecteer de vertakking of andere waarde waarop u wilt filteren.

Als u de weergave van de lijst met pull-aanvragen verder wilt aanpassen, selecteert u Aangepaste weergave rechtsboven op de pagina Pull-aanvragen.

Op de pagina Weergave aanpassen kunt u de huidige weergavesecties opnieuw rangschikken, bewerken of verwijderen. Als u een nieuwe sectie wilt maken, selecteert u Sectie toevoegen.

Voer op de pagina Sectie aanpassen waarden in en selecteer deze om de sectie te filteren volgens parameters zoals conceptstatus of bijgewerkte datum. U kunt kiezen of u pull-aanvragen wilt weergeven die ik heb goedgekeurd of afgewezen op een afzonderlijk tabblad, of pull-aanvragen (duplicaten) uitsluiten die zijn opgenomen in de vorige secties. Wanneer u klaar bent met het aanpassen van de weergave, selecteert u Opslaan.

Deze aangepaste weergaven maken afzonderlijke, samenvouwbare secties op de pagina met pull-aanvragen. Deze aangepaste query's werken ook in repositories in het Mijn pull-aanvragen tabblad van de startpagina van de organisatie.

Als u de parameters van de aangepaste weergaven wilt wijzigen, selecteert u de knop Aanpassen naast de weergave. Of selecteer weergave aanpassenen selecteer in het scherm Weergave aanpassen de weergave die u wilt wijzigen. Sommige weergaven, zoals toegewezen aan mij, kunnen niet worden aangepast, maar ze kunnen opnieuw worden gerangschikt of verwijderd.

Op een PR Bestanden tabblad kunt u verschillende filters gebruiken om voor snellere beoordelingen bestanden en opmerkingen te selecteren. Selecteer Filteren selecteer vervolgens een van de opties.

• Trefwoord: Voer een trefwoord in.
• Gecontroleerd/onbeoordeeld: Alle (standaard); in behandeling; Gecontroleerd.
• Bestanden met opmerkingen: Alle bestanden (standaard), Bestanden met opmerkingen.
• Opmerkingen: weergeven (standaard), Wat is er nieuw, Verbergen.
• Opmerkingsstatus: Actief (standaard), In behandeling, Opgelost, Zoals bedoeld, Wordt niet opgelost, Gesloten.
• Opmerkingen gemaakt door: Alle opmerkingen (standaard) of een specifieke persoon.

U kunt ook een tekenreeks in het zoekveld typen om overeenkomende resultaten van de voorgaande opties weer te geven.

Visual Studio

Pull-aanvragen filteren vanuit Visual Studio:

1. Selecteer in het menu Git<uw Git-service>>Pull-aanvragen weergeven.

2. Filter op Author, Labelof andere kenmerken.

Vanuit de Team Explorer Pull Requests weergave:

• Selecteer Actieveof toegewezen aan mij of mijn teamom de pr-lijsten te filteren op pr-status of toewijzing.
• Of typ in de velden Typ hier om te filteren om de PR-lijsten te filteren op datum, auteur, vertakking of andere kenmerken.

Azure DevOps CLI

U kunt verschillende az repos pr list parameters gebruiken om de lijst met pull requests te filteren, zoals --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branchen --top.

De waarden voor --creator en --reviewer kunnen weergavenamen of e-mailadressen zijn. De parameter --top definieert het maximum aantal PR's dat moet worden vermeld.

Als u bijvoorbeeld details wilt weergeven over de laatste pull request die u hebt aangemaakt, ongeacht de status, gebruikt u:

az repos pr list --creator "My Name" --status all --top 1

Een pull-aanvraag openen

Wanneer u een pull request opent vanuit de browser, vanuit Visual Studio of vanuit de Azure CLI, opent de PR Overzicht-pagina in de browser.

browser

Als u een PR wilt openen in de browser, selecteert u de PR in de lijst op de Pull requests pagina. De pull-aanvraag wordt geopend op het tabblad Overzicht. Op het tabblad Overzicht ziet u de titel, beschrijving, revisoren, gekoppelde werkitems, geschiedenis en status. U kunt een samenvatting bekijken van vertakkingsbeleid dat slaagt of faalt, en opmerkingen zien die beoordelaars hebben gemaakt.

Op het tabblad Pull Request Bestanden kunt u de werkelijke wijzigingen in de pull request-bestanden bekijken. Op de tabbladen Updates en Commits kunt u de wijzigingen zien die de auteur heeft aangebracht om de PR-tak bij te werken.

Visual Studio-

Als u een pull-aanvraag vanuit Visual Studio wilt openen, selecteert u in het menu Git-<uw Git-service>>Pull-aanvragen weergevenen selecteert u vervolgens een pull-aanvraag om deze te openen.

Of klik in de Teamverkenner pull-aanvragen overzicht met de rechtermuisknop op de pull-aanvraag en selecteer Openen in browser om de pull-aanvraag te openen in de webportal.

Een branch uitchecken

In Visual Studio 2019 kunt u de bronbranch van een pull-aanvraag rechtstreeks bekijken vanuit de weergave Pull-aanvragen. Klik met de rechtermuisknop op een pull request en kies Bronvertakking uitchecken.

Notitie

Visual Studio 2019 versie 16.8 en nieuwere versies bieden een nieuw Git-menu voor het beheren van de Git-werkstroom met minder contextwisselingen dan Team Explorer. Procedures in dit artikel op het tabblad Visual Studio bieden informatie over het gebruik van de Git-ervaring en Team Explorer. Zie Vergelijking naast elkaar van Git en Team Explorervoor meer informatie.

Azure DevOps CLI-

Als u de details voor één pull-aanvraag wilt weergeven, gebruikt u az repos pr show met de vereiste parameter --id. Gebruik --openom de pull request in uw browser te openen.

az repos pr show --id
                 [--detect {false, true}]
                 [--open]
                 [--org]
                 [--query-examples]
                 [--subscription]

Parameters

Parameter	Beschrijving
--id	Id van de pull-aanvraag. Vereist.
--detect	Organisatie automatisch detecteren. Geaccepteerde waarden: false, true.
--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 als deze niet is geconfigureerd als standaard of wordt opgehaald via git-configuratie. Voorbeeld: https://dev.azure.com/MyOrganizationName/.
--query-examples	Aanbevolen JMESPath-tekenreeks. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat suggesties zijn gebaseerd op deze trefwoorden.
--subscription	De naam of id van het Azure-abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s <NAME_OR_ID>.

Voorbeeld

In het volgende voorbeeld ziet u de details voor pull-aanvraag #21, ziet u de uitvoer van de opdracht als een tabel en opent u de pull-aanvraag in de browser:

az repos pr show --id 21 --open --output table

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

Een branch uitchecken

Gebruik az repos pr checkout met de vereiste parameter --id om een PR-branch lokaal uit te checken, op voorwaarde dat er geen lokale wijzigingen zijn.

az repos pr checkout --id
                     [--remote-name]
                     [--subscription]

Parameters

Parameter	Beschrijving
--id	Id van de pull-aanvraag.
--remote-name	Naam van git remote waarop pull-aanvraag wordt gegenereerd. Standaardwaarde: origin.
--subscription	De naam of id van het Azure-abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s <NAME_OR_ID>.

Voorbeeld

Als u bijvoorbeeld de branch voor PR #21 lokaal wilt uitchecken, gebruik:

az repos pr checkout --id 21

Zie Pull-aanvragen controlerenals u wijzigingen wilt bekijken, opmerkingen of suggesties wilt maken of goedkeuren of stemmen op de pull-aanvraag.

Pull-aanvragen van een mobiel apparaat weergeven en bijwerken

U kunt mobiele apparaten gebruiken om alle pr-schermen van Azure-opslagplaatsen weer te geven en acties uit te voeren.

Volgende stappen

pull-aanvragen controleren

Verwante artikelen

• een pull-aanvraag maken
• updatemeldingen voor pull-aanvragen
• een pull-aanvraag voltooien
• de standaardbranch wijzigen
• Wijzigingen kopiëren met cherry-pick
• Over pull-aanvragen en -machtigingen