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

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

Když vytvoříte žádost o přijetí změn a zadáte povinné nebo volitelné revidujícím, Azure Repos upozorní revidujícím, že vaše žádost o přijetí změn je připravená ke kontrole. Všichni povinní kontroloři musí schválit změny ve vaší žádosti o přijetí změn, aby se změny mohly sloučit do cílové větve. U žádostí o přijetí změn, které mění kritické větve, jako je main větev, může váš tým vytvořit zásady větví, které určují revidujícím nebo vyžadují minimální počet revidujících. Pokud zásady větví přidávají do žádosti o přijetí změn volitelné revidujícím, můžete je zachovat, vyžadovat nebo odebrat. Pokud zásady větve přidávají do žádosti o přijetí změn požadované revidujícím, nemůžete je označit jako volitelné nebo je odebrat. Informace o přiřazování revidujících prostřednictvím zásad větví najdete v tématu Automatické zahrnutí revidujících kódu.

Pokud kontrolujete žádost o přijetí změn, zkuste poskytnout konstruktivní zpětnou vazbu, která je přesná a snadno pochopitelná. Další informace o zpětné vazbě najdete v tématu Žádost o přijetí změn. Tento článek popisuje, jak zkontrolovat žádosti o přijetí změn v Azure DevOps.

Žádosti o přijetí změn Azure DevOps můžete zkontrolovat jenom na webovém portálu pomocí prohlížeče.

V tomto článku získáte informace o těchto tématech:

• Kontrola změn
• Použití komentářů
• Úprava souborů
• Sledování kontrolovaných souborů
• Hlasovat o změnách žádosti o přijetí změn
• Dokončení žádosti o přijetí změn

Požadavky

• Úložiště musí být povolená v nastavení projektu Azure DevOps. 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 zkontrolovat žádosti o přijetí změn, musíte být členem projektu Azure DevOps, ve které se žádost o přijetí změn nachází, s úrovní základního přístupu nebo vyšší.

  • Pokud projekt nemáte, vytvořte si ho nebo se zaregistrujte zdarma.

  • 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 ooprávněních

Žádosti o přijetí změn v Azure DevOps Services můžete spravovat pomocí rozhraní příkazového řádku Azure DevOps (CLI). Rozhraní příkazového řádku Azure DevOps je k dispozici při instalaci Azure CLI a rozšíření Azure DevOps. Seznam příkazů rozhraní příkazového řádku pro správu žádostí o přijetí změn najdete v az repos pr těchto příkazech.

Kontrola změn

Žádosti o přijetí změn umožňují určeným revidujícím zkoumat, diskutovat a hlasovat o navrhovaných změnách předtím, než se tyto změny použijí na cílovou větev úložiště. Mějte na paměti, že pokud se vývoj provádí se stejnými soubory v různých větvích, může dojít ke konfliktům změn. V takovém případě je nutné pečlivě analyzovat a řešit tyto konflikty. Chcete-li to provést, může vyžadovat ruční úpravu souboru, aby se změny použily buď ze zdroje, cíle, nebo obou větví. Provedení všech změn ze zdroje nebo cíle (které lze provést jedním kliknutím na tlačítko) nemusí být optimální a může vést ke ztrátě některých požadovaných změn. Můžete to provést pomocí nástrojů ADO nebo bude pohodlnější používat vývojové nástroje (například Visual Studio).

Další informace najdete v tématu Řešení konfliktů při slučování.

Následující kroky popisují, jak můžou kontroloři žádostí o přijetí změn v Azure Repos procházet žádost o přijetí změn, abyste porozuměli navrhovaným změnám:

1. Ve webovém prohlížeči otevřete týmový projekt pro vaši organizaci Azure DevOps. Pokud chcete zobrazit seznam žádostí o přijetí změn, zvolte Žádosti o přijetí změn v úložišti>. Nově otevřená žádost o přijetí změn se ve výchozím nastavení nastaví na kartu Přehled .

