Vytváření žádostí o přijetí změn

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

Visual Studio 2019 | Visual Studio 2022

Vytvořte žádosti o přijetí změn (ŽÁDOSTI o přijetí změn) 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 nadřazeném úložišti nebo z větví ve vašem forku úložiště. Váš tým může žádosti o přijetí změn zkontrolovat a poskytnout zpětnou vazbu ke změnám. Revidující můžou 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 před dokončením žádosti o přijetí změn a sloučením změn do cílové větve splňovat různá kritéria.

Pokyny k žádosti o přijetí změn a důležité informace o správě najdete v tématu Informace o žádostech o přijetí změn.

Požadavky

  • Úložiště musí být v 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 pro 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.

  • Pokud chcete 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é s uděleným přístupem účastníka úplný přístup k Azure Repos.

  • Úložiště musí být v 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 pro 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. Pokud nejste členem projektu, nechte se přidat.
  • 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.
  • Pokud chcete 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í.
  • 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. Pokud nejste členem projektu, nechte se přidat.
  • Pokud chcete 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í.

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 rozhraní příkazového řádku Azure DevOps.

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 pro libovolnou větev můžete vytvořit ze stránky žádostí o přijetí změn projektu na webu.

  1. Na stránce ReposPull requests (Repos>) vyberte v pravém horním rohu Možnost Nová žá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 hlavní větev.

    Snímek obrazovky se zdrojovou a cílovou větví 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 nabízené větve

Jakmile nasdílíte nebo aktualizujete větev 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í 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

Vyberte Vytvořit žádost o přijetí změn a 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.

Jakmile nasdílíte nebo aktualizujete větev funkcí, Azure Repos vás vyzve k vytvoření žádosti o přijetí změn v zobrazení Kód na webu. Tato výzva se zobrazí u žádostí o přijetí změn a souborů.

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

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

Vyberte Vytvořit žádost o přijetí změn a 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 Azure Boards pracovní položky propojené s větví.

  1. V Azure Boards otevřete v zobrazení Práce z backlogů nebo dotazů 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í příkazu cherry-pick

Potvrzení můžete zkopírovat z jedné větve do jiné pomocí příkazu cherry-pick. Na rozdíl od sloučení nebo změny základu přenese výběr vybraných změn jenom změny z potvrzení, která vyberete, a ne všechny změny 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 možnost Cherry-pick (Výběr určité části). Pokud chcete zkopírovat změny z aktivní žádosti o přijetí změn, vyberte v nabídce Další možnosti žádosti o přijetí změn možnost Cherry-pick (Výběr části). Tato akce vytvoří novou větev se 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é a cílové větve žádosti o přijetí změn

Před prvním uložením žádosti o přijetí změn můžete přepnout zdrojovou a cílovou větev žá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 stále můžete změnit cílovou větev žádosti o přijetí změn.

Snímek obrazovky s ikonou zdrojové a cílové větve přepínače

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 vyplní 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 úlohy, jako je přidání testů jednotek nebo aktualizace dokumentace. Váš tým může vytvořit výchozí šablonu žádosti o přijetí změn, která přidá text ke všem novým popisům žádosti o přijetí změn v úložišti. Můžete si také vybrat z šablon pro konkrétní větev nebo jiných šablon, které definuje váš tým. Další informace o vytváření a používání šablon žádostí o přijetí změn najdete v tématu Vylepšení popisů žá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 budou mít při vytvoření výchozí text popisu šablony. Pokud chcete přidat další šablony, vyberte Přidat šablonu a pak zvolte šablonu z rozevíracího seznamu. Text šablony můžete upravit v popisu, odebrat ho nebo přidat jiný text.

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

Vytvář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ý označí probíhající práci. Jakmile je žádost o přijetí změn připravená ke kontrole, můžete ji publikovat a zahájit nebo obnovit celý proces kontroly.

Koncepty žádostí o přijetí změn se od publikovaných žádostí o přijetí změn liší následovně:

  • 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 s dalšími možnostmi.

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

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

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

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

Poznámka

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

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

Snímek obrazovky znázorňující vytvořit jako koncept P R

Až budete chtít žádost o přijetí změn zkontrolovat a dokončit, vyberte 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 znázorňující publikování 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 stávající hlasy.

Snímek obrazovky znázorňující Označit jako koncept

Poznámka

Tato funkce vyžaduje aktualizaci Azure DevOps Server 2019.1 nebo novější verzi.

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ší. U nové žádosti o přijetí změn jako u stávajících žádostí o přijetí změn uvidíte soubory a potvrzení na samostatných kartách. Do žádosti o přijetí změn můžete přidat revidující, 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.

Nemusíte si dělat starosti, pokud při vytváření žádosti o přijetí změn nemáte připravené všechny pracovní položky, revidující 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

Název a popis žádosti o přijetí změn udržujte aktuální, aby revidující 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. Výběrem ikony Uložit uložte změny nebo výběrem ikony Zpět změny zahoďte.

Popis žádosti o přijetí změn můžete upravit výběrem ikony Upravit v části Popis .

Snímek obrazovky, který znázorňuje úpravu názvu jazyka 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 nové nebo existující žádosti o přijetí změn v části Revidující . Můžete také nastavit stávající volitelné revidující jako povinné, změnit požadované kontrolory tak, aby je nepovinně zrušily, nebo je odebrat, pokud je nevyžadují zásady.

