Vytvář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 (PR) pro změnu, kontrolu a sloučení kódu v úložišti Git. Žádosti o přijetí změn můžete vytvářet z větví v upstreamovém úložišti nebo z větví ve forku úložiště. Váš tým může zkontrolovat žádosti o přijetí změn a poskytnout zpětnou vazbu ke změnám. Revidujícím mohou procházet navrhované změny, zanechat komentáře a hlasovat pro schválení nebo odmítnutí žádostí o přijetí změn. V závislosti na zásadách větve a dalších požadavcích může vaše žádost o přijetí změn splňovat různá kritéria, abyste mohli žádost o přijetí změn dokončit a sloučit změny do cílové větve.

Pokyny k žádosti o přijetí změn a aspekty správy najdete v tématu O žádostech o přijetí změn.

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 nebo zkontrolovat žádosti o přijetí změn, musíte být členem projektu Azure DevOps s přístupem Basic nebo vyšším.

  • Abyste mohli přispívat k žádosti o přijetí změn, musíte být členem skupiny zabezpečení Čtenáři nebo mít odpovídající oprávnění.

  • Pokud chcete vytvořit a dokončit žádost o přijetí změn, musíte být členem skupiny zabezpečení Přispěvatelé nebo mít odpovídající oprávnění.

    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 nebo zkontrolovat žádosti o přijetí změn, musíte být členem projektu Azure DevOps s přístupem Basic nebo novějším. Pokud nejste členem projektu, budete přidáni.
  • Pokud chcete vytvořit a dokončit žádost o přijetí změn, musíte být členem skupiny zabezpečení Přispěvatelé nebo mít odpovídající oprávnění v projektu, který chcete změnit.
  • Abyste mohli přispívat k žádosti o přijetí změn, musíte být členem skupiny zabezpečení Čtenáři nebo mít odpovídající oprávnění.
  • Další informace ooprávněních
  • Žádosti o přijetí změn můžete vytvářet a spravovat pomocí 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.

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

Novou žádost o přijetí změn můžete vytvořit z webu projektu Azure DevOps, ze sady Visual Studio nebo z Azure DevOps CLI.

Na webu projektu Azure DevOps můžete vytvořit novou žádost o přijetí změn z:

Vytvoření žádosti o přijetí změn ze stránky Žádosti o přijetí změn

Žádosti o přijetí změn můžete vytvořit pro libovolnou větev na stránce žádosti o přijetí změn projektu na webu.

  1. Na stránce Žádosti o přijetí změn úložiště>vyberte v pravém horním rohu novou žádost o přijetí změn.

    Snímek obrazovky s tlačítkem Nová žádost o přijetí změn

  2. Vyberte větev se změnami a větev, do které chcete změny sloučit, například do hlavní větve.

    Snímek obrazovky se zdrojovými a cílovými větvemi pro P R v Azure Repos

  3. Zadejte podrobnosti o žádosti o přijetí změn a vytvořte žádost o přijetí změn.

Vytvoření žádosti o přijetí změn z vložené větve

Po nasdílení nebo aktualizaci větve funkcí azure Repos zobrazí výzvu k vytvoření žádosti o přijetí změn.

  • Na stránce Žádosti o přijetí změn:

    Snímek obrazovky s výzvou k vytvoření P R na kartě Žádosti o přijetí změn v Azure Repos

  • Na stránce Soubory:

    Snímek obrazovky s výzvou k vytvoření P R na kartě Soubory v Azure Repos

Výběrem možnosti Vytvořit žádost o přijetí změn přejděte na stránku, kde můžete zadat podrobnosti o žádosti o přijetí změn a vytvořit žádost o přijetí změn.

Vytvoření žádosti o přijetí změn z propojené pracovní položky