2. Karta Přehled žádosti o přijetí změn zobrazuje název, popis, revidujícím, propojené pracovní položky, historii, stav a komentáře. Přečtěte si popis žádosti o přijetí změn a prohlédněte si navrhované změny. Prohlédněte si komentáře, abyste porozuměli problémům vyvolaým jinými revidujícím.

   Poznámka:

   Každý soubor se odhaduje na řadu úprav a je označen znaménkem +nebo popiskem přejmenovat a upravit vedle názvu. Pokud má soubor více než 50% změn, považuje se za přejmenovaný. Toto je výchozí prahová hodnota pro úložiště Git, která se nedá změnit.

   

3. Výběrem karty Soubory zkontrolujte všechny změny obsahu ve zdrojové větvi žádosti o přijetí změn. V počátečním zobrazení se zobrazí souhrnné zobrazení všech změn souboru. Pokud chcete zobrazit jenom změny tohoto souboru, zvolte tlačítko Zobrazit vedle souboru. Pokud byl soubor změněn, tlačítko Zobrazit otevře rozdílové zobrazení. Pokud byl soubor přidán nebo odstraněn, tlačítko Zobrazit otevře podokno obsahu.

   

   Poznámka:

   Z důvodů výkonu se v souhrnném zobrazení nezobrazí změny souboru, který je větší než 0,5 MB.

4. V rozdílovém zobrazení souboru můžete vybrat rozložení rozdílu vedle sebe nebo vloženého rozdílu.

   

   Tip

   U každého souboru , který je větší než 5 MB, se v zobrazení rozdílu zobrazuje zkrácený obsah souboru. Pokud chcete zobrazit úplný obsah, stáhněte a prohlédněte si tyto soubory pomocí místního nástroje rozdílu.

   K zobrazení jiného souboru použijte strom souborů vlevo nebo vyberte kořen stromu souborů a zobrazte souhrnné zobrazení všech změn souborů.

5. Pokud chcete zkontrolovat sadu změn zavedenou konkrétními oznámeními do zdrojové větve, vyberte v rozevíracím seznamu změn jednu nebo více sad změn. Když vyberete jednu nebo více sad změn, rozdílové zobrazení se aktualizuje, aby se zobrazily pouze změny z vybraných sad změn. Tato funkce je užitečná, když se změny od poslední kontroly odeslaly do žádosti o přijetí změn a chcete jenom vidět nové změny. Rozevírací seznam změn pojmenuje každou sadu změn se zprávou potvrzení z konečného potvrzení v každé operaci nabízení.

   

   Tip

   Při výběru více sad změn z rozevíracího seznamu změn podržte klávesu Shift .

6. Pokud chcete zobrazit všechny vložené sady změn, zvolte kartu Aktualizace, abyste měli jistotu, že jste nezmeškali žádné změny zdrojové větve. Sady změn jsou očíslované a v horní části seznamu se zobrazí nejnovější sada změn. Každá sada změn zobrazuje potvrzení, která byla v této operaci nabízena. Vynucená sada změn nepřepíše historii sady změn a zobrazí se v seznamu sad změn stejně jako jakákoli jiná sada změn.

   

7. Po rozchádání od cílové větve zvolte kartu Potvrzení a zobrazte historii potvrzení zdrojové větve. Historie potvrzení na kartě Potvrzení se přepíše, pokud autor žádosti o přijetí změn vynutí jinou historii potvrzení, takže potvrzení zobrazená na kartě Potvrzení se můžou lišit od potvrzení zobrazených na kartě Aktualizace.

   

Kontrola souborů

Výběrem karty Soubory žádosti o přijetí změn zobrazíte skutečné změny provedené ve zdrojové větvi vedle cílové větve žádosti o přijetí změn.

Poznámka:

Příčinou rozdílů mezi změnami v žádosti o přijetí změn Azure DevOps a porovnání větví Azure DevOps jsou různé metody porovnávání.

Existují dvě metody porovnání příkazu git diff: two-dot (git diff A..B) a three-dot (git diff A...B). Ve výchozím nastavení zobrazují žádosti o přijetí změn rozdíl tří teček, zatímco porovnání větví místo toho zobrazuje rozdíl dvou teček.

