Zobrazení, filtrování a otevření žádostí o přijetí změn

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Vytvoříte žádosti o přijetí změn (ŽÁDOSTI O PŘIJETÍ ZMĚN) pro kontrolu a sloučení změn kódu v úložišti Git v Úložišti Azure. Členové týmu a účastníci můžou zkontrolovat změny a poskytnout zpětnou vazbu před sloučením kódu do cílové větve. Revidujícím se můžou také komentovat změny a hlasovat pro schválení nebo odmítnutí kódu.

Týmy můžou vyžadovat žádosti o přijetí změn pro všechny změny v chráněných větvích a nastavit zásady větví tak, aby určité žádosti o přijetí změn vyžadovaly splnění konkrétních kritérií.

Existuje několik způsobů, jak vypsat, filtrovat, zobrazit a otevřít žádosti o přijetí změn pro projekt.

Požadavky

• Úložiště musí být ve vašem projektu povolená. Pokud se centrum Repos a přidružené stránky nezobrazují, přečtěte si téma Zapnutí nebo vypnutí služby Azure DevOps a opětovné povolení úložišť.

• Pokud chcete zobrazit žádosti o přijetí změn, musíte být členem projektu Azure DevOps, ve které je žádost o přijetí změn, se základním přístupem nebo vyšší. Pokud nejste členem projektu, budete přidáni.

  Poznámka:

  U veřejných projektů mají uživatelé udělený přístup účastníka k Azure Repos plný přístup.

• Další informace o oprávněních apřístupuch

• V Azure DevOps Services můžete spravovat žádosti o přijetí změn a další prostředky z rozhraní příkazového řádku Azure (CLI) s rozšířením azure-devops . Informace o tom, jak pracovat s rozhraním příkazového řádku Azure DevOps Services, najdete v tématu Začínáme s Azure DevOps CLI. Příkazy rozhraní příkazového řádku Azure Repos pro žádosti o přijetí změn používají příkazy az repos pr.

Výpis žádostí o přijetí změn

Žádosti o přijetí změn můžete zobrazit pomocí webu projektu Azure DevOps, sady Visual Studio nebo příkazového řádku Azure DevOps.

Prohlížeč

1. Pokud chcete vypsat žádosti o přijetí změn v určitém úložišti v projektu, přejděte na tento projekt na webovém portálu a vyberte Žádosti o přijetí změn v úložišti Repos>.

   

2. Ověřte, že jste vybrali správné úložiště.

   

3. Výchozí zobrazení zobrazuje žádosti o přijetí změn na kartě Moje . Výběrem možnosti Aktivní zobrazíte všechny aktivní žádosti o přijetí změn pro aktuální úložiště. Výběrem možnosti Dokončeno nebo Opuštěno zobrazíte seznamy uzavřených žádostí o přijetí změn.

   Výběrem libovolné žádosti o přijetí změn v seznamu přejděte na stránku s přehledem žádosti o přijetí změn.

   

4. Všechny žádosti o přijetí změn v různých projektech ve vaší organizaci můžete zobrazit tak, že v zobrazení Moje práce zvolíte žádosti o přijetí změn.

   

Visual Studio

Pokud chcete vypsat žádosti o přijetí změn ze sady Visual Studio, vyberte <v nabídce Gitu zobrazení žádostí o přijetí změn službu>>Git.

Visual Studio 2019 verze 16.8 a novější verze poskytují prostředí pro správu verzí Gitu při zachování uživatelského rozhraní Git Team Exploreru. Pokud chcete použít Team Explorer, zrušte zaškrtnutí políčka Možnosti nástrojů>>Ve verzi Preview Nové>uživatelské prostředí Gitu na řádku nabídek. Funkce Gitu můžete provádět zaměnitelně z libovolného rozhraní.

Přístup k žádosti o přijetí změn z Visual Studio Team Exploreru:

1. Připojte se k projektu ze sady Visual Studio.

