Wyświetlanie, filtrowanie i otwieranie pull requestów

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Żądania ściągnięcia są tworzone w celu przeglądania i scalania zmian kodu w repozytorium Git w usłudze Azure Repos. Członkowie zespołu i uczestnicy projektu mogą przeglądać zmiany i przesyłać opinie przed scaleniem kodu z gałęzią docelową. Recenzenci mogą również komentować zmiany i głosować, aby zatwierdzić lub odrzucić kod.

Zespoły mogą wymagać żądań ściągnięcia dla wszelkich zmian w chronionych gałęziach i ustawić zasady gałęzi, aby wymagać spełnienia określonych kryteriów określonych żądań ściągnięcia.

Istnieje kilka sposobów wyświetlania listy, filtrowania, wyświetlania i otwierania żądań ściągnięcia dla projektu.

Warunki wstępne

• Repos muszą być włączone w twoim projekcie. Jeśli centrum repozytoriów i skojarzone strony nie są wyświetlane, zobacz Włączanie lub wyłączanie usługi Azure DevOps w celu ponownego włączania lub wyłączania repozytoriów.

• Aby móc wyświetlać żądania ściągnięcia, należy być członkiem projektu Azure DevOps, w którym znajduje się żądanie ściągnięcia, z co najmniej dostępem na poziomie Basic . Jeśli nie jesteś członkiem projektu, dodać.

  Notatka

  W przypadku projektów publicznych użytkownicy, którym przyznano dostęp typu Stakeholder, mają pełny dostęp do usługi Azure Repos.

• Aby uzyskać więcej informacji na temat uprawnień i dostępu, zobacz Domyślne repozytorium Git i uprawnienia gałęzi i Informacje o poziomach dostępu.

• W Azure DevOps Services możliwe jest zarządzanie żądaniami przetwarzania i innymi zasobami z interfejsu wiersza polecenia Azure przy użyciu rozszerzenia azure-devops. Aby dowiedzieć się, jak pracować z interfejsem wiersza polecenia usługi Azure DevOps Services, zobacz Rozpoczynanie pracy z interfejsem wiersza polecenia usługi Azure DevOps. Polecenia CLI usługi Azure Repos dla żądań przciągnięcia używają polecenia az repos pr.

Lista pull requestów

Żądania ściągnięcia można wyświetlić za pomocą witryny internetowej projektu Usługi Azure DevOps, programu Visual Studio lub wiersza polecenia usługi Azure DevOps.

przeglądarka

1. Aby wyświetlić listę żądań ściągnięcia w określonym repozytorium w projekcie, przejść do tego projektu w portalu internetowym i wybrać pozycję Repozytoria>Żądania ściągnięcia.

   

2. Sprawdź, czy wybrano poprawne repozytorium.

   

3. Widok domyślny zawiera pull requesty na karcie Mine. Wybierz zakładkę Active, aby wyświetlić wszystkie aktywne pull requesty dla bieżącego repozytorium. Wybierz Ukończono lub Porzucone, aby wyświetlić listę zamkniętych żądań konsolidacji.

   Wybierz dowolne PR na liście, aby przejść do strony Przegląd tego PR.

   

4. Możesz wyświetlić listę wszystkich pull requestów w różnych projektach w organizacji, wybierając pozycję Pull requests w widoku Moja Praca.

   

Aby wyświetlić listę żądań pobrania w programie Visual Studio, w menu Git wybierz pozycję <usługi Git>>Wyświetl żądania pobrania.

Program Visual Studio 2019 w wersji 16.8 lub nowszej zapewnia środowisko kontroli wersji usługi Git przy zachowaniu interfejsu użytkownika programu Team Explorer Git. Aby użyćTeam Explorer, usuń zaznaczenie ToolsOptionsPreview FeaturesNew Git user experience na pasku menu. Funkcje usługi Git można wykonywać z dowolnego interfejsu zamiennie.