Příklad:

      C---D---E branch
     /
A---B---F---G   master

Žádosti o přijetí změn: git diff branch...master vytvoří pouze potvrzení C, D, E. Porovnání větví: git diff branch..master vytvoří potvrzení C, D, E, F, G.

Další podrobnosti najdete v tématech se třemi tečkami a dva-dot-git-diff-comparisons a git diff.

Poznámka:

Při prohlížení rozdílu u jednoho vybraného souboru je limit velikosti souboru 5 MB. Pokud chcete zobrazit a rozdílové soubory větší než 5 MB, můžete si ho stáhnout a zobrazit pomocí místního nástroje rozdílu. Při zobrazení rozdílu pro kolekci souborů je limit velikosti každého souboru 0,5 MB z důvodů výkonu.

Kontrola aktualizací

Zkontrolujte předchozí verze kódu z rozevíracího seznamu Všechny aktualizace .

Každá aktualizace větve přidá do seznamu novou verzi a na kartě Aktualizace žádosti o přijetí změn. Když vyberete různé aktualizace, rozdílové zobrazení zobrazí rozdíly mezi soubory v každé verzi žádosti o přijetí změn.

Po ukončení žádosti o přijetí změn můžete aktualizace žádostí o přijetí změn dohnat krokováním změn provedenými od poslední kontroly.

Umožňuje procházet seznam změn od autora na kartě Aktualizace.

Umožňuje zobrazit a vybrat změny provedené v potvrzeních ve větvi na kartě Potvrzení .

Použití komentářů

Autoři žádosti o přijetí změn a revidujícím spolu můžou komunikovat přidáním komentářů k žádosti o přijetí změn a reagováním na ně. Při kontrole žádosti o přijetí změn použijte komentáře k upozornění na problémy s navrhovanými změnami, návrhy změn a reagování na předchozí komentáře. Zaměřte se na konstruktivní zpětnou vazbu, která je přesná a snadno pochopitelná. Adresovat příjemce přímo pomocí jejich @username. Odkazovat na pracovní položky pomocí a #workitemID jiných žádostí o přijetí změn pomocí .!pullrequestID Autoři žádosti o přijetí změn někdy vytvářejí komentáře pro vlastní potřebu pro účely dokumentace.

Poskytnutí zpětné vazby v komentářích

Pokud se váš názor týká určitého řádku nebo rozsahu řádků v souboru, přidejte komentář do tohoto umístění v souboru:

1. Na kartě Soubory žádosti o přijetí změn najeďte myší na řádek, na který chcete komentář okomentovat, a výběrem tlačítka komentáře otevřete vložené pole komentáře. Můžete také vybrat více řádků a pak vybrat tlačítko komentáře, které se zobrazí, když na tyto řádky najedete myší.

   

2. Do pole komentáře zadejte komentář a zvolte Komentář.

   

Pokud se váš názor vztahuje na celý soubor, přidejte komentář na úrovni souboru tak , že v nabídce možností souboru vyberete Přidat komentář :

Pokud chcete poskytnout obecnou zpětnou vazbu nesouvisející s konkrétním souborem, přidejte komentář na kartě Přehled :

Kontroloři žádostí o přijetí změn můžou také pomocí komentářů navrhovat změny konkrétních řádků souborů, jak je popsáno v další části.

Navrhnout změny v komentářích

Komentáře můžete použít k návrhu náhradního textu pro jeden nebo více řádků v souboru:

1. Na kartě Soubory žádosti o přijetí změn najeďte myší na řádek, na který chcete komentář okomentovat, a výběrem tlačítka komentáře otevřete vložené pole komentáře. Můžete také vybrat více řádků a pak vybrat tlačítko komentáře, které se zobrazí, když na tyto řádky najedete myší. V případě přijetí nahradí navrhovaný obsah řádek nebo řádky, ke kterým byl komentář přidán.

   