Zásady větve můžou vyžadovat minimální počet revidujících nebo automaticky zahrnout určité volitelné nebo požadované revidující do žádostí o přijetí změn. Revidující, kteří jsou vyžadováni zásadami větve, nemůžete odebrat. Volitelné kontrolory zásad větví můžete změnit tak, aby se vyžadovaly, nebo je odebrat.

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

Snímek obrazovky znázorňující, jak zobrazit zásadu pro revidujícího, která je automaticky zahrnutá do zásad větve

Pokud uživatel nebo skupina, které chcete zkontrolovat vaši žádost o přijetí změn, nejsou členy vašeho projektu, musíte je přidat do projektu , abyste je mohli přidat jako revidující.

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í vyberte Hledat uživatele a skupiny, které chcete přidat jako revidující.
  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. Ze seznamu vyberte jména, která chcete přidat jako volitelné revidující.
  3. Pokud chcete přidat požadované revidující, vyberte Přidat požadované revidující a pak vyberte Hledat a přidejte požadované revidující k vyhledání a výběru jmen.

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

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

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

    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í.

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

Pokud chcete revidujícího změnit mezi povinným a volitelným nebo chcete revidujícího odebrat, vyberte Další možnosti napravo od jména revidujícího. Pokud chcete zobrazit členství skupiny nebo týmu určeného jako revidující, vyberte ikonu skupiny.

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

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

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

  2. V oblasti Revidující vyberte tlačítko Přidat.

  3. Zadejte jméno uživatele nebo skupiny, které chcete přidat do seznamu kontrolorů pro žádost o přijetí změn. Pokud uživatel není členem vašeho projektu, budete ho muset přidat.

  4. Při zadávání jména nebo e-mailové adresy se zobrazí seznam odpovídajících uživatelů nebo skupin. Vyberte uživatele nebo skupinu ze seznamu a přidejte je jako revidující.

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

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 k propojení vyberte Hledat pracovní položky podle ID nebo názvu.
  2. Začněte zadávat ID nebo název pracovní položky a v zobrazeném rozevíracím seznamu vyberte pracovní položku, na kterou chcete vytvořit odkaz.

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 v oblasti Pracovní položky vyberte +.

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

  2. Zadejte ID pracovní položky nebo vyhledejte název pracovní položky. V zobrazeném seznamu vyberte pracovní položku.

Odkaz na pracovní položku odeberete tak, že vyberete ikonu x vedle pracovní položky. Odebráním propojení 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ůstanou 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 položky odkazu

  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. V zobrazeném seznamu vyberte pracovní položku.

Odeberte odkazy na pracovní položky tak, že vyberete tlačítko odebrat, které se zobrazí, když na pracovní položku najedete myší. tlačítko odebrat Odebrání odkazu pouze odebere propojení mezi pracovní položkou a žádostí o přijetí změn. Odkazy vytvořené ve větvi nebo z potvrzení zůstanou 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 Přehled .

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

  2. Vyberte tlačítko Přidat v oblasti Pracovní položky .

  3. Zadejte ID pracovní položky nebo vyhledejte pracovní položky s názvy, které odpovídají vašemu textu. V zobrazeném seznamu vyberte pracovní položku.

Odeberte odkazy na pracovní položky tak, že vyberete tlačítko odebrat, které se zobrazí, když na pracovní položku najedete myší. ikona odebrat Odebrání odkazu pouze odebere propojení mezi pracovní položkou a žádostí o přijetí změn. Odkazy vytvořené ve větvi nebo z potvrzení zůstanou v pracovní položce.

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

Značky slouží k zobrazení důležitých podrobností a k organizaci žádostí o přijetí změn. Značky můžou revidujícím předávat další informace, například že žádost o přijetí změn stále probíhá, nebo je opravou hotfix pro nadcházející vydání.

Snímek obrazovky znázorňují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 části 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 jazyka P R

Přidání popisků k žádosti o přijetí změn

Další informace o žádosti o přijetí změn můžete revidujícím sdělit pomocí popisků. Možná žádost o přijetí změn stále probíhá, nebo se jedná o opravu hotfix pro nadcházející vydání. Popisky slouží ke sdělení důležitých podrobností a k organizaci žádostí o přijetí změn.

Poznámka

Použití popisků žádosti o přijetí změn vyžaduje TFS 2018.2 nebo novější verzi.

Snímek obrazovky znázorňující P Rs s popisky

Pokud chcete přidat popisek při vytváření žádosti o přijetí změn, zvolte Přidat popisek. Po vytvoření žádosti o přijetí změn můžete spravovat jeho popisky v části Popisky .

Přidat popisek R

Přidání příloh k žádostem 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 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 jazyka 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 main nebo develop. Pokud někdy potřebujete cílit na jinou větev, můžete při vytváření žádosti o přijetí změn snadno zapomenout změnit cílovou větev. Pokud k tomu dojde, můžete změnit cílovou větev aktivní žádosti o přijetí změn:

  1. V pravém horním rohu na stránce Přehled žádosti o přijetí změn vyberte Další akce a pak 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.

Email 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, abyste mohli upozornit revidující a komunikovat se č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 z zobrazených uživatelských jmen. Příjemce můžete také odebrat.

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

Poznámka

Pokud používáte integrovanou e-mailovou funkci, můžete e-maily posílat jenom na jednotlivé adresy členů projektu. Přidání týmové skupiny nebo skupiny zabezpečení na řádek To : se nepodporuje. Pokud přidáte e-mailový účet, který systém nerozpozná, zobrazí se zpráva, že jeden nebo více příjemců e-mailu nemá oprávnění ke čtení zaslané žádosti o přijetí změn.

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

Další kroky