Tworzenie żądań ściągnięcia

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

Visual Studio 2019 | Visual Studio 2022

Tworzenie żądań ściągnięcia w celu zmiany, przeglądania i scalania kodu w repozytorium Git. Żądania ściągnięcia można utworzyć z gałęzi w repozytorium nadrzędnym lub z gałęzi w rozwidleniu repozytorium. Twój zespół może przejrzeć żądania ściągnięcia i przekazać opinię na temat zmian. Recenzenci mogą przechodzić przez proponowane zmiany, pozostawiać komentarze i głosować, aby zatwierdzić lub odrzucić żądania ściągnięcia. W zależności od zasad gałęzi i innych wymagań żądanie ściągnięcia może wymagać spełnienia różnych kryteriów, zanim będzie można ukończyć żądanie ściągnięcia i scalić zmiany w gałęzi docelowej.

Aby uzyskać wskazówki dotyczące żądania ściągnięcia i zagadnienia dotyczące zarządzania, zobacz About pull requests (Informacje o żądaniach ściągnięcia).

Wymagania wstępne

• Dostęp:
  • Dostęp podstawowy: aby wyświetlić lub przejrzeć żądania ściągnięcia, musisz być członkiem projektu usługi Azure DevOps z co najmniej dostępem podstawowym.
  • Dostęp uczestników projektu: w przypadku projektów publicznych użytkownicy, którym udzielono dostępu uczestnikom projektu, mają pełny dostęp do usługi Azure Repos.
• Uprawnienia:
  • Włączone repozytoria: 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.
  • Członkostwo w projekcie:
    • Jeśli nie masz projektu, utwórz go lub zarejestruj się bezpłatnie.
    • Jeśli nie jesteś członkiem projektu, dodaj go.
  • Grupa zabezpieczeń Czytelników: Aby współtworzyć żądanie ściągnięcia, musisz być członkiem grupy zabezpieczeń Czytelnicy lub mieć odpowiednie uprawnienia.
  • Współautorzy grupy zabezpieczeń: aby utworzyć i ukończyć żądanie ściągnięcia, musisz być członkiem grupy zabezpieczeń Współautorzy lub mieć odpowiednie uprawnienia.
• Narzędzia:
  • Interfejs wiersza polecenia usługi Azure DevOps: możesz utworzyć żądania ściągnięcia i zarządzać nimi za pomocą interfejsu azure-devops wiersza polecenia platformy Azure za pomocą rozszerzenia . Aby uzyskać więcej informacji, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Azure DevOps.
    • Polecenia interfejsu wiersza polecenia usługi Azure Repos dla żądania ściągnięcia używają polecenia az repos pr.

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.

Tworzenie żądania ściągnięcia

Nowe żądanie ściągnięcia można utworzyć z witryny internetowej projektu DevOps platformy Azure z poziomu programu Visual Studio lub interfejsu wiersza polecenia usługi Azure DevOps.

Przeglądarka

W witrynie internetowej projektu Usługi Azure DevOps możesz utworzyć nowe żądanie ściągnięcia na podstawie:

• Strona Żądania ściągnięcia.
• Gałąź funkcji wypchnięta do repozytorium.
• Istniejące żądanie ściągnięcia przy użyciu cherry-pick.
• Kontrolka Programowanie w połączonym elemencie roboczym usługi Azure Boards.

Tworzenie żądania ściągnięcia na stronie Żądania ściągnięcia

Żądania ściągnięcia dla dowolnej gałęzi można utworzyć na stronie Żądania ściągnięcia projektu w Internecie.

1. Na stronie Żądania ściągnięcia repozytoriów>wybierz pozycję Nowe żądanie ściągnięcia w prawym górnym rogu.

   

2. Wybierz gałąź ze zmianami i gałąź, do której chcesz scalić zmiany, na przykład gałąź główna.

   

3. Wprowadź szczegóły żądania ściągnięcia i utwórz żądanie ściągnięcia.

Tworzenie żądania ściągnięcia na podstawie wypychanej gałęzi

Po wypchnięciu lub zaktualizowaniu gałęzi funkcji usługa Azure Repos wyświetla monit o utworzenie żądania ściągnięcia.

• Na stronie Żądania ściągnięcia:

  

• Na stronie Pliki:

  