2. Výběrem ikony žárovky pod polem komentáře proveďte navrhované změny v poli komentáře v ohraničeném bloku kódu a pak zvolte Komentář. Pokud do původního kódu (na levé straně) zobrazení rozdílu vedle sebe přidáte komentář, ikona žárovky se nezobrazí.

   

Autoři žádostí o přijetí změn můžou váš návrh přijmout:

1. Volba Použít změny pro fázi změny v připravenosti pro potvrzení.

   

2. Volba Potvrdit všechny změny k potvrzení všech fázovaných změn. Autoři žádosti o přijetí změn můžou návrh zrušit výběrem možnosti Zpět změnit.

   

Úprava nebo odstranění komentářů

Komentář můžete upravit nebo odstranit tak, že na komentář najedete myší a zvolíte ikonu pro úpravy nebo odstranění :

Lajkovat komentáře

Autoři a revidující žádosti o přijetí změn můžou lajkovat vlastní komentář nebo komentář někoho jiného tak, že na komentář najedete myší a zvolíte ikonu palec nahoru:

Komentáře s lajky zobrazují vyplněnou ikonu palec nahoru a počet lajků. Když najedete myší na ikonu palce nahoru, zobrazí se seznam lidí, kteří komentář lajkovali.

Odpovědět na komentáře

Autoři žádostí o přijetí změn by měli odpovědět na komentáře a dát revidujícím vědět, jak řeší zpětnou vazbu a návrhy:

1. Pokud chcete odpovědět na komentář, zadejte odpověď do pole Napsat odpověď . Adresovat příjemce přímo pomocí jejich @username. Odkazovat na pracovní položky pomocí a #workitemID jiných žádostí o přijetí změn pomocí .!pullrequestID

   

2. Po zadání odpovědi vyberte Odpovědět a vyřešit , pokud je odpověď dokončená. V opačném případě vyberte Odpovědět.

   

   Pokud vyberete Možnost Odpovědět a vyřešit, stav komentáře se změní na Vyřešeno. Autoři žádosti o přijetí změn můžou také přímo změnit stav komentáře, jak je popsáno v další části.

Změna stavu komentáře

Nové komentáře mají zpočátku aktivní stav, který autoři žádosti o přijetí změn aktualizují během procesu kontroly, aby označili, jak vyřešili zpětnou vazbu a návrhy revidujících. Autoři žádosti o přijetí změn můžou v rozevíracím seznamu stavu vybrat stav komentáře:

• Aktivní: výchozí stav pro nové komentáře.

• Čeká se na vyřízení: Problém v tomto komentáři je pod kontrolou a čeká na něco jiného.

• Vyřešeno: Problém v tomto komentáři je vyřešený.

• Problém v tomto komentáři se neopraví, ale nebude opraven.

• Uzavřeno: diskuze v tomto komentáři je uzavřena.

Autoři žádosti o přijetí změn a revidující můžou sledovat průběh žádosti o přijetí změn filtrováním stavu komentáře, jak je popsáno v další části.

Filtrování komentářů

Na kartě Přehled můžete vybrat komentáře nebo aktualizace tak, že v rozevíracím seznamu filtru komentářů vyberete možnost filtru. Pokud například chcete zobrazit nové komentáře a aktualizace od posledního otevření žádosti o přijetí změn, vyberte možnost Co je nového filtru. Každá možnost filtru zobrazuje počet položek pro svoji kategorii.

Úprava souborů

Autoři žádostí o přijetí změn můžou soubory upravovat přímo v Azure Repos. Mohli jste například přijmout navrhované změny kódu revidujícím a chtít provést podobné změny jinde.

1. Zvolte Soubory úložišť>, vyberte zdrojovou větev žádosti o přijetí změn, vyberte soubor a pak zvolte Upravit.

   

2. Proveďte změny v editoru a potom zvolte Potvrdit , aby se otevřelo dialogové okno Potvrzení .

   

3. V dialogovém okně Potvrzení upravte zprávu potvrzení v případě potřeby a pak zvolte Potvrdit potvrzení a nasdílejte změny do žádosti o přijetí změn.

   

Sledování kontrolovaných souborů

