Zobrazení, filtrování a otevření žádostí o přijetí změn
Článek
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.
Ú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 se základním přístupem nebo novějším. Pokud nejste členem projektu, budete přidáni.
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.
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>.
Ověřte, že jste vybrali správné úložiště.
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.
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.
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:
Výběrem možnosti Zobrazit>Team Explorer otevřete Team Explorer. Můžete také stisknout ctrl+\, Ctrl+M.
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.
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.
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
Příkazy Rozhraní příkazového řádku Azure DevOps se pro Azure DevOps Server nepodporují.
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.
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í.
Filtrování žádostí o přijetí změn ze sady Visual Studio:
V nabídce Git vyberte< službu Git>>View Pull Requests. (Zobrazit žádosti o přijetí změn).
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.
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
Příkazy Rozhraní příkazového řádku Azure DevOps se pro Azure DevOps Server nepodporují.
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.
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.
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.
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
Příkazy Rozhraní příkazového řádku Azure DevOps se pro Azure DevOps Server nepodporují.
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í.