Wybierz pozycję Utwórz żądanie ściągnięcia, aby przejść do strony, na której można wprowadzić szczegóły żądania ściągnięcia i utworzyć żądanie ściągnięcia.

Tworzenie żądania ściągnięcia na podstawie połączonego elementu roboczego

Żądanie ściągnięcia można utworzyć bezpośrednio z elementu roboczego usługi Azure Boards połączonego z gałęzią.

1. W usłudze Azure Boards z listy prac lub zapytań w widoku Praca otwórz element roboczy połączony z gałęzią.

2. W obszarze Programowanie elementu roboczego wybierz pozycję Utwórz żądanie ściągnięcia.

   

Link umożliwia przejście do strony, na której można wprowadzić szczegóły żądania ściągnięcia i utworzyć żądanie ściągnięcia.

Program Visual Studio

Aby utworzyć żądanie ściągnięcia:

1. W menu Git wybierz pozycję Zarządzaj gałęziami.

2. Kliknij prawym przyciskiem myszy gałąź i wybierz polecenie Utwórz żądanie ściągnięcia.

3. Edytuj gałęzie źródłowe i docelowe zgodnie z potrzebami, wprowadź tytuł i opcjonalny opis, a następnie wybierz pozycję Utwórz.

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 utworzyć żą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. W widoku Żądania ściągnięcia wybierz pozycję Nowe żądanie ściągnięcia.

   

5. Wybierz gałęzie źródłowe i docelowe, wprowadź tytuł i opcjonalny opis, a następnie wybierz pozycję Utwórz.

   

6. Po utworzeniu żądania ściągnięcia wybierz pozycję Otwórz w przeglądarce , aby otworzyć nowe żądanie ściągnięcia w portalu internetowym usługi Azure DevOps.

Żądania ściągnięcia można również utworzyć z widoku Gałęzie w programie Team Explorer, klikając prawym przyciskiem myszy nazwę gałęzi i wybierając polecenie Utwórz żądanie ściągnięcia.

Interfejs wiersza polecenia usługi Azure DevOps

Aby utworzyć nowe żądanie ściągnięcia w projekcie, użyj polecenia az repos pr create. Aby otworzyć żądanie ściągnięcia w przeglądarce po utworzeniu, użyj parametru --open .

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]

Parametry

Parametr	Opis
--auto-complete	Ustaw żądanie ściągnięcia tak, aby zostało ukończone automatycznie i scaliło się z gałęzią docelową po przekazaniu wszystkich zasad. Zaakceptowane wartości: false, true.
--bypass-policy	Pomiń wszystkie wymagane zasady i ukończ żądanie ściągnięcia po scaleniu. Zaakceptowane wartości: false, true.
--bypass-policy-reason	Przyczyna pomijania wymaganych zasad.
--delete-source-branch	Usuń gałąź źródłową po zakończeniu żądania ściągnięcia i scaleniu jej z gałęzią docelową. Zaakceptowane wartości: false, true.
--description -d	Opis nowego żądania ściągnięcia, który może zawierać język Markdown. Każda wartość to nowy wiersz. Na przykład: --description "First Line" "Second Line".
--detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
--draft	Utwórz żądanie ściągnięcia w trybie roboczym w toku. Zaakceptowane wartości: false, true.
--merge-commit-message	Komunikat wyświetlany podczas scalania zatwierdzeń.
--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/.
--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.
--repository -r	Nazwa lub identyfikator repozytorium do utworzenia żądania ściągnięcia. Wymagany parametr interfejsu .
--reviewers	Dodatkowi użytkownicy lub grupy do uwzględnienia jako recenzenci w nowym żądaniu ściągnięcia. Spacja oddzielona.
--source-branch -s	Nazwa gałęzi źródłowej. Przykład: "dev".
--squash	Squash zatwierdzenia w gałęzi źródłowej podczas scalania z gałęzią docelową. Zaakceptowane wartości: false, true.
--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	Nazwa gałęzi docelowej. Jeśli nie zostanie określony, domyślnie zostanie ustawiona domyślna gałąź repozytorium docelowego.
--title	Tytuł nowego żądania ściągnięcia.
--transition-work-items	Przeniesienie wszystkich elementów roboczych połączonych z żądaniem ściągnięcia do następnego stanu logicznego, gdy żądanie ściągnięcia zmieni stan. Na przykład zmień aktywne elementy robocze na Rozwiązane. Zaakceptowane wartości: false, true.
--work-items	Identyfikatory elementów roboczych do łączenia z nowym żądaniem ściągnięcia. Spacja oddzielona.