Aby uzyskać dostęp do żądań ściągnięcia (Pull Requests) w programie Visual Studio Team Explorer:

1. Połącz się z projektem w Visual Studio.

2. Wybierz pozycję View>Team Explorer, aby otworzyć program Team Explorer. Możesz również nacisnąć Ctrl+\, Ctrl+M.

3. W strona główna wybierz pozycję Żądania ściągnięcia, aby wyświetlić listy żądań ściągnięcia otwieranych przez Ciebie lub przypisanych do Ciebie.

4. Aby wyświetlić listę pull requestów w portalu internetowym usługi Azure DevOps, wybierz Actions, a następnie Otwórz w przeglądarce.

   

CLI Azure DevOps

Aby wyświetlić listę aktywnych pull requestów w projekcie wraz ze szczegółami, użyj polecenia 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]

Parametry

Parametr	Opis
--creator	Ogranicz wyniki do żądań ściągnięcia utworzonych przez tego użytkownika.
--detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
--include-links	Uwzględnij _links dla każdego pull request.
--org --organization	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu az devops configure -d organization=<ORG_URL>. wymagana, jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
--project -p	Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu az devops configure -d project=<NAME_OR_ID>. wymagana, jeśli nie została skonfigurowana jako domyślna lub pobrana poprzez konfigurację Git.
--query-examples	Zalecany ciąg znaków JMESPath. Możesz skopiować jedno z zapytań i wkleić je po parametrze --query w podwójnym cudzysłowie, aby wyświetlić wyniki. Możesz dodać co najmniej jedno słowo kluczowe pozycyjne, aby sugestie były oparte na tych słowach kluczowych.
--repository -r	Nazwa lub identyfikator repozytorium.
--reviewer	Ogranicz wyniki do żądań pull request, w których ten użytkownik jest recenzentem.
--skip	Liczba pull requestów do pominięcia.
--source-branch -s	Ogranicz wyniki do żądań ściągnięcia pochodzących z tej gałęzi źródłowej.
--status	Ogranicz wyniki żądań ściągnięcia o tym stanie. Zaakceptowane wartości: abandoned, active, all, completed.
--subscription	Nazwa lub identyfikator subskrypcji platformy Azure. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s <NAME_OR_ID>.
--target-branch -t	Ogranicz wyniki do pull requestów przeznaczonych dla tej gałęzi.
--top	Maksymalna liczba żądań ściągnięcia do wyświetlenia.

Przykład

Poniższe polecenie wyświetla listę wszystkich pull requestów w repozytorium, niezależnie od stanu, i wyświetla wynik w tabeli. W przykładzie użyto domyślnej konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

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

Zdefiniuj niestandardowy widok pull requesta

Filtrowanie listy żądań ściągnięcia ułatwia znajdowanie i organizowanie żądań ściągnięcia w celu nadania priorytetów najważniejszym plikom w przepływie pracy.

przeglądarka

Aby przefiltrować listę PR, na stronie Żądania ściągnięcia wybierz ikonę Filtr w prawym górnym rogu. Następnie wybierz gałąź Docelowa lub inny nagłówek kolumny, a następnie wybierz gałąź lub inną wartość, dla której chcesz filtrować.

Aby jeszcze bardziej dostosować widok listy pull requestów, wybierz Dostosuj widok w prawym górnym rogu strony Pull requesty.

Na stronie Dostosowywanie widoku można zmienić kolejność bieżących sekcji widoku, edytować je lub usunąć. Aby utworzyć nową sekcję, wybierz pozycję Dodaj sekcję.

Na stronie Dostosuj sekcję wprowadź i wybierz wartości, aby filtrować sekcję według parametrów, takich jak stan wersji roboczej lub data aktualizacji. Możesz wybrać, czy Pokaż żądania ściągnięcia zatwierdzone lub odrzucone na osobnej karcielub Wyklucz żądania ściągnięcia (duplikaty) uwzględnione w poprzednich sekcjach. Po zakończeniu dostosowywania widoku wybierz pozycję Zapisz.