Žádost o přijetí změn můžete vytvořit přímo z pracovní položky Azure Boards propojené s větví.

  1. V Azure Boards otevřete z backlogů nebo dotazů v zobrazení Práce pracovní položku, která je propojená s větví.

  2. V oblasti Vývoj pracovní položky vyberte Vytvořit žádost o přijetí změn.

    Snímek obrazovky s vytvořením žádosti o přijetí změn z oblasti Vývoj pracovní položky s propojenou větví

Odkaz vás přenese na stránku, kde můžete zadat podrobnosti o žádosti o přijetí změn a vytvořit žádost o přijetí změn.

Přidání aktualizací pomocí výběru třešně

Potvrzení z jedné větve do druhé můžete zkopírovat pomocí výběru třešně. Na rozdíl od sloučení nebo změny základu přináší výběr určité změny jenom z vybraných potvrzení místo všech změn ve větvi.

Pokud chcete vybrat změny z dokončené žádosti o přijetí změn, vyberte na stránce Přehled žádosti o přijetí změn výběr. Pokud chcete zkopírovat změny z aktivní žádosti o přijetí změn, vyberte možnost Cherry-pick z nabídky Další možnosti žádosti o přijetí změn. Tato akce vytvoří novou větev s zkopírovanými změnami. Pak můžete vytvořit novou žádost o přijetí změn z nové větve. Podrobné pokyny najdete v tématu Kopírování změn pomocí výběru třešně.

Přepnutí zdrojových a cílových větví žádosti o přijetí změn

Před prvním uložením žádosti o přijetí změn můžete přepnout zdrojové a cílové větve žádosti o přijetí změn výběrem ikony Přepnout zdrojovou a cílovou větev vedle názvů větví. Jakmile je žádost o přijetí změn aktivní, tato ikona zmizí, ale přesto můžete změnit cílovou větev žádosti o přijetí změn.

Snímek obrazovky s ikonou přepnout zdroj a cílové větve

Použití šablon žádostí o přijetí změn

Šablona žádosti o přijetí změn je soubor obsahující text Markdownu, který při vytváření žádosti o přijetí změn naplní popis žádosti o přijetí změn. Dobré popisy žádostí o přijetí změn sdělují kontrolorům žádostí o přijetí změn, co mají očekávat, a můžou pomoct sledovat úkoly, jako je přidání testů jednotek a aktualizace dokumentace. Váš tým může vytvořit výchozí šablonu žádosti o přijetí změn, která přidá text do všech nových popisů žádostí o přijetí změn v úložišti. Můžete také vybrat ze šablon specifických pro větev nebo jiných šablon, které váš tým definuje. Další informace o vytváření a používání šablon žádostí o přijetí změn najdete v tématu Vylepšení popisu žádostí o přijetí změn pomocí šablon.

Pokud má vaše úložiště výchozí šablonu, všechny žádosti o přijetí změn v úložišti mají při vytváření výchozí text popisu šablony. Pokud chcete přidat další šablony, vyberte Přidat šablonu a pak v rozevíracím seznamu vyberte šablonu. Text šablony můžete upravit v popisu, odebrat ho nebo přidat další text.

Snímek obrazovky znázorňující přidání šablony při vytváření P R

Vytvoření konceptů žádostí o přijetí změn

Pokud vaše žádost o přijetí změn není připravená ke kontrole, můžete vytvořit koncept žádosti o přijetí změn, která bude indikovat probíhající práci. Až bude žádost o přijetí změn připravená ke kontrole, můžete ji publikovat a začít nebo pokračovat v úplném procesu kontroly.

Koncepty žádostí o přijetí změn mají následující rozdíly od publikovaných žádostí o přijetí změn:

  • Zásady ověřování sestavení se nespouštějí automaticky. Ověření sestavení můžete zařadit do fronty ručně tak, že v žádosti o přijetí změn vyberete nabídku dalších možností.

  • Hlasování je v režimu konceptu zakázané.

  • Povinní kontroloři se nepřidají automaticky. Oznámení se odesílají jenom revidujícím, které explicitně přidáte do konceptu žádosti o přijetí změn.

  • Koncept žádosti o přijetí změn se zobrazí v seznamu žádostí o přijetí změn s odznáček Koncept .

    Snímek obrazovky znázorňující koncept P R v seznamu P R