Przykład

Następujące polecenie tworzy żądanie ściągnięcia z new gałęzi do domyślnej main gałęzi repozytorium Fabrikam, otwiera żądanie ściągnięcia w przeglądarce i wyświetla dane wyjściowe polecenia w tabeli. W przykładzie użyto konfiguracji domyślnej: 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

Możesz dodać wiele innych szczegółów żądania ściągnięcia na stronie lub po utworzeniu żądania ściągnięcia. Aby dodać szczegóły, recenzentów, elementów roboczych i opcji uzupełniania do żądania ściągnięcia, zobacz Dodawanie szczegółów lub edytowanie żądań ściągnięcia.

Dodawanie aktualizacji przy użyciu funkcji cherry-pick

Zatwierdzenia można skopiować z jednej gałęzi do innej przy użyciu polecenia cherry-pick. W przeciwieństwie do scalania lub ponownej bazy, wybór wiśni powoduje tylko zmiany z wybranych zatwierdzeń, zamiast wszystkich zmian w gałęzi.

Aby wybrać zmiany z ukończonego żądania ściągnięcia, wybierz pozycję Cherry-pick na stronie Przegląd żądania ściągnięcia. Aby skopiować zmiany z aktywnego żądania ściągnięcia, wybierz pozycję Cherry-pick z menu Więcej opcji żądania ściągnięcia. Ta akcja powoduje utworzenie nowej gałęzi z skopiowanymi zmianami. Następnie możesz utworzyć nowe żądanie ściągnięcia z nowej gałęzi. Aby uzyskać szczegółowe instrukcje, zobacz Kopiowanie zmian za pomocą funkcji cherry-pick.

Przełączanie gałęzi źródłowych i docelowych żądania ściągnięcia

Przed pierwszym zapisaniem żądania ściągnięcia można przełączyć gałęzie źródłowe i docelowe żądania ściągnięcia, wybierając ikonę Przełącz źródło i gałęzie docelowe obok nazw gałęzi. Gdy żądanie ściągnięcia jest aktywne, ta ikona zniknie, ale nadal można zmienić gałąź docelową żądania ściągnięcia.

Korzystanie z szablonów żądań ściągnięcia

Szablon żądania ściągnięcia to plik zawierający tekst markdown, który wypełnia opis żądania ściągnięcia podczas tworzenia żądania ściągnięcia. Dobre opisy żądań ściągnięcia informują recenzentów żądań ściągnięcia i mogą pomóc w śledzeniu zadań, takich jak dodawanie testów jednostkowych i aktualizowanie dokumentacji. Twój zespół może utworzyć domyślny szablon żądania ściągnięcia, który dodaje tekst do wszystkich nowych opisów żądań ściągnięcia w repozytorium. Ponadto możesz wybrać szablony specyficzne dla gałęzi lub inne szablony zdefiniowane przez zespół. Aby uzyskać więcej informacji na temat tworzenia i używania szablonów żądań ściągnięcia, zobacz Ulepszanie opisów żądań ściągnięcia przy użyciu szablonów.

Jeśli repozytorium ma szablon domyślny, wszystkie żądania ściągnięcia w repozytorium mają domyślny tekst opisu szablonu podczas tworzenia. Aby dodać inne szablony, wybierz pozycję Dodaj szablon , a następnie wybierz szablon z listy rozwijanej. Możesz edytować tekst szablonu w opisie, usunąć go lub dodać inny tekst.

Tworzenie wersji roboczej żądania ściągnięcia

Jeśli żądanie ściągnięcia nie jest gotowe do przeglądu, możesz utworzyć wersję roboczą żądania ściągnięcia, aby wskazać postęp pracy. Gdy żądanie ściągnięcia jest gotowe do przeglądu, możesz go opublikować i rozpocząć lub wznowić proces pełnego przeglądu.

Wersje robocze żądania ściągnięcia mają następujące różnice w porównaniu z opublikowanymi żądaniami ściągnięcia:

• Zasady weryfikacji kompilacji nie są uruchamiane automatycznie. Walidacje kompilacji można kolejkować ręcznie, wybierając menu więcej opcji w żądaniu ściągnięcia.