2. Výběrem možnosti Zobrazit>Team Explorer otevřete Team Explorer. Můžete také stisknout ctrl+\, Ctrl+M.

3. Na domovské stránce vyberte Žádosti o přijetí změn, abyste zobrazili seznamy žádostí o přijetí změn, které jste otevřeli vy nebo které jste jim přiřadili.

4. Pokud chcete zobrazit seznam žádostí o přijetí změn na webovém portálu Azure DevOps, vyberte Akce a pak vyberte Otevřít v prohlížeči.

   

Rozhraní příkazového řádku Azure DevOps

Pokud chcete zobrazit seznam aktivních žádostí o přijetí změn v projektu s jejich podrobnostmi, použijte příkaz 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	Popis
--creator	Omezte výsledky na žádosti o přijetí změn vytvořené tímto uživatelem.
--detect	Automaticky rozpozná organizaci. Přijaté hodnoty: false, true.
--include-links	Zahrňte _links pro každou žádost o přijetí změn.
--org --organization	Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí .az devops configure -d organization=<ORG_URL> Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
--project -p	Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí .az devops configure -d project=<NAME_OR_ID> Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu.
--query-examples	Doporučený řetězec JMESPath Můžete zkopírovat jeden z dotazů a vložit ho --query za parametr v uvozovkách, aby se zobrazily výsledky. Můžete přidat jedno nebo více pozičních klíčových slov, takže návrhy jsou založené na těchto klíčových slovech.
--repository -r	Název nebo ID úložiště
--reviewer	Omezte výsledky na žádosti o přijetí změn, kde je tento uživatel kontrolorem.
--skip	Počet žádostí o přijetí změn, které se mají přeskočit
--source-branch -s	Omezte výsledky na žádosti o přijetí změn, které pocházejí z této zdrojové větve.
--status	Omezit výsledky na žádosti o přijetí změn s tímto stavem Přijaté hodnoty: abandoned, active, allcompleted.
--subscription	Název nebo ID předplatného Azure Výchozí předplatné můžete nakonfigurovat pomocí .az account set -s <NAME_OR_ID>
--target-branch -t	Omezte výsledky na žádosti o přijetí změn, které cílí na tuto větev.
--top	Maximální počet žádostí o přijetí změn do seznamu

Příklad

Následující příkaz vypíše všechny žádosti o přijetí změn v úložišti bez ohledu na stav a zobrazí výstup v tabulce. Příklad používá výchozí konfiguraci 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

Definování vlastního zobrazení žádosti o přijetí změn

Filtrování seznamu žádostí o přijetí změn vám pomůže najít a uspořádat žádosti o přijetí změn tak, aby upřednostňovaly nejdůležitější soubory ve vašem pracovním postupu.

Prohlížeč

Pokud chcete filtrovat seznam žádostí o přijetí změn, vyberte na stránce Žádosti o přijetí změn ikonu Filtr v pravém horním rohu. Pak vyberte Cílová větev nebo jiné záhlaví sloupce a vyberte větev nebo jinou hodnotu, podle které chcete filtrovat.

Pokud chcete zobrazení seznamu žádostí o přijetí změn dále přizpůsobit, vyberte Možnost Přizpůsobit zobrazení v pravém horním rohu na stránce Žádosti o přijetí změn.

Na stránce Přizpůsobit zobrazení můžete změnit uspořádání aktuálních oddílů zobrazení, upravit je nebo je odebrat. Pokud chcete vytvořit nový oddíl, vyberte Přidat oddíl.

Na stránce Přizpůsobit oddíl zadejte a vyberte hodnoty, které chcete vyfiltrovat podle parametrů, jako je stav konceptu nebo aktualizované datum. Můžete zvolit, jestli chcete zobrazit žádosti o přijetí změn, které jsem schválil nebo odmítl na samostatné kartě, nebo vyloučit žádosti o přijetí změn (duplikáty) zahrnuté v předchozích částech. Po dokončení přizpůsobení zobrazení vyberte Uložit.

