Wyświetlanie, filtrowanie i otwieranie żądań ściągnięcia

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.

Wymagania wstępne

• Repozytoria muszą być włączone w 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łączenia repozytoriów.

• Aby wyświetlić żądania ściągnięcia, musisz być członkiem projektu usługi Azure DevOps, w którym znajduje się żądanie ściągnięcia, z dostępem podstawowym lub wyższym. Jeśli nie jesteś członkiem projektu, dodaj go.

  Uwaga

  W przypadku projektów publicznych użytkownicy, którym udzielono dostępu uczestnikom projektu , mają pełny dostęp do usługi Azure Repos.

• Aby uzyskać więcej informacji o uprawnieniach i dostępie, zobacz Domyślne repozytorium Git i uprawnienia gałęzi oraz Informacje o poziomach dostępu.

• W usługach Azure DevOps Services możesz zarządzać żądaniami ściągnięcia i innymi zasobami z poziomu interfejsu azure-devops wiersza polecenia platformy Azure za pomocą rozszerzenia . 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 interfejsu wiersza polecenia usługi Azure Repos dla żądań ściągnięcia używają polecenia az repos pr.

Wyświetlanie listy żądań ściągnięcia

Żą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, przejdź do tego projektu w portalu internetowym i wybierz pozycję Żądania ściągnięcia repozytoriów>.

   

2. Sprawdź, czy wybrano poprawne repozytorium.

   

3. Widok domyślny pokazuje żądania ściągnięcia na karcie Kopalnia . Wybierz pozycję Aktywne , aby wyświetlić wszystkie aktywne żądania ściągnięcia dla bieżącego repozytorium. Wybierz pozycję Ukończono lub Porzucony , aby wyświetlić listy zamkniętych żądania ściągnięcia.

   Wybierz dowolne żądanie ściągnięcia na liście, aby przejść do strony Przegląd żądania ściągnięcia.

   

4. Możesz wyświetlić listę wszystkich żądań ściągnięcia w różnych projektach w organizacji, wybierając pozycję Żądania ściągnięcia w widoku Moja praca .

   

Program Visual Studio

Aby wyświetlić listę żądań ściągnięcia z programu Visual Studio, w menu Git wybierz< pozycję Wyświetl żądania ściągnięcia w usłudze>>Git.

Program Visual Studio 2019 w wersji 16.8 lub nowszej zapewnia środowisko kontroli wersji usługi Git przy zachowaniu interfejsu użytkownika programu Git programu Team Explorer . Aby użyć programu Team Explorer, usuń zaznaczenie pozycji Opcje narzędzi>>w wersji zapoznawczej Funkcje>nowego środowiska użytkownika usługi Git na pasku menu. Funkcje usługi Git można wykonywać z dowolnego interfejsu zamiennie.

Aby uzyskać dostęp do żądania ściągnięcia z poziomu programu Visual Studio Team Explorer:

1. Nawiąż połączenie z projektem z poziomu programu Visual Studio.

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

3. W obszarze 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ę żądań ściągnięcia w portalu internetowym usługi Azure DevOps, wybierz pozycję Akcje , a następnie wybierz pozycję Otwórz w przeglądarce.

   

Interfejs wiersza polecenia usługi Azure DevOps

Aby wyświetlić listę aktywnych żądań ściągnięcia w projekcie ze swoimi 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 żądania ściągnięcia.
--org --organization	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 polecenia az devops configure -d project=<NAME_OR_ID>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git.
--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.
--repository -r	Nazwa lub identyfikator repozytorium.
--reviewer	Ogranicz wyniki do żądań ściągnięcia, w których ten użytkownik jest recenzentem.
--skip	Liczba żądań ściągnięcia 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, , activeall, completed.
--subscription	Nazwa lub identyfikator subskrypcji platformy Azure. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s <NAME_OR_ID>.
--target-branch -t	Ogranicz wyniki do żądań ściągnięcia przeznaczonych dla tej gałęzi.
--top	Maksymalna liczba żądań ściągnięcia do listy.

Przykład

Poniższe polecenie wyświetla listę wszystkich żądania ściągnięcia w repozytorium, niezależnie od stanu, i wyświetla dane wyjściowe w tabeli. W przykładzie użyto konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"domyślnej .

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

Definiowanie niestandardowego widoku żądania ściągnięcia

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ę żądań ściągnięcia, na stronie Żądania ściągnięcia wybierz ikonę Filtr w prawym górnym rogu. Następnie wybierz pozycję 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 żądań ściągnięcia, wybierz pozycję Dostosuj widok w prawym górnym rogu strony Żądania ściągnięcia.

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 Dostosowywanie sekcji wprowadź i wybierz wartości, aby filtrować sekcję według parametrów, takich jak stan wersji roboczej lub data aktualizacji. Możesz wybrać , czy mają być wyświetlane żądania ściągnięcia zatwierdzone, czy odrzucone na osobnej karcie, lub Wyklucz żądania ściągnięcia (duplikaty) uwzględnione w poprzednich sekcjach. Po zakończeniu dostosowywania widoku wybierz pozycję Zapisz.

Te dostosowane widoki tworzą oddzielne, zwijane sekcje na stronie żądania ściągnięcia. Te zapytania niestandardowe działają również w repozytoriach na karcie Moje żądania ściągnięcia na stronie głównej organizacji.