• Głosowanie jest wyłączone w trybie roboczym.

• Wymagani recenzenci nie są automatycznie dodawani. Powiadomienia są wysyłane tylko do recenzentów jawnie dodanych do wersji roboczej żądania ściągnięcia.

• Wersja robocza żądań ściągnięcia jest wyświetlana na liście żądań ściągnięcia z znaczkiem Wersja robocza.

  

Przeglądarka

Aby utworzyć wersję roboczą żądania ściągnięcia, wybierz strzałkę obok pozycji Utwórz i wybierz pozycję Utwórz jako wersję roboczą podczas tworzenia żądania ściągnięcia . Nie musisz używać prefiksów tytułu, takich jak WIP lub NIE SCALAJ.

Gdy wszystko będzie gotowe do przejrzenia i ukończenia żądania ściągnięcia, wybierz pozycję Publikuj w prawym górnym rogu żądania ściągnięcia. Publikowanie żądania ściągnięcia przypisuje wymaganych recenzentów, ocenia zasady i rozpoczyna głosowanie.

Aby zmienić istniejące opublikowane żądanie ściągnięcia na wersję roboczą, wybierz pozycję Oznacz jako wersję roboczą. Oznaczanie żądania ściągnięcia jako projekt usuwa wszystkie istniejące głosy.

Program Visual Studio

Aby ustawić żądanie ściągnięcia na wersję roboczą, otwórz żądanie ściągnięcia i wybierz pozycję Oznacz jako wersję roboczą.

• Aby otworzyć żądanie ściągnięcia z programu Visual Studio, w menu Git wybierz <pozycję Usługa Git>>Wyświetl żądania ściągnięcia i wybierz żądanie ściągnięcia, aby je otworzyć.
• Aby otworzyć żądanie ściągnięcia z programu Visual Studio Team Explorer, w widoku Żądania ściągnięcia kliknij prawym przyciskiem myszy żądanie ściągnięcia i wybierz polecenie Otwórz w przeglądarce.

Interfejs wiersza polecenia usługi Azure DevOps

Aby utworzyć żądanie ściągnięcia jako wersję roboczą, ustaw --draft parametr na true wartość podczas tworzenia żądania ściągnięcia. (Wymaga programu Azure DevOps Server 2020 lub nowszej wersji).

Na przykład:

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

Aby ustawić istniejące żądanie ściągnięcia na wersję roboczą, użyj polecenia az repos pr update --id <PR Id> --draft true.

Aby usunąć stan wersji roboczej z żądania ściągnięcia, ustaw wartość --draft false.

Dodawanie lub edytowanie tytułu i opisu żądania ściągnięcia

Przeglądarka

Na stronie Nowe żądanie ściągnięcia wprowadź tytuł i szczegółowy opis zmian, aby inni mogli zobaczyć, jakie problemy rozwiązuje zmiany. W przypadku nowego żądania ściągnięcia, tak jak w istniejących żądaniach ściągnięcia, możesz zobaczyć pliki i zatwierdzenia w żądaniu ściągnięcia na osobnych kartach. Możesz dodawać recenzentów, łączyć elementy robocze i dodawać tagi do żądania ściągnięcia.

Gdy wszystko będzie gotowe do przejrzenia zmian, wybierz pozycję Utwórz , aby utworzyć żądanie ściągnięcia.

Nie martw się, jeśli nie masz wszystkich elementów roboczych, recenzentów ani szczegółów gotowych podczas tworzenia żądania ściągnięcia. Te elementy można dodawać lub aktualizować po utworzeniu żądania ściągnięcia.

Edytowanie tytułu i opisu żądania ściągnięcia

Zachowaj aktualność tytułu i opisu żądania ściągnięcia, aby recenzenci mogli zrozumieć zmiany w żądaniu ściągnięcia.

Tytuł istniejącego żądania ściągnięcia można zaktualizować, wybierając bieżący tytuł i aktualizując tekst. Wybierz ikonę Zapisz , aby zapisać zmiany, lub wybierz ikonę Cofnij , aby odrzucić zmiany.

Edytuj opis żądania ściągnięcia, wybierając ikonę Edytuj w sekcji Opis .

Program Visual Studio