Tato přizpůsobená zobrazení vytvářejí samostatné sbalitelné oddíly na stránce žádosti o přijetí změn. Tyto vlastní dotazy také fungují napříč úložišti na kartě Moje žádosti o přijetí změn na domovské stránce organizace.

Pokud chcete změnit parametry přizpůsobených zobrazení, vyberte tlačítko Přizpůsobit vedle zobrazení. Nebo vyberte Přizpůsobit zobrazení a na obrazovce Přizpůsobit zobrazení vyberte zobrazení, které chcete změnit. Některá zobrazení, jako je Přiřazeno ke mně, se nedají přizpůsobit, ale dají se změnit nebo odebrat.

Na kartě Soubory žádosti o přijetí změn můžete pomocí několika filtrů vybrat soubory a komentáře pro rychlejší recenze. Vyberte Filtr a pak vyberte mezi možnostmi.

• Klíčové slovo: Zadejte klíčové slovo.
• Recenzováno/Nerevidováno: Vše (výchozí), Čeká na vyřízení, Zkontrolováno.
• Okomentované soubory: Všechny soubory (výchozí), Soubory s komentáři.
• Komentáře: Zobrazit (výchozí), Co je nového, Skrýt.
• Stav komentáře: Aktivní (výchozí), Čeká na vyřízení, Vyřešeno, Podle návrhu, Nebude opraven, Uzavřeno.
• Komentář: Všechny komentáře (výchozí) nebo konkrétní osoba.

Do vyhledávacího pole můžete také zadat řetězec, aby se zobrazily odpovídající výsledky z předchozích možností.

Visual Studio

Filtrování žádostí o přijetí změn ze sady Visual Studio:

1. V nabídce Git vyberte< službu Git>>View Pull Requests. (Zobrazit žádosti o přijetí změn).

2. Filtrovat podle autora, popisku nebo jiných atributů

V zobrazení Žádosti o přijetí změn Team Exploreru:

• Výběrem možnosti Aktivní nebo Přiřazeno mně nebo mému týmu můžete filtrovat seznamy žádostí o přijetí změn podle stavu žádosti o přijetí změn nebo přiřazení.
• Pokud chcete filtrovat seznamy žádostí o přijetí změn podle data, autora, větve nebo jiných atributů, zadejte je sem.

Rozhraní příkazového řádku Azure DevOps

Pomocí několika parametrů seznamu az repos pr můžete filtrovat seznam žádostí o přijetí změn, například --creator, --project, --repository, --reviewer--source-branch, , --statusa --target-branch--top.

Tyto --creator hodnoty --reviewer můžou být zobrazované jména nebo e-mailové adresy. Parametr --top definuje maximální počet žádostí o přijetí změn, které se mají vypsat.

Pokud například chcete zobrazit podrobnosti o poslední vytvořené žádosti o přijetí změn bez ohledu na její stav, použijte:

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

Otevřete žádost o přijetí změn

Když otevřete žádost o přijetí změn z prohlížeče, ze sady Visual Studio nebo z Azure CLI, otevře se v prohlížeči stránka Přehled žádosti o přijetí změn.

Prohlížeč

Pokud chcete otevřít žádost o přijetí změn v prohlížeči, vyberte žádost o přijetí změn ze seznamu na stránce Žádosti o přijetí změn. Žádost o přijetí změn se otevře na kartě Přehled . Na kartě Přehled se zobrazuje název žádosti o přijetí změn, popis, revidoři, propojené pracovní položky, historie a stav. Zobrazí se souhrn zásad větví, které se předávají nebo selhávají, a zobrazí se revidující komentáře.

Na kartě Soubory žádosti o přijetí změn můžete zkontrolovat skutečné změny v souborech žádosti o přijetí změn. Na kartách Aktualizace a potvrzení uvidíte změny, které autor provedl za účelem aktualizace větve žádosti o přijetí změn.

Visual Studio

