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-aanvragen (PULL's) om codewijzigingen in een Git-opslagplaats in Azure-opslagplaatsen te controleren en samen te voegen. 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 kan pull-aanvragen vereisen voor wijzigingen in beveiligde vertakkingen en vertakkingsbeleid instellen om bepaalde PULL's te vereisen om te voldoen aan specifieke criteria.

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

Vereisten

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

• Als u PULL's wilt weergeven, moet u lid zijn van het Azure DevOps-project waarin de pull-aanvraag zich bevindt, met basic-toegang of hoger. Als u geen projectlid bent, wordt u toegevoegd.

  Notitie

  Voor openbare projecten hebben gebruikers aan belanghebbenden volledige toegang tot Azure-opslagplaatsen.

• Zie De standaardmachtigingen en vertakkingsmachtigingen voor Git voor meer informatie over machtigingen en toegangsniveaus.

• In Azure DevOps Services kunt u PULL's en andere resources beheren vanuit de Azure-opdrachtregelinterface (CLI) met de azure-devops extensie. Zie Aan de slag met Azure DevOps CLI voor meer informatie over het werken met de Azure DevOps Services CLI. Cli-opdrachten voor Azure-opslagplaatsen voor PULL's maken gebruik van az repos pr.

Pull-aanvragen vermelden

U kunt PULL's 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 Pull-aanvragen voor opslagplaatsen>.

   

2. Controleer of u de juiste opslagplaats hebt geselecteerd.

   

3. In de standaardweergave worden uw PULL's weergegeven op het tabblad Mijn . Selecteer Actief om alle actieve PULL's voor de huidige opslagplaats weer te geven. Selecteer Voltooid of Verlaten om lijsten met gesloten pull-aanvragen weer te geven.

   Selecteer een pull-aanvraag in de lijst om naar de overzichtspagina van die pull-aanvraag 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 Git-menu de Pull-aanvragen voor uw Git-service>>weergeven.<

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.

Toegang krijgen tot PULL's vanuit Visual Studio Team Explorer:

1. Verbinding maken naar 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. Als u de pr-lijst wilt weergeven in de Azure DevOps-webportal, selecteert u Acties en selecteert u Vervolgens Openen in browser.

   

Azure DevOps CLI

Als u actieve pull-aanvragen in uw project met hun details wilt weergeven, gebruikt u az repos pr list.

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	Description
--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 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.
--query-examples	Aanbevolen JMESPath-tekenreeks. U kunt een van de query's kopiëren en plakken na de --query parameter 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 gericht zijn op deze vertakking.
--top	Maximum aantal pull-aanvragen dat moet worden vermeld.

Opmerking

Met de volgende opdracht worden alle PULL's in de opslagplaats weergegeven, ongeacht de status, en wordt de uitvoer in een tabel weergegeven. 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 pr-lijst te filteren, kunt u PULL's vinden en organiseren om prioriteit te geven aan de belangrijkste bestanden in uw werkstroom.

Browser

Als u de pr-lijst wilt filteren, selecteert u op de pagina Pull-aanvragen het filterpictogram rechtsboven. Selecteer vervolgens Doelbranch of 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 de weergave Aanpassen 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 op parameters zoals de conceptstatus of de bijgewerkte datum. U kunt kiezen of u pull-aanvragen wilt weergeven die ik op een afzonderlijk tabblad heb goedgekeurd of afgewezen, of pull-aanvragen (duplicaten) uitsluiten die in de vorige secties zijn opgenomen. 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 opslagplaatsen op het tabblad Mijn pull-aanvragen 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 aanpassen en 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 tabblad PR-bestanden kunt u verschillende filters gebruiken om bestanden en opmerkingen te selecteren voor snellere beoordelingen. Selecteer Filteren en selecteer vervolgens een van de opties.

• Trefwoord: Voer een trefwoord in.
• Beoordeeld/niet beoordeeld: Alle (standaard), In behandeling, Beoordeeld.
• Opmerkingen bij bestanden: alle bestanden (standaard), bestanden met opmerkingen.
• Opmerkingen: Weergeven (standaard), Nieuw, Verbergen.
• Opmerkingsstatus: Actief (standaard), In behandeling, Opgelost, Zoals ontworpen, 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 Git-menu de pull-aanvragen voor uw Git-service>>weergeven.

2. Filteren op auteur, label of andere kenmerken.

Vanuit de weergave Pull-aanvragen van Team Explorer:

• Selecteer Actief of Toegewezen aan mij of mijn team om de pr-lijsten te filteren op pr-status of toewijzing.
• Of typ hier het type om de lijstvelden 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's te filteren, zoals --creator, , --project--repository, --reviewer, , --source-branch, , --status, en .--top--target-branch

De --creator waarden --reviewer kunnen weergavenamen of e-mailadressen zijn. De --top parameter definieert het maximum aantal pull-aanvragen dat moet worden vermeld.

Als u bijvoorbeeld details wilt weergeven over de laatste pull-aanvraag die u hebt gemaakt, ongeacht de status, gebruikt u:

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

Open een pull-aanvraag

Wanneer u een pull-aanvraag opent vanuit de browser, vanuit Visual Studio of azure CLI, wordt de pagina Pr-overzicht geopend in de browser.

Browser

Als u een pull-aanvraag wilt openen in de browser, selecteert u de pull-aanvraag in de lijst op de pagina Pull-aanvragen . 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 wordt doorgegeven of mislukt en opmerkingen die revisoren hebben gemaakt.

Op het tabblad PR-bestanden kunt u de werkelijke wijzigingen in de PULL-bestanden bekijken. Op de tabbladen Updates en Doorvoeringen ziet u de wijzigingen die de auteur heeft aangebracht om de PULL-vertakking bij te werken.

Visual Studio

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

Of klik in de weergave Pull-aanvragen van Team Explorer met de rechtermuisknop op de pull-aanvraag en selecteer Openen in de browser om de pull-aanvraag te openen in de webportal.

Een vertakking uitchecken

In Visual Studio 2019 kunt u de bronbranch van een pull-aanvraag rechtstreeks vanuit de weergave Pull-aanvragen uitchecken. Klik met de rechtermuisknop op een pull-aanvraag 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 Explorer voor meer informatie.

Azure DevOps CLI

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

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

Parameters

Parameter	Description
--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 indien niet geconfigureerd als standaard of 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 --query parameter 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>.

Opmerking

In het volgende voorbeeld ziet u de details voor PR #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 vertakking uitchecken

Gebruik az repos pr checkout met de vereiste --id parameter om een PR-vertakking lokaal te bekijken, zolang er geen lokale wijzigingen zijn.

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

Parameters

Parameter	Description
--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>.

Opmerking

Als u bijvoorbeeld de vertakking voor PULL #21 lokaal wilt uitchecken, gebruikt u:

az repos pr checkout --id 21

Zie Pull-aanvragen controleren als 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
• Meldingen over pull-aanvraagupdates
• Een pull-aanvraag voltooien
• De standaardbranch wijzigen
• Wijzigingen kopiëren met cherry-pick
• Over pull-aanvragen en machtigingen