Podczas tworzenia żądania ściągnięcia w programie Visual Studio wprowadź tytuł i szczegółowy opis zmian, aby inni mogli zobaczyć, jakie problemy rozwiązuje zmiany. Zachowaj aktualność tych pól, aby recenzenci mogli zrozumieć zmiany w żądaniu ściągnięcia.

Aby edytować tytuł, opis lub inne szczegóły w istniejącym żądaniu ściągnięcia, otwórz żądanie ściągnięcia w przeglądarce.

Interfejs wiersza polecenia usługi Azure DevOps

Szczegóły podczas tworzenia żądania ściągnięcia można dodać za pomocą polecenia az repos pr create lub zaktualizować szczegóły w istniejących żądaniach ściągnięcia za pomocą polecenia az repos pr update.

Podczas tworzenia żądania ściągnięcia za pomocą az repos pr createpolecenia dodaj element --title i szczegółowy opis --description zmian, aby inni mogli zobaczyć, jakie problemy rozwiązuje zmiany. Parametr --description akceptuje wpis markdown, a każda wartość w argumencie jest nowym wierszem opisu żądania ściągnięcia.

Na przykład:

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

Zachowaj aktualność tych pól, aby recenzenci mogli zrozumieć zmiany w żądaniu ściągnięcia. Aby zaktualizować szczegóły żądania ściągnięcia, użyj az repos pr update wymaganego parametru żądania ściągnięcia --id .

Aby na przykład zaktualizować tytuł i opis żądania ściągnięcia nr 21, użyj:

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

Dodawanie recenzentów do żądania ściągnięcia

Przeglądarka

Recenzentów można dodać w sekcji Recenzenci nowego lub istniejącego żądania ściągnięcia. Możesz również wprowadzić istniejących opcjonalnych recenzentów lub zmienić wymaganych recenzentów, aby je opcjonalnie lub usunąć, chyba że są one wymagane przez zasady.

Zasady gałęzi mogą wymagać minimalnej liczby recenzentów lub automatycznie uwzględnić niektórych opcjonalnych lub wymaganych recenzentów w żądaniach ściągnięcia. Nie można usunąć recenzentów wymaganych przez zasady gałęzi. Możesz zmienić opcjonalnych recenzentów zasad gałęzi, aby były wymagane lub usunąć je.

Aby wyświetlić zasady gałęzi, które automatycznie dodały recenzenta, w sekcji Recenzenci strony Przegląd żądania ściągnięcia kliknij prawym przyciskiem myszy pozycję Więcej opcji obok recenzenta.

Jeśli użytkownik lub grupa, której chcesz przejrzeć żądanie ściągnięcia, nie jest członkiem projektu, musisz dodać je do projektu , zanim będzie można dodać je jako recenzentów.

Aby dodać recenzentów do nowego żądania ściągnięcia:

1. Na stronie Nowe żądanie ściągnięcia w obszarze Recenzenci wybierz pozycję Wyszukaj użytkowników i grupy, aby dodać jako recenzentów.
2. Podczas wprowadzania nazwy lub adresu e-mail lista rozwijana zawiera listę pasujących użytkowników i grup. Wybierz nazwy z listy, aby dodać jako opcjonalnych recenzentów.
3. Aby dodać wymaganych recenzentów, wybierz pozycję Dodaj wymaganych recenzentów, a następnie wybierz pozycję Wyszukaj, aby dodać wymaganych recenzentów do wyszukiwania i wybierania nazw.

Aby dodać recenzentów do istniejącego żądania ściągnięcia:

1. W sekcji Recenzenci na stronie Przegląd wybierz pozycję Dodaj, a następnie wybierz pozycję Wymagany recenzent lub Opcjonalny recenzent.

   

2. Podczas wprowadzania nazwy lub adresu e-mail zostanie wyświetlona lista pasujących użytkowników lub grup. Wybierz nazwy, które mają zostać dodane jako recenzenci.

   

Aby zmienić recenzenta między wymaganym i opcjonalnym lub usunąć recenzenta, wybierz pozycję Więcej opcji po prawej stronie nazwy recenzenta. Aby wyświetlić członkostwo grupy lub zespołu wyznaczonego jako recenzent, wybierz ikonę grupy.

Program Visual Studio

Aby dodać recenzentów, otwórz żądanie ściągnięcia w przeglądarce, a następnie wprowadź aktualizacje na stronie Przegląd żądania ściągnięcia .