Poznámka:

Vytváření konceptů žádostí o přijetí změn vyžaduje aktualizaci Azure DevOps Serveru 2019.1 nebo novější.

Pokud chcete vytvořit koncept žádosti o přijetí změn, vyberte šipku vedle možnosti Vytvořit a při vytváření žádosti o přijetí změn vyberte Vytvořit jako koncept . Nemusíte používat předpony názvu, jako je WIP nebo NESLOUČIT.

Snímek obrazovky s možností Vytvořit jako koncept P R

Až budete připravení, aby se žádost o přijetí změn zkontrolovala a dokončila, vyberte Možnost Publikovat v pravém horním rohu žádosti o přijetí změn. Publikování žádosti o přijetí změn přiřadí požadované revidující, vyhodnotí zásady a zahájí hlasování.

Snímek obrazovky s možností Publikovat pro P R

Pokud chcete změnit existující publikovanou žádost o přijetí změn na koncept, zvolte Označit jako koncept. Označení žádosti o přijetí změn jako konceptu odebere všechny existující hlasy.

Snímek obrazovky s možností Označit jako koncept

Přidání nebo úprava názvu a popisu žádosti o přijetí změn

Na stránce Nová žádost o přijetí změn zadejte název a podrobný popis změn, aby ostatní viděli, jaké problémy změny řeší. V nové žádosti o přijetí změn jako v existujících žádostech o přijetí změn uvidíte soubory a potvrzení v žádosti o přijetí změn na samostatných kartách. Do žádosti o přijetí změn můžete přidat revidujícím, propojit pracovní položky a přidat značky.

Až budete chtít změny zkontrolovat, vyberte Vytvořit a vytvořte žádost o přijetí změn.

Snímek obrazovky znázorňující vytvoření nového P R

Přidání podrobností do nového P R

Nemějte obavy, pokud při vytváření žádosti o přijetí změn nemáte připravené všechny pracovní položky, revidujícím nebo podrobnosti. Tyto položky můžete přidat nebo aktualizovat po vytvoření žádosti o přijetí změn.

Upravit název a popis žádosti o přijetí změn

Udržujte název a popis žádosti o přijetí změn aktuální, aby revidoři pochopili změny v žádosti o přijetí změn.

Název existující žádosti o přijetí změn můžete aktualizovat tak, že vyberete aktuální název a aktualizujete text. Pokud chcete uložit změny, vyberte ikonu Uložit nebo výběrem ikony Zpět změny zahoďte.

Popis žádosti o přijetí změn můžete upravit tak, že v části Popis vyberete ikonu Upravit.

Snímek obrazovky znázorňující úpravy názvu P R a výběr tlačítka Upravit popis

Přidání revidujících do žádosti o přijetí změn

Revidující můžete přidat v části Revidující nové nebo existující žádosti o přijetí změn. Můžete také nastavit, aby stávající volitelní revidující byli povinní, nebo je změnit tak, aby je nepovinili nebo odebrali, pokud je zásady nevyžadují.

Zásady větví můžou vyžadovat minimální počet revidujících nebo automaticky zahrnout určité volitelné nebo požadované kontrolory do žádostí o přijetí změn. Revidujícím, které zásady větve vyžadují, nemůžete odebrat. Můžete změnit volitelné revidujícím zásady větve nebo je odebrat.

Pokud chcete zobrazit zásady větve, které automaticky přidaly revidujícím, klikněte v části Revidujícím na stránce Přehled žádosti o přijetí změn pravým tlačítkem myši na Další možnosti vedle revidujících.

Snímek obrazovky znázorňující zásady zobrazení u revidujících, který je automaticky zahrnutý zásadami větve