Pokud chcete otevřít žádost o přijetí změn ze sady Visual Studio, v nabídce Git vyberte <svou službu>>Git View Pull Requests a pak ji otevřete výběrem žádosti o přijetí změn.

Nebo v zobrazení Žádosti o přijetí změn Team Exploreru klikněte pravým tlačítkem na žádost o přijetí změn a výběrem možnosti Otevřít v prohlížeči otevřete žádost o přijetí změn na webovém portálu.

Rezervace větve

V sadě Visual Studio 2019 si můžete prohlédnout zdrojovou větev žádosti o přijetí změn přímo ze zobrazení Žádosti o přijetí změn. Klikněte pravým tlačítkem na žádost o přijetí změn a zvolte Rezervovat zdrojovou větev.

Poznámka:

Visual Studio 2019 verze 16.8 a novější verze poskytují novou nabídku Gitu pro správu pracovního postupu Gitu s méně kontextovým přepínáním než Team Explorer. Postupy uvedené v tomto článku na kartě Visual Studio poskytují informace o používání prostředí Git a Team Exploreru. Další informace najdete v tématu Souběžné porovnání Gitu a Team Exploreru.

Rozhraní příkazového řádku Azure DevOps

Pokud chcete zobrazit podrobnosti pro jednu žádost o přijetí změn, použijte příkaz az repos pr show s požadovaným --id parametrem. Pokud chcete žádost o přijetí změn otevřít v prohlížeči, použijte --open.

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

Parametry

Parametr	Popis
--id	ID žádosti o přijetí změn. Povinný:
--detect	Automaticky rozpozná organizaci. Přijaté hodnoty: false, true.
--open	Otevřete žádost o přijetí změn ve webovém prohlížeči.
--org --organization	Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí .az devops configure -d organization=<ORG_URL> Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
--query-examples	Doporučený řetězec JMESPath Můžete zkopírovat jeden z dotazů a vložit ho --query za parametr v uvozovkách, aby se zobrazily výsledky. Můžete přidat jedno nebo více pozičních klíčových slov, takže návrhy jsou založené na těchto klíčových slovech.
--subscription	Název nebo ID předplatného Azure Výchozí předplatné můžete nakonfigurovat pomocí .az account set -s <NAME_OR_ID>

Příklad

Následující příklad ukazuje podrobnosti o žádosti o přijetí změn č. 21, zobrazí výstup příkazu jako tabulku a otevře žádost o přijetí změn v prohlížeči:

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

Rezervace větve

Pomocí příkazu az repos pr checkout s požadovaným --id parametrem můžete rezervovat místně větev žádosti o přijetí změn, pokud neexistují žádné místní změny.

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

Parametry

Parametr	Popis
--id	ID žádosti o přijetí změn.
--remote-name	Název vzdáleného gitu, proti kterému je vyvolána žádost o přijetí změn. Výchozí hodnota: origin.
--subscription	Název nebo ID předplatného Azure Výchozí předplatné můžete nakonfigurovat pomocí .az account set -s <NAME_OR_ID>

Příklad

Pokud chcete například rezervovat větev pro pr č. 21 místně, použijte:

az repos pr checkout --id 21

Pokud chcete zkontrolovat změny, dělat komentáře nebo návrhy nebo hlasovat o žádosti o přijetí změn, přečtěte si téma Kontrola žádostí o přijetí změn.

Zobrazení a aktualizace žádostí o přijetí změn z mobilního zařízení

Mobilní zařízení můžete použít k zobrazení všech obrazovek žádosti o přijetí změn azure Repos a provedení akcí.

Další kroky

Kontrola žádostí o přijetí změn

Související články

• Vytvoření žádosti o přijetí změn
• Oznámení o aktualizaci žádostí o přijetí změn
• Dokončení žádosti o přijetí změn
• Změna výchozí větve
• Kopírování změn pomocí výběru třešně
• Informace o žádostech o přijetí změn a oprávněních