Aby zmienić parametry dostosowanych widoków, wybierz przycisk Dostosuj obok widoku. Możesz też wybrać pozycję Dostosuj widok, a następnie na ekranie Dostosowywanie widoku wybierz widok, który chcesz zmienić. Niektórych widoków, takich jak Przypisane do mnie, nie można dostosować, ale można je zmienić lub usunąć.

Na karcie Pliki żądania ściągnięcia można użyć kilku filtrów, aby wybrać pliki i komentarze, aby szybciej przeglądać. Wybierz pozycję Filtr, a następnie wybierz jedną z opcji.

• Słowo kluczowe: wprowadź słowo kluczowe.
• Przejrzysz/Nieoglądane: Wszystkie (domyślne), Oczekujące, Przejrzydzone.
• Skomentowane pliki: wszystkie pliki (domyślne), Pliki z komentarzami.
• Komentarze: Pokaż (ustawienie domyślne), Co nowego, Ukryj.
• Stan komentarza: Aktywny (ustawienie domyślne), Oczekujące, Rozwiązane, Zgodnie z założeniami, Nie naprawi, Zamknięte.
• Komentarz: Wszystkie komentarze (ustawienie domyślne) lub określona osoba.

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

Program Visual Studio

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

1. W menu Git wybierz< pozycję Wyświetl żądania ściągnięcia w usłudze>>Git.

2. Filtruj według atrybutów Author, Label lub other.

W widoku Żądania ściągnięcia programu Team Explorer:

• Wybierz pozycję Aktywne lub Przypisane do mnie lub mojego zespołu, aby filtrować listy żądań ściągnięcia według stanu żądania ściągnięcia lub przypisania.
• Możesz też wpisać tutaj typ, aby filtrować pola listy w celu filtrowania list żądań ściągnięcia według daty, autora, gałęzi lub innych atrybutów.

Interfejs wiersza polecenia usługi Azure DevOps

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

Wartości --creator i --reviewer mogą być nazwami wyświetlanymi lub adresami e-mail. Parametr --top definiuje maksymalną liczbę żądania ściągnięcia do wyświetlenia.

Aby na przykład wyświetlić szczegółowe informacje o ostatnim utworzonym żądaniu ściągnięcia, niezależnie od jego stanu, użyj:

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

Otwieranie żądania ściągnięcia

Po otwarciu żądania ściągnięcia z przeglądarki z poziomu programu Visual Studio lub interfejsu wiersza polecenia platformy Azure zostanie otwarta strona Przegląd żądania ściągnięcia w przeglądarce.

Przeglądarka

Aby otworzyć żądanie ściągnięcia w przeglądarce, wybierz żądanie ściągnięcia z listy na stronie Żądania ściągnięcia. Żądanie ściągnięcia zostanie otwarte na karcie Przegląd . Karta Przegląd zawiera tytuł żądania ściągnięcia, opis, recenzentów, połączone elementy robocze, historię i stan. Możesz wyświetlić podsumowanie zasad gałęzi, które przechodzą lub kończą się niepowodzeniem, i zobaczyć komentarze recenzentów.

Na karcie Pliki żądania ściągnięcia można przejrzeć rzeczywiste zmiany w plikach żądania ściągnięcia. Na kartach Aktualizacje i zatwierdzenia można zobaczyć zmiany wprowadzone przez autora w celu zaktualizowania gałęzi żądania ściągnięcia.

Program Visual Studio

Aby otworzyć żądanie ściągnięcia z programu Visual Studio, w menu Git wybierz <pozycję Usługa 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 (Żądania ściągnięcia w programie Team Explorer) kliknij prawym przyciskiem myszy żądanie ściągnięcia i wybierz polecenie Otwórz w przeglądarce, aby otworzyć żądanie ściągnięcia w portalu internetowym.

Wyewidencjonowywanie gałęzi

W programie Visual Studio 2019 możesz wyewidencjonować gałąź źródłową żądania ściągnięcia bezpośrednio z widoku Żądania ściągnięcia. Kliknij prawym przyciskiem myszy żądanie ściągnięcia i wybierz polecenie Wyewidencjonuj gałąź źródłową.

Uwaga

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.

Interfejs wiersza polecenia usługi Azure DevOps

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

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

Parametry

Parametr	Opis
--id	Identyfikator żądania ściągnięcia. Wymagany.
--detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
--open	Otwórz żądanie ściągnięcia w przeglądarce internetowej.
--org --organization	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. 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 polecenia 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

Wyewidencjonowywanie gałęzi

Użyj polecenia az repos pr checkout z wymaganym --id parametrem, aby wyewidencjonować lokalnie gałąź żądania ściągnięcia, o ile nie ma żadnych lokalnych zmian.

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

Parametry

Parametr	Opis
--id	Identyfikator żądania ściągnięcia.
--remote-name	Nazwa zdalnej usługi Git, względem której 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 polecenia 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 głosować na żądanie ściągnięcia, zobacz Przeglądanie żądań ściągnięcia.

Wyświetlanie i aktualizowanie żądań ściągnięcia z urządzenia przenośnego

Urządzenia przenośne umożliwiają wyświetlanie wszystkich ekranów żądania ściągnięcia usługi Azure Repos i wykonywanie akcji.

Następne kroki

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

Powiązane artykuły

• Tworzenie żądania ściągnięcia
• Powiadomienia o aktualizacji żądania ściągnięcia
• Ukończ żądanie ściągnięcia
• Zmienianie gałęzi domyślnej
• Kopiowanie zmian za pomocą funkcji cherry-pick
• Informacje o żądaniach ściągnięcia i uprawnieniach