Kontroloři žádostí o přijetí změn můžou sledovat kontrolované soubory tak, že v nabídce možností souborů zvolí možnost Označit jako zkontrolovat nebo zaškrtnete políčko vedle souboru nebo složky:

Hlasovat o změnách žádosti o přijetí změn

Prohlížeč

Revidující žádosti o přijetí změn můžou hlasovat výběrem možnosti hlasování z rozevíracího seznamu hlasů. Ikona revidujících na stránce žádosti o přijetí změn zobrazí indikátor svého hlasování.

Možnosti hlasování jsou:

• Schválit: schválí navrhované změny v žádosti o přijetí změn. Tato možnost je jen hlasováním a neschválí žádost o přijetí změn.

• Schválit s návrhy: Schválí navrhované změny v žádosti o přijetí změn s volitelnými návrhy na zlepšení. Tato možnost je jen hlasováním a neschválí žádost o přijetí změn.

• Počkejte na autora: požádá autora, aby zkontroloval komentáře revidujících. Autor žádosti o přijetí změn by měl recenzentům dát vědět, aby znovu zkontrolovali kód, jakmile autor žádosti o přijetí změn vyřešil komentáře. Pokud požadovaný kontrolor tuto možnost hlasování nastaví, hlasování zablokuje schválení žádosti o přijetí změn.

• Odmítnutí: Označuje, že změny nejsou přijatelné. Když zvolíte tuto možnost, přidejte komentář vysvětlující proč. Pokud požadovaný kontrolor tuto možnost hlasování nastaví, hlasování zablokuje schválení žádosti o přijetí změn.

• Resetování zpětné vazby: vymaže hlas. Absence hlasování nezabrání dokončení žádosti o přijetí změn.

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

Pokud chcete hlasovat o tom, jestli chcete schválit žádost o přijetí změn, použijte az repos pr set-vote příkaz.

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

Parametry

Parametr	Požadováno	Popis
--id	Ano	ID žádosti o přijetí změn
--vote	Ano	Nová hodnota hlasu pro žádost o přijetí změn (přijaté hodnoty: approve, approve-with-suggestions, reject, resetnebo wait-for-author)
--detect	No	Automatická detekce organizace (přijaté hodnoty: false, true)
--organization	Ano, pokud není nastavená výchozí organizace a konfigurační soubor Gitu nezadá organizaci.	Adresa URL organizace Azure DevOps nebo nastavení výchozí organizace pomocí: az devops configure -d organization=<organization URL>
--subscription	No	Název nebo ID předplatného Azure nebo nastavení výchozího předplatného pomocí: az account set -s <name or ID>

Příklady

Následující příkaz bude hlasovat pro schválení žádosti o přijetí změn č. 21. Příkaz vrátí tabulku.

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

Následující příkaz odebere váš hlas. Příkaz vrátí tabulku.

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

Dokončení žádosti o přijetí změn

Autoři žádosti o přijetí změn můžou vybrat možnost řešení žádosti o přijetí změn:

• Dokončeno: Žádost o přijetí změn dokončete, pokud ji všichni povinní kontroloři schválili a všechny požadované zásady větví jsou splněné.

• Nastavit automatické dokončování: automatické dokončení žádosti o přijetí změn, když ji všichni povinní kontroloři schválí a splní se všechny požadované zásady větví.

• Označit jako koncept: Nastavte žádost o přijetí změn na stav konceptu tak, aby označí, že není připravená ke kontrole. V případě žádosti o přijetí změn můžete vybrat možnost Publikovat a odebrat její stav konceptu a označit ji jako připravenou ke kontrole.

• Opuštění: zavřete žádost o přijetí změn. V případě opuštěné žádosti o přijetí změn můžete výběrem možnosti Opětovná aktivace obnovit.

Další informace o dokončení žádosti o přijetí změn najdete v tématu Dokončení žádosti o přijetí změn.

Další kroky

Dokončení žádosti o přijetí změn

Související články

• Oznámení o aktualizaci žádostí o přijetí změn
• Informace o žádostech o přijetí změn a oprávněních