Te dostosowane widoki tworzą oddzielne, składane sekcje na stronie pull requestu. Te zapytania niestandardowe działają również w repozytorium na karcie Moje żądania wyciągnięcia na stronie głównej organizacji.

Aby zmienić parametry dostosowanych widoków, wybierz przycisk Dostosuj obok widoku. Możesz też wybrać Dostosuj widok, a na ekranie Dostosuj widok wybierz widok, który chcesz zmienić. Niektóre widoki, takie jak Przypisane do mnie, nie można dostosować, ale można je zmienić lub usunąć.

Na karcie żądania pull Pliki można użyć kilku filtrów, aby wybrać pliki i komentarze w celu uzyskania szybszej oceny. Wybierz pozycję Filtr, a następnie wybierz jedną z opcji.

• Słowo kluczowe: wprowadź słowo kluczowe.
• Przeglądane/Nieprzeglądane: wszystkie (domyślne), Oczekujące, Przeglądane.
• Pliki z komentarzami: Wszystkie pliki (ustawienie domyślne), Pliki z komentarzami.
• Komentarze: Pokaż (ustawienie domyślne), Co nowego, Ukryj.
• Stan komentarza: Aktywny (ustawienie domyślne), Oczekujący, Rozwiązany, Zgodnie z projektem, Nie naprawi, Zamknięte.
• Skomentowane przez: Wszystkie komentarze (domyślnie) lub konkretnej osoby.

Możesz również wpisać ciąg w polu Wyszukaj, aby wyświetlić pasujące wyniki z poprzednich opcji.

Aby filtrować żądania ściągnięcia z programu Visual Studio:

1. W menu Git wybierz <swoją usługę Git>>Wyświetl Pull Requests.

2. Filtruj według Author, Labellub innych atrybutów.

W widoku żądań ściągnięcia w programie Team Explorer :

• Wybierz Active, Przypisane do mnie lub mojego zespołu, aby filtrować listy pull requestów według ich statusu lub przypisania.
• Możesz również wpisać w polach oraz "Wpisz tutaj, aby przefiltrować listę", aby filtrować listy żądań ściągnięcia według daty, autora, gałęzi lub innych atrybutów.

CLI Azure DevOps

Możesz użyć kilku parametrów az repos pr list do filtrowania listy żądań ściągnięcia, takich jak --creator, --project, --repository, --reviewer, --source-branch, --status, --target-branchi --top.

Wartości --creator i --reviewer mogą być nazwami wyświetlanymi lub adresami e-mail. Parametr --top definiuje maksymalną liczbę pull requestów do listy.

Aby na przykład wyświetlić szczegółowe informacje o ostatnim utworzonym PR-ze, niezależnie od jego stanu, użyj:

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

Otwórz żądanie ściągnięcia

Po otwarciu PR z przeglądarki, z poziomu programu Visual Studio lub z interfejsu wiersza polecenia platformy Azure, w przeglądarce zostanie otwarta strona Przegląd.

przeglądarka

Aby otworzyć wniosek o scalenie w przeglądarce, wybierz go z listy na stronie Wnioski o scalenie. Pull request otwiera się na karcie Przegląd . Karta Przegląd zawiera tytuł pull requestu, opis, recenzentów, powiązane elementy robocze, historię i status. Możesz wyświetlić podsumowanie zasad dotyczących gałęzi, które są akceptowane lub odrzucane, oraz zobaczyć komentarze dodane przez recenzentów.

Na karcie Pliki PR można przejrzeć rzeczywiste zmiany w plikach prośby o ściągnięcie. Na kartach Updates (Aktualizacje) i Commits (Zatwierdzenia), możesz zobaczyć zmiany wprowadzone przez autora w celu zaktualizowania gałęzi PR.