Interfejs wiersza polecenia usługi Azure DevOps

Możesz dodać opcjonalnych recenzentów do żądania ściągnięcia podczas tworzenia za pomocą polecenia
az repos pr create --reviewer "<Reviewer Name>" "<Another Reviewer>".

Na przykład:

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

Aby dodać wymaganych recenzentów lub zmienić recenzentów między opcjonalnymi i wymaganymi, otwórz i zaktualizuj żądanie ściągnięcia w przeglądarce.

Aby zarządzać recenzentami dla istniejącego żądania ściągnięcia, użyj polecenia az repos pr reviewer.

• Aby dodać recenzentów do istniejącego żądania ściągnięcia, użyj polecenia
  az repos pr reviewer add --id <PR Id> --reviewer "<Reviewer Name>" "<Another Reviewer>".
• Aby wyświetlić listę recenzentów żądania ściągnięcia, użyj polecenia az repos pr reviewer list --id <PR Id>.
• Aby usunąć recenzentów z żądania ściągnięcia, użyj polecenia az repos pr reviewer remove --id <PR Id> --reviewer "<Reviewer Name>".

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

Parametry

Parametr	Opis
--id	Identyfikator żądania ściągnięcia. Wymagany.
--reviewers	Użytkownicy lub grupy do uwzględnienia jako recenzenci w żądaniu ściągnięcia. Spacja oddzielona. Wymagany.
--detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
--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/.
--subscription	Nazwa lub identyfikator subskrypcji platformy Azure. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s <NAME_OR_ID>.

Łączenie elementów roboczych z żądaniem ściągnięcia

Przeglądarka

Aby połączyć elementy robocze z nowym żądaniem ściągnięcia:

1. Na stronie Nowe żądanie ściągnięcia w obszarze Elementy robocze do połączenia wybierz pozycję Wyszukaj elementy robocze według identyfikatora lub tytułu.
2. Zacznij wprowadzać identyfikator lub tytuł elementu roboczego, a następnie wybierz element roboczy do połączenia z wyświetlonej listy rozwijanej. Wyszukiwanie według tytułu zwraca elementy robocze filtrowane według stanu; wszystkie elementy robocze ze stanami z kategoriami stanu Ukończono i Usunięte są wykluczone. Te elementy robocze są również filtrowane według daty i użytkownika, przy użyciu tylko elementów utworzonych lub zaktualizowanych w ciągu ostatnich 30 dni i powinny być tworzone przez, przypisane lub autoryzowane jako bieżący użytkownik.

Aby połączyć elementy robocze z istniejącym żądaniem ściągnięcia:

1. Na karcie Przegląd żądania ściągnięcia w obszarze Elementy robocze wybierz pozycję +.

   

2. Wprowadź identyfikator elementu roboczego lub wyszukaj tytuł elementu roboczego. Wybierz element roboczy z wyświetlonej listy.

Usuń link elementu roboczego, wybierając ikonę x obok elementu roboczego. Usunięcie łącza spowoduje usunięcie tylko połączenia między elementem roboczym a żądaniem ściągnięcia. Linki utworzone w gałęzi lub z zatwierdzeń pozostają w elemencie roboczym.

Program Visual Studio

Aby połączyć elementy robocze, otwórz żądanie ściągnięcia w przeglądarce, a następnie wprowadź aktualizacje na stronie Przegląd żądania ściągnięcia .

Interfejs wiersza polecenia usługi Azure DevOps

Elementy robocze usługi Azure Boards można połączyć z żądaniami ściągnięcia az repos pr create --work-items <Id1> <Id2>przy użyciu metody , gdzie <identyfikator jest identyfikatorem> elementu roboczego.

Na przykład następujące polecenie łączy elementy robocze #63 i #64 z nowym żądaniem ściągnięcia w new gałęzi:

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

Aby zarządzać elementami roboczymi dla istniejącego żądania ściągnięcia, użyj polecenia az repos pr work-item.

• Aby połączyć elementy robocze z istniejącym żądaniem ściągnięcia, użyj polecenia az repos pr work-item add --id <PR Id> --work-items <Id1> <Id2>.
• Aby wyświetlić listę elementów roboczych połączonych z żądaniem ściągnięcia, użyj polecenia az repos pr work-item list --id <PR Id>.
• Aby odłączyć element roboczy z żądania ściągnięcia, użyj polecenia az repos pr work-item remove --id <PR Id> --work-items <Id1>. Odłączanie usuwa tylko łącze między elementem roboczym a żądaniem ściągnięcia. Linki utworzone w gałęzi lub z zatwierdzeń pozostają w elemencie roboczym.

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