Pokud uživatel nebo skupina, které chcete zkontrolovat, není členem vašeho projektu, musíte ho přidat do projektu , abyste je mohli přidat jako revidujícím.

Přidání revidujících do nové žádosti o přijetí změn:

  1. Na stránce Nová žádost o přijetí změn v části Revidujícím vyberte Hledat uživatele a skupiny, které chcete přidat jako revidujícím.
  2. Při zadávání jména nebo e-mailové adresy se v rozevíracím seznamu zobrazí seznam odpovídajících uživatelů a skupin. Vyberte jména ze seznamu, která chcete přidat jako volitelné revidujícím.
  3. Chcete-li přidat požadované revidujícím, vyberte Přidat požadované revidujících a pak vyberte Hledat, aby mohli požadované revidujícím hledat a vybrat jména.

Snímek obrazovky s přidáním revidujících do nového P R

Přidání revidujících do existující žádosti o přijetí změn:

  1. V části Revidoři na stránce Přehled vyberte Přidat a pak vyberte Požadovaný kontrolor nebo Nepovinný revidujícím.

    Přehled žádostí o přijetí změn

  2. Při zadávání jména nebo e-mailové adresy se zobrazí seznam odpovídajících uživatelů nebo skupin. Vyberte jména, která chcete přidat jako revidujícím.

    Přidání revidujících P R

Pokud chcete změnit revidujícím mezi požadovaným a volitelným kontrolorem nebo ho odebrat, vyberte Vpravo od jména revidujících další možnosti . Pokud chcete zobrazit členství ve skupině nebo týmu určeném jako revidujícím, vyberte ikonu skupiny.

Propojení pracovních položek s novou žádostí o přijetí změn:

  1. Na stránce Nová žádost o přijetí změn v části Pracovní položky, které chcete propojit, vyberte Hledat pracovní položky podle ID nebo názvu.
  2. Začněte zadávat ID nebo název pracovní položky a vyberte pracovní položku, která se má propojit z rozevíracího seznamu, který se zobrazí. Hledání podle názvu vrátí pracovní položky filtrované podle stavu; všechny pracovní položky se stavy, které mají dokončené a odebrané kategorie, jsou vyloučeny. Tyto pracovní položky jsou také filtrovány podle data a uživatele, přičemž v posledních 30 dnech se zobrazují jenom položky vytvořené nebo aktualizované a měly by být vytvořeny, přiřazeny nebo autorizovány jako aktuální uživatel.

Propojení pracovních položek s existující žádostí o přijetí změn:

  1. Na kartě Přehled žádosti o přijetí změn vyberte v oblasti +Pracovní položky možnost .

    Snímek obrazovky znázorňující výběr karty Přehled a oddíl pracovních položek

  2. Zadejte ID pracovní položky nebo vyhledejte název pracovní položky. Ze seznamu, který se zobrazí, vyberte pracovní položku.

Odkaz na pracovní položku odeberte tak , že vyberete ikonu x vedle pracovní položky. Odebráním odkazu se odebere jenom propojení mezi pracovní položkou a žádostí o přijetí změn. Odkazy vytvořené ve větvi nebo z potvrzení zůstávají v pracovní položce.

Propojení pracovních položek s žádostí o přijetí změn:

  1. V žádosti o přijetí změn vyberte kartu Přehled.

    Snímek obrazovky znázorňující výběr karty Přehled a tlačítka Propojit položky

  2. Vyberte tlačítko přidat v oblasti Pracovní položky . Ikona Přidat v žádosti o přijetí změn

  3. Zadejte ID pracovní položky nebo vyhledejte pracovní položky s názvy, které odpovídají vašemu textu. Ze seznamu, který se zobrazí, vyberte pracovní položku. Hledání podle názvu vrátí pracovní položky filtrované podle stavu; všechny pracovní položky se stavy, které mají dokončené a odebrané kategorie, jsou vyloučeny. Tyto pracovní položky jsou také filtrovány podle data a uživatele, přičemž v posledních 30 dnech se zobrazují jenom položky vytvořené nebo aktualizované a měly by být vytvořeny, přiřazeny nebo autorizovány jako aktuální uživatel.