Aby otworzyć żądanie ściągnięcia z programu Visual Studio, w menu Git wybierz pozycję <usługi Git>>Wyświetl żądania ściągnięcia, a następnie wybierz żądanie ściągnięcia, aby je otworzyć.

Lub w widoku Team Explorer pull requests kliknij prawym przyciskiem myszy żądanie ściągnięcia i wybierz pozycję Otwórz w przeglądarce, aby otworzyć żądanie ściągnięcia w portalu internetowym.

Sprawdź gałąź

W programie Visual Studio 2019 możesz pobrać gałąź źródłową pull requesta bezpośrednio z widoku Pull Requests. Kliknij prawym przyciskiem myszy pull request i wybierz wyewidencjonuj gałąź źródłową.

Notatka

Program Visual Studio 2019 w wersji 16.8 lub nowszej udostępnia nowe menu Git do zarządzania przepływem pracy usługi Git z mniejszym przełączaniem kontekstu niż program Team Explorer. Procedury podane w tym artykule na karcie Visual Studio zawierają informacje dotyczące korzystania z środowiska Git oraz programu Team Explorer. Aby uzyskać więcej informacji, zobacz porównanie równoległe usług Git i Team Explorer.

Azure DevOps CLI

Aby wyświetlić szczegóły pojedynczego żądania ściągnięcia, użyj polecenia az repos pr show z wymaganym parametrem --id. Aby otworzyć PR w przeglądarce, użyj --open.

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

Parametry

Parametr	Opis
--id	Identyfikator żądania ściągnięcia. wymagane.
--detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
--open	Otwórz pull request w przeglądarce internetowej.
--org --organization	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu az devops configure -d organization=<ORG_URL>. wymagana, jeśli nie została skonfigurowana jako domyślna lub przejęta za pośrednictwem git config. Przykład: https://dev.azure.com/MyOrganizationName/.
--query-examples	Zalecany ciąg JMESPath. Możesz skopiować jedno z zapytań i wkleić je po parametrze --query w podwójnym cudzysłowie, aby wyświetlić wyniki. Możesz dodać co najmniej jedno słowo kluczowe pozycyjne, aby sugestie były oparte na tych słowach kluczowych.
--subscription	Nazwa lub identyfikator subskrypcji platformy Azure. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s <NAME_OR_ID>.

Przykład

Poniższy przykład przedstawia szczegóły żądania ściągnięcia nr 21, wyświetla dane wyjściowe polecenia jako tabelę i otwiera żądanie ściągnięcia w przeglądarce:

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

Sprawdź gałąź

Użyj az repos pr checkout z wymaganym parametrem --id, aby sprawdzić lokalnie gałąź pull request, pod warunkiem że nie ma lokalnych zmian.

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

Parametry

Parametr	Opis
--id	Identyfikator żądania ściągnięcia.
--remote-name	Nazwa zdalnego repozytorium Git, do którego jest zgłaszane żądanie ściągnięcia. Wartość domyślna: origin.
--subscription	Nazwa lub identyfikator subskrypcji platformy Azure. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s <NAME_OR_ID>.

Przykład

Aby na przykład wyewidencjonować gałąź żądania ściągnięcia nr 21 lokalnie, użyj polecenia:

az repos pr checkout --id 21

Aby przejrzeć zmiany, dodać komentarze lub sugestie albo zatwierdzić lub zagłosować na pull request, zobacz Przegląd pull requestów.

Wyświetlanie i aktualizowanie pull requestów z urządzenia przenośnego

Urządzenia mobilne pozwalają na wyświetlanie wszystkich ekranów PR w Azure Repos i podejmowanie działań.

Następne kroki

Przeglądanie żądań ściągnięcia

Powiązane artykuły

• Utwórz pull request
• powiadomienia o aktualizacjach pull requestów
• ukończ żądanie ściągnięcia
• Zmień domyślną gałąź
• Kopiowanie zmian za pomocą cherry-pick
• Informacje o pull requestach i uprawnieniach