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

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

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Vytvořte žádosti o přijetí změn, které změní, zkontrolují a sloučí kód 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 žádosti o přijetí změn zkontrolovat a poskytnout zpětnou vazbu ke změnám. Kontroloři 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 před dokončením žádosti o přijetí změn a sloučením změn do cílové větve splnit různá kritéria.

Pokyny k žádostem o přijetí změn a důležité informace o správě 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.

  • 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é 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 se základním přístupem nebo vyšším. Pokud nejste členem projektu, můžete ho 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, můžete ho 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 Azure DevOps CLI.

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

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 ze stránky žádosti o přijetí změn projektu na webu.

  1. Na stránce Žádostio 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.

Po nasdílení nebo aktualizaci větve funkcí Azure Repos vás vyzve k vytvoření žádosti o přijetí změn v zobrazení kódu 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í P 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

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 v zobrazení Prácez 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 provede 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šňového výběru

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 opětovného základu přináší výběr pouze změny 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 v nabídce Další možnosti žádosti o přijetí změn výběr. 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 s výběrem 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 zdroj a cílové větve 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 říkají kontrolorům žádostí o přijetí změn, co očekávat, a můžou pomoct sledovat úkoly, jako je přidává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 si také vybrat z šablon specifických pro větve 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í 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 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 zvolte š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í jazyka 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.

Návrhy žá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 ručně zařadit do fronty 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é.

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

  • Koncept žádostí 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 Server verze 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 nadpisů, jako je WIP nebo NESLOUČIT.

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

Až budete připravení, aby se žádost o přijetí změn zkontrolovala a dokončila, 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čení jako koncept

Poznámka

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

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 můžete zobrazit 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í, 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 jazyka P R

Přidání podrobností do nového bodu 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, recenzenty nebo podrobnosti. Tyto položky můžete přidat nebo aktualizovat po vytvoření žádosti o přijetí změn.

Úprava názvu a popisu žádosti o přijetí změn

Nechte název a popis žádosti o přijetí změn aktuální, aby revidujícím porozuměli změnám 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 kliknutím na ikonu Zpět změny zahoďte.

Upravte popis žádosti o přijetí změn 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 stávající žádosti o přijetí změn. Můžete také nastavit, aby stávající volitelní revidující byli povinní, nebo změnit požadované revidující na nepovinný nebo odebrat, pokud je nevyžadují zásady.

Zásady větví můžou vyžadovat minimální počet revidujících nebo automaticky zahrnout určité volitelné nebo požadované revidujících do žádostí o přijetí změn. Revidujícím, které zásady větve vyžadují, nemůžete odebrat. Můžete změnit povinné 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é jsou automaticky zahrnuté podle zásad větve

Pokud uživatel nebo skupina, které chcete zkontrolovat, není členem vašeho projektu, musíte je 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. Pokud chcete přidat požadované revidujícím, vyberte Přidat požadované revidujícím a pak vyberte Hledat a přidejte požadované revidujícím , které chcete vyhledat 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řidejte revidujícím 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 kontrolor, vyberte ikonu skupiny.

Přidání revidujících do žá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ích vyberte tlačítko pro přidání.

  3. Zadejte jméno uživatele nebo skupiny, které chcete přidat do seznamu revidujících žádosti o přijetí změn. Pokud uživatel není členem vašeho projektu, budete je 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 ho jako revidujícím.

    Přidání revidujících žádostí 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, 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í.

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í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 pouze 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 žádostmi 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čítko pro propojení položek

  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.

Odkazy na pracovní položku odeberte tak, že vyberete tlačítko pro odebrání, které se zobrazí, když najedete myší na pracovní položku. tlačítko odebrat 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ůstanou v pracovní položce.

Propojení pracovních položek s žádostmi 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. Ze seznamu, který se zobrazí, vyberte pracovní položku.

Odkazy na pracovní položku odeberte tak, že vyberete tlačítko pro odebrání, které se zobrazí, když najedete myší na pracovní položku. ikona pro odebrání Odebráním odkazu se odebere pouze 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 do žádosti o přijetí změn

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

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 znázorňující zvýrazněnou část Značky P R

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

Další informace o žádosti o přijetí změn můžete sdělit revidujícím pomocí popisků. Možná stále probíhá žádost o přijetí změn nebo je to oprava hotfix pro nadcházející vydání. Používejte popisky ke sdělení důležitých podrobností a k uspořádání žá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 zobrazují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 její popisky spravovat v části Popisky .

Přidání popisku P 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 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, 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. Na stránce Přehled žádosti o přijetí změn vyberte Další akce v pravém horním rohu 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 a upozornit 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 dostanou e-mail s žádostí o pozornost a propojí se s žádostí o přijetí změn.

Poznámka

Pokud používáte integrovanou e-mailovou funkci, můžete e-mail odeslat jenom jednotlivým adresě členům projektu. Přidání týmové skupiny nebo skupiny zabezpečení do řádku To: se nepodporuje. 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 Server nakonfigurovat server SMTP.

Další kroky