Výběrem tlačítka pro odebrání, které se zobrazí po najetí myší na pracovní položku, odeberte odkazy na pracovní položku. Tlačítko pro odebrání Odebráním odkazu odeberete pouze propojení mezi pracovní položkou k žádosti o přijetí změn. Odkazy vytvořené ve větvi nebo potvrzení zůstanou v pracovní položce.

Přidání značek do žádosti o přijetí změn

Pomocí značek můžete zobrazit důležité podrobnosti a pomoct s uspořádáním žádostí o přijetí změn. Značky můžou revidujícím sdělit další informace, například že žádost o přijetí změn stále probíhá, nebo jde o opravu hotfix pro nadcházející verzi.

Snímek obrazovky zobrazující P Rs se značkami

Pokud chcete přidat značku při vytváření žádosti o přijetí změn, zadejte název značky do oddílu Značky . Po vytvoření žádosti o přijetí změn můžete spravovat značky v části Značky .

Snímek obrazovky se zvýrazněnou částí Značky P R

Přidání příloh do žádostí o přijetí změn

Soubory, včetně obrázků, můžete k žádosti o přijetí změn připojit během vytváření nebo po jeho vytvoření. Vyberte ikonu kancelářské sponky pod polem Popis nebo přetáhněte soubory přímo do pole Popis žádosti o přijetí změn.

Snímek obrazovky znázorňující připojení souborů k popisu P R během vytváření

Změna cílové větve aktivní žádosti o přijetí změn

U většiny týmů cílí téměř všechny žádosti o přijetí změn na výchozí větev, například maindevelop. Pokud někdy potřebujete cílit na jinou větev, je snadné při vytváření žádosti o přijetí změn změnit cílovou větev. V takovém případě můžete změnit cílovou větev aktivní žádosti o přijetí změn:

  1. V pravém horním rohu stránky Přehled žádosti o přijetí změn vyberte Další akce a v rozevírací nabídce vyberte Změnit cílovou větev.
  2. V podokně Změnit cílovou větev vyberte Zvolit cílovou větev, vyberte novou větev a pak vyberte Změnit.

E-mailová oznámení o žádostech o přijetí změn zúčastněným stranám

Žádost o přijetí změn můžete sdílet e-mailem a informovat revidujícím a komunikovat s členy týmu. Sdílení žádosti o přijetí změn:

  1. Na stránce Přehled žádosti o přijetí změn vyberte Další možnosti a pak vyberte Sdílet žádost o přijetí změn.

    Snímek obrazovky znázorňující výběr možnosti Sdílet žádost o přijetí změn na stránce Přehled P R

  2. Na obrazovce Sdílet žádost o přijetí změn přidejte příjemce zadáním jejich jmen do pole To: a výběrem ze zobrazených uživatelských jmen. Můžete také odebrat příjemce.

  3. Do pole Poznámka (volitelné) přidejte volitelnou zprávu a pak vyberte Odeslat. Příjemci obdrží e-mail s žádostí o přijetí změn a propojením s žádostí o přijetí změn.

Poznámka:

Pokud používáte integrovanou funkci e-mailu, můžete e-mail odeslat jenom na jednotlivé adresy členů projektu. Přidání týmové skupiny nebo skupiny zabezpečení do řádku To: není podporováno. Pokud přidáte e-mailový účet, který systém nerozpozná, obdržíte zprávu, že jeden nebo více příjemců e-mailu nemá oprávnění ke čtení e-mailové žádosti o přijetí změn.

Aby funkce e-mailu fungovala, musí správce Azure DevOps Serveru nakonfigurovat server SMTP.

Další kroky