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

Azure DevOps Services | Azure DevOps Server 2020 | 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

  • Repos musí být ve vašem projektu povolená. Pokud se centrum Repos a přidružené stránky nezobrazují, přečtěte si článek Zapnutí nebo vypnutí služby Azure DevOps a opětovné povolení Repos.

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

  • Repos musí být ve vašem projektu povolená. Pokud se centrum Repos a přidružené stránky nezobrazují, přečtěte si článek Zapnutí nebo vypnutí služby Azure DevOps a opětovné povolení Repos.
  • 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 se základním přístupem 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 Azure DevOps projektu, z Visual Studio nebo z rozhraní příkazového řádku Azure DevOps.

Na webu Azure DevOps projektu 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 Repos>Pull requests vyberte v pravém horním rohu novou žádost o přijetí změn.

    Screenshot of the New pull request button.

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

    Screenshot of source and target branches for a P R in 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 :

    Screenshot that shows the prompt to create a P R on the Pull Requests tab in Azure Repos.

  • Na stránce Soubory :

    Screenshot that shows the prompt to create a P R on the Files tab in 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ů.

Screenshot that shows the prompt to create a P R on the Pull Requests tab in Azure Repos.

Screenshot that shows the prompt to create a P R on the Files tab in 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.

    Screenshot of creating a PR from the Development area of a work item with a linked branch.

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.

Screenshot of the switch source and target branches icon.

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.

Screenshot showing Add a template when creating a 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 .

    Screenshot showing a draft P R in the P R list.

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.

Screenshot showing Create as draft 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í.

Screenshot showing Publish for a 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.

Screenshot showing Mark as draft.

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.

Screenshot that shows creating a new P R.

Adding details to a new P R.

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

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

Udržujte název žádosti o přijetí změn a popis 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 výběrem ikony Zpět zahodíte změny.

Upravte popis žádosti o přijetí změn výběrem ikony Upravit v části Popis .

Screenshot that shows editing the P R title and selecting the description Edit button.

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í nepovinní revidující byli povinní nebo je mohli změnit na volitelné nebo odebrat, pokud je zásady nevyžadují.

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

Screenshot that shows View policy on a reviewer that's automatically included by branch policy.

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 zobrazuje 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é revidenty, vyberte Přidat požadované revidenty a pak vyberte Hledat, abyste mohli požadované revidenty vyhledat a vybrat jména.

Screenshot of adding a reviewer to a new 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ý revidujícím nebo Nepovinný revidujícím.

    Pull request overview

  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.

    Add P R reviewer.

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

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

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

    PR overview

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

  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 je jako revidujícím.

    Add PR reviewer

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

    Screenshot that shows selecting the Overview tab and the work items section.

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

Odeberte odkaz na pracovní položku tak, že vyberete ikonu x vedle pracovní položky. Odebrání propojení 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 žádostí o přijetí změn:

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

    Screenshot that shows selecting the Overview tab and the link items button.

  2. V oblasti Pracovní položky vyberte tlačítko přidat. Add icon in PRs

  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žku tak, že vyberete tlačítko odebrat, které se zobrazí, když najedete myší na pracovní položku. remove button Odebrání propojení odebere pouze propojení mezi pracovní položkou k žádosti 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. Vyberte přehled v žádosti o přijetí změn.

    Select Overview in the PR.

  2. V oblasti Pracovní položky vyberte tlačítko přidat.

  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žku tak, že vyberete tlačítko odebrat, které se zobrazí, když najedete myší na pracovní položku. remove icon Odebrání propojení 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

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

Screenshot showing P Rs with tags.

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 .

Screenshot that shows the P R Tags section highlighted.

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á, že žádost o přijetí změn stále probíhá, nebo jde o opravu hotfix pro nadcházející verzi. Pomocí popisků komunikujte důležité podrobnosti a uspořádejte žádosti 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.

Screenshot showing P Rs with labels.

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 jeho popisky spravovat v části Popisky .

Add P R label

Přidání příloh k žádostem o přijetí změn

Soubory, včetně obrázků, můžete připojit k žádosti o přijetí změn 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.

Screenshot that shows attaching files to the P R description during creation.

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

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

    Screenshot that shows selecting Share pull request on a P R's Overview page.

  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 uživatelských jmen, která se zobrazí. 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 pozornost a propojení 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á, dostanete 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 pro Azure DevOps Server nakonfigurovat server SMTP.

Další kroky