Parametry

Parametr	Opis
--id	Identyfikator żądania ściągnięcia. Wymagany.
--work-items	Identyfikatory elementów roboczych do połączenia. Spacja oddzielona. Wymagany.
--detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
--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/.
--subscription	Nazwa lub identyfikator subskrypcji platformy Azure. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s <NAME_OR_ID>.

Dodawanie tagów do żądania ściągnięcia

Użyj tagów, aby wyświetlić ważne szczegóły i ułatwić organizowanie żądania ściągnięcia. Tagi mogą przekazywać dodatkowe informacje recenzentom, takie jak to, że żądanie ściągnięcia jest nadal w toku, lub jest poprawką do nadchodzącej wersji.

Aby dodać tag podczas tworzenia żądania ściągnięcia, wpisz nazwę tagu w sekcji Tagi . Po utworzeniu żądania ściągnięcia można zarządzać tagami w sekcji Tagi .

Dodawanie załączników do żądań ściągnięcia

Pliki, w tym obrazy, można dołączać do żądania ściągnięcia podczas tworzenia lub po jego utworzeniu. Wybierz ikonę klipu papieru poniżej pola Opis lub przeciągnij i upuść pliki bezpośrednio do pola Opis żądania ściągnięcia.

Zmienianie gałęzi docelowej aktywnego żądania ściągnięcia

W przypadku większości zespołów prawie wszystkie żądania ściągnięcia są przeznaczone dla gałęzi domyślnej, takiej jak main lub develop. Jeśli czasami trzeba kierować do innej gałęzi, łatwo zapomnieć o zmianie gałęzi docelowej podczas tworzenia żądania ściągnięcia. W takim przypadku można zmienić gałąź docelową aktywnego żądania ściągnięcia:

1. Wybierz pozycję Więcej akcji w prawym górnym rogu strony Przegląd żądania ściągnięcia, a następnie wybierz pozycję Zmień gałąź docelową z menu rozwijanego.
2. W okienku Zmień gałąź docelową wybierz pozycję Wybierz gałąź docelową, wybierz nową gałąź, a następnie wybierz pozycję Zmień.

Wysyłanie powiadomień o żądaniach ściągnięcia pocztą e-mail do osób biorących udział w projekcie

Możesz udostępnić żądanie ściągnięcia pocztą e-mail, aby powiadomić recenzentów i komunikować się z członkami zespołu. Aby udostępnić żądanie ściągnięcia:

1. Wybierz pozycję Więcej opcji na stronie Przegląd żądania ściągnięcia, a następnie wybierz pozycję Udostępnij żądanie ściągnięcia.

   

2. Na ekranie Udostępnianie żądania ściągnięcia dodaj adresatów, wpisując ich nazwy w polu Do: i wybierając z wyświetlonych nazw użytkowników. Można również usunąć adresatów.

3. Dodaj opcjonalny komunikat w polu Uwaga (opcjonalnie), a następnie wybierz pozycję Wyślij. Adresaci otrzymują wiadomość e-mail z żądaniem uwagi i linkiem do żądania ściągnięcia.

Uwaga

Jeśli używasz wbudowanej funkcji poczty e-mail, możesz wysłać wiadomość e-mail tylko do poszczególnych adresów członków projektu. Dodanie grupy zespołu lub grupy zabezpieczeń do wiersza Do: nie jest obsługiwane. Jeśli dodasz konto e-mail, którego system nie rozpoznaje, zostanie wyświetlony komunikat informujący, że co najmniej jeden adresat wiadomości e-mail nie ma uprawnień do odczytywania wiadomości e-mail z żądaniem ściągnięcia.

Następne kroki

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

Powiązane artykuły

• Wyświetlanie żądań ściągnięcia
• Przeglądanie żądań ściągnięcia
• Wykonywanie żądań ściągnięcia
• Zmienianie gałęzi domyślnej
• Kopiowanie zmian za pomocą funkcji cherry-pick
• Informacje o żądaniach ściągnięcia i uprawnieniach
• Wiele baz scalania