Vytváření žádostí o získání dat

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2015

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Vytvořte žádosti o přijetí změn (PR) pro změnu, kontrolu a sloučení kódu v úložišti Git. PR můžete vytvořit z větví v nadřazeném úložišti nebo z větví ve větvi úložiště. Váš tým může zkontrolovat PR a poskytnout zpětnou vazbu ke změnám. Recenzenti mohou procházet navrhované změny, opustit komentáře a hlasovat ke schválení nebo odmítnutí pr. V závislosti na zásadách větví 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í změn do cílové větve vyžadovat splnění různých kritérií.

Pokyny pro žádost o přijetí změn a pokyny pro správu najdete v tématu o žádostech opřijetí změn

Požadavky

  • Repos musí být v projektu povolené. pokud se nezobrazuje Repos hub a přidružené stránky, přečtěte si téma zapnutí nebo vypnutí služby Azure DevOps a znovu povolit Repos.

  • chcete-li zobrazit nebo zkontrolovat pr, musíte být členem projektu Azure DevOps s přístupem Basic nebo vyšším.

  • Chcete-li přispívat k žádosti o přijetí změn, musíte být členem skupiny zabezpečení čtenáři nebo mít příslušná oprávnění.

  • Chcete-li 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 příslušná oprávnění.

    Poznámka

    U veřejných projektů mají uživatelé udělený přístup účastníkovi úplný přístup k Azure Repos.

  • Repos musí být v projektu povolené. pokud se nezobrazuje Repos hub a přidružené stránky, přečtěte si téma zapnutí nebo vypnutí služby Azure DevOps a znovu povolit Repos.
  • chcete-li zobrazit nebo zkontrolovat pr, musíte být členem projektu Azure DevOps s přístupem Basic nebo vyšším. Pokud nejste členem projektu, přičtěte.
  • Chcete-li 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 příslušná oprávnění v projektu, který chcete změnit.
  • Chcete-li přispívat k žádosti o přijetí změn, musíte být členem skupiny zabezpečení čtenáři nebo mít příslušná oprávnění.
  • Chcete-li 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 příslušná oprávnění.
  • chcete-li zobrazit nebo zkontrolovat pr, musíte být členem projektu Azure DevOps s přístupem Basic nebo vyšším. Pokud nejste členem projektu, přičtěte.
  • Chcete-li přispívat k žádosti o přijetí změn, musíte být členem skupiny zabezpečení čtenáři nebo mít příslušná 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 Azure DevOps CLI.

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

Vytvořit žádost o přijetí změn ze stránky žádosti o přijetí změn

Můžete vytvořit PR pro libovolnou větev ze stránky žádosti o přijetí změn v projektu na webu.

  1. na stránce Reposžádosti o přijetí změn vyberte v pravém horním rohu nový požadavek na získání dat .

    Snímek obrazovky s tlačítkem nové žádosti o získání dat

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

    Snímek obrazovky zdrojové a cílové větve pro P R v Azure Repos.

  3. Zadejte své 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

po vložení nebo aktualizaci větve funkce 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 zobrazující výzvu k vytvoření P R na kartě žádosti o přijetí změn v Azure Repos.

  • Na stránce soubory :

    Snímek obrazovky zobrazující výzvu 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 své podrobnosti o žádosti o přijetí změn a vytvořit žádost o přijetí změn.

po vložení nebo aktualizaci větve funkce vás Azure Repos vyzve k vytvoření žádosti o přijetí změn v zobrazení kódu na webu. Tato výzva se zobrazí na žádostech a souborechžádosti o přijetí změn.

Snímek obrazovky zobrazující výzvu k vytvoření P R na kartě žádosti o přijetí změn v Azure Repos.

Snímek obrazovky zobrazující výzvu 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 své 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 lze vytvořit přímo z Azure Boards pracovní položky propojené s větví.

  1. v Azure Boards z nevyřízených položek nebo dotazů v zobrazení práce otevřete pracovní položku, která je propojena s větví.

  2. V oblasti pro vývoj pracovní položky vyberte vytvořit žádost o získání dat.

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

Odkaz vás přesměruje na stránku, kde můžete zadat své 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 určitých položek

Potvrzení změn můžete kopírovat z jedné větve do druhé pomocí výběru určitých položek. Na rozdíl od sloučení nebo přenesení změn vybere výběr jenom změny z potvrzení, která jste vybrali, místo všech změn ve větvi.

Pokud chcete vybrat změny ze dokončené žádosti o přijetí změn, vyberte na stránce Přehled žádosti o výběr určitých položek. Pokud chcete kopírovat změny z aktivní žádosti o přijetí změn, vyberte z nabídky žádosti o přijetí změn výběr určitýchpoložek . Tato akce vytvoří novou větev s zkopírovanými změnami. Z nové větve pak můžete vytvořit novou žádost o přijetí změn. Podrobné pokyny najdete v tématu o Kopírování změn pomocí výběru určitýchpoložek.

Přepnout zdrojovou a cílovou větev vaší žádosti o získání dat

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

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

Použití šablon žádostí o získání dat

Šablona žádosti o přijetí změn je soubor obsahující Markdownu text, který při vytváření žádosti o přijetí změn naplní popis žádosti o přijetí změn. Dobré popisy žádosti o přijetí změn oznamují kontrolorům žádosti o přijetí změn, které můžou očekávat, a mohou pomáhat sledovat úlohy, jako je přidání jednotkových testů 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ů žádosti o přijetí změn v úložišti. Můžete také vybrat ze šablon nebo jiných šablon, které váš tým definuje. Další informace o vytváření a používání šablon PR 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 PR v úložišti mají při vytváření výchozí text šablony. Chcete-li přidat další šablony, vyberte možnost Přidat šablonu a v rozevíracím seznamu vyberte šablonu. Text šablony můžete upravit v popisu, odebrat ho nebo přidat jiný text.

Snímek obrazovky, který ukazuje přidání šablony při vytváření P R.

Vytvořit koncept PR

Pokud vaše žádost o přijetí změn není připravená k revizi, můžete vytvořit koncept žádosti o přijetí změn, abyste označili probíhající práci. Když je žádost o přijetí změn připravená ke kontrole, můžete ji publikovat a zahájit nebo obnovit kompletní proces kontroly.

Koncept PR má následující rozdíly z publikovaných prů:

  • Zásady ověřování sestavení se nespouštějí automaticky. Ověření sestavení můžete zařadit do fronty ručně výběrem nabídky další možnosti v žádosti o přijetí změn.

  • Hlasovací právo je v režimu konceptu zakázané.

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

  • Koncept PR zobrazení v seznamu žádosti o přijetí změn pomocí konceptu .

    Snímek obrazovky zobrazující koncept P R v seznamu P R

Poznámka

vytváření konceptů pr 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 tlačítka vytvořit a vyberte vytvořit jako koncept při vytváření žádosti o přijetí změn. Nemusíte používat předpony nadpisů, jako je například Nedokončená výroba nebo Neslučovat.

Snímek obrazovky s informacemi o vytvoření jako konceptu P R

Až budete připraveni k revizi a dokončení žádosti o přijetí změn, vyberte publikovat v pravém horním rohu v žádosti o přijetí změn. Publikování žádosti o přijetí změn přiřadí požadované kontrolory, vyhodnotí zásady a vypíná hlasování.

Snímek obrazovky znázorňující publikování pro P R

Chcete-li změnit existující publikovanou žádost o přijetí změn na koncept, vyberte možnost Označit jako koncept. Označení PR jako koncept odstraní všechna stávající hlasy.

Snímek obrazovky znázorňující označení jako koncept

Přidat nebo upravit název a popis žádosti o získání dat

Na stránce Nová žádost o přijetí změn zadejte název a podrobný Popis provedených změn, aby ostatní mohli zjistit, jaké problémy se změny vyřeší. Na nové žádosti o přijetí změn jako v existujících PR můžete zobrazit soubory a potvrzení v žádosti o přijetí změn na různých kartách. Můžete přidat kontrolory, propojit pracovní položky a přidat značky k žádosti o přijetí změn.

Až budete připraveni na vaše změny, vyberte vytvořit a vytvořte žádost o přijetí změn.

Snímek obrazovky, který ukazuje vytvoření nového P R.

Přidání podrobností k novému P R.

Nedělejte si starosti, pokud nemáte všechny pracovní položky, kontrolory nebo podrobnosti připravené při vytváření žádosti o přijetí změn. Tyto položky můžete po vytvoření žádosti o přijetí změn přidat nebo aktualizovat.

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

Udržujte název a popis pr v aktuálních stavu, aby revidující mohli porozumět změnám v této pr.

Název existující pr můžete aktualizovat tak, že vyberete aktuální název a aktualizujete text. Výběrem ikony Uložit změny uložte nebo je zahoďte výběrem ikony Zpět.

Upravte popis pr. výběrem ikony Upravit v části Popis.

Snímek obrazovky znázorňuje úpravu názvu P R a výběr tlačítka upravit popis

Přidání revidujícího k žádosti o změnu

Revidující můžete přidat do části Revidující nové nebo existující pr. Můžete také nastavit existující volitelné revidující nebo změnit požadované revidující na volitelné nebo odebrat, pokud je zásady nepožadují.

Zásady větví mohou vyžadovat minimální počet revidujícínebo automaticky zahrnout určité volitelné nebo požadované revidující do požadavků. Revidující, kteří jsou vyžadované zásadou větve, není možné odebrat. Můžete změnit volitelné revidující, aby se vyžadovaly, nebo je odebrat.

Pokud chcete zobrazit zásadu větve, která revidujícího automaticky přidala, klikněte v části Revidující na stránce Přehled pr na Další možnosti vedle revidujícího.

Snímek obrazovky zobrazující možnost Zobrazit zásady u revidujícího, který je automaticky zahrnutý v zásadách větve

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

Přidání revidujícího do nové pr:

  1. Na stránce New pull request (Nová žádost o změnu) v části Reviewers(Revidující) vyberte Search users and groups (Vyhledat 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 zobrazuje seznam odpovídajících uživatelů a skupin. Vyberte jména ze seznamu a přidejte je jako volitelné kontrolory.
  3. Pokud chcete přidat požadované revidující, vyberte Přidatpožadované revidující a pak vyberte Hledat a přidejte požadované revidující, kteří hledí a vyberou jména.

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

Přidání revidujícího do existující pr:

  1. V části Revidující na stránce Přehled vyberte Přidata pak vyberte Požadovaný revidující nebo Volitelný kontrolor.

    Přehled žádostí o vyžádá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řidejte kontrolora P R.

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

Přidání revidujícího do pr:

  1. V PR vyberte kartu Přehled.

    Přehled pr

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

  3. Zadejte jméno uživatele nebo skupiny, které chcete přidat do seznamu revidujícího pro pr. 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ího.

    Přidání kontrolora pr

Propojení pracovních položek s novou pr:

  1. Na stránce Nová žádost o stažení v části Pracovní položky pro 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 rozevíracím seznamu, který se zobrazí, vyberte pracovní položku, kterou chcete propojit.

Propojení pracovních položek s existující pr:

  1. Na kartě Přehled pr. v oblasti Pracovní položky vyberte .

    Snímek obrazovky znázorňuje 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 seznamu, který se zobrazí, vyberte pracovní položku.

Výběrem ikony x vedle pracovní položky odeberte odkaz na pracovní položku. Odebráním propojení se odebere pouze propojení mezi pracovní položkou a pr. Odkazy vytvořené ve větvi nebo z potvrzení zůstanou v pracovní položce.

Propojení pracovních položek s pr:

  1. V PR vyberte kartu Přehled.

    Snímek obrazovky znázorňuje výběr karty Přehled a tlačítka položek odkazu

  2. V oblasti Pracovní položky vyberte tlačítko Přidat. Ikona Přidat v nátažech

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

Odeberte odkazy na pracovní položky výběrem tlačítka Odebrat, které se zobrazí, když na pracovní položku najedete myší. Tlačítko odebrat Odebráním propojení se odebere pouze propojení mezi pracovní položkou a pr. 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. Vyberte pracovní položku ze seznamu, který se zobrazí.

Odeberte odkazy na pracovní položky výběrem tlačítka odebrat, které se zobrazí při najetí myší na pracovní položku. Odebrat ikonu Odebrání odkazu 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 k žádosti o získání dat

Použijte značky k zobrazení důležitých podrobností a k organizování pr. Značky mohou kontrolorům sdělit další informace, například o tom, že žádost o přijetí změn stále probíhá, nebo se jedná o opravu hotfix pro nadcházející vydání.

Snímek obrazovky, který zobrazuje P RS s značkami

Chcete-li přidat značku při vytváření žádosti o přijetí změn, zadejte název značky v části značky . Po vytvoření žádosti o přijetí změn můžete značky spravovat v části značky .

Snímek obrazovky, který ukazuje zvýrazněnou část značky P R.

Přidání popisků k žádosti o získání dat

Další informace o žádosti o přijetí změn můžete sdělit kontrolorům pomocí popisků. Je možné, že žádost o přijetí změn stále probíhá, nebo se jedná o opravu hotfix pro nadcházející vydání. Použijte štítky k sdělování důležitých podrobností a k organizování pr.

Poznámka

Použití popisků PR vyžaduje TFS 2018,2 nebo novější verzi.

Snímek obrazovky s popisky v P RS

Chcete-li při vytváření žádosti o přijetí změn přidat popisek, vyberte možnost Přidat popisek. Po vytvoření žádosti o přijetí změn můžete její popisky spravovat v části Štítky .

Přidat popisek P R

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

K žádosti o přijetí změn můžete během nebo po vytvoření připojit soubory včetně obrázků. Vyberte ikonu sponového klipu pod polem Popis nebo přetáhněte soubory přímo do pole Popis v žádosti o přijetí změn.

Snímek obrazovky, který ukazuje připojení souborů k popisu P R během vytváření.

Změna cílové větve aktivní žádosti o získání dat

U většiny týmů skoro všechny PR cílí na výchozí větev, jako je 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. Pokud k tomu dojde, můžete změnit cílovou větev aktivní žádosti o přijetí změn:

  1. Na stránce s přehledem žádosti o přijetí změn klikněte v pravém horním rohu na tlačítko změnit cílovou větev a pak v rozevírací nabídce vyberte změnit cílovou větev .
  2. V podokně změnit cílovou větev vyberte možnost zvolit cílovou větev, vyberte novou větev a pak vyberte změnit.

Oznámení žádostí o přijetí změn e-mailem účastníkům

Žádost o přijetí změn můžete sdílet e-mailem, abyste oznámení informovali recenzenty a komunikovali se členy týmu. Sdílení žádosti o přijetí změn:

  1. Na stránce s přehledem žádosti o přijetí změn vyberte Další možnosti a pak vyberte sdílet žádost opřijetí změn.

    Snímek obrazovky, který zobrazuje výběr sdílené žádosti o přijetí změn na stránce přehledu P R.

  2. Na obrazovce sdílet žádost o přijetí změn přidejte příjemce zadáním jejich názvů do pole Komu: a vyberte 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 požadující pozornost a propojí se s žádostí o přijetí změn.

Poznámka

Použijete-li funkci integrovaného e-mailu, můžete odeslat e-mail pouze na jednotlivé adresy členů projektu. Přidání týmové skupiny nebo skupiny zabezpečení do řádku do: 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ů vašeho e-mailu nemá oprávnění ke čtení poštovní žádosti o přijetí změn.

aby funkce e-mail fungovala, musí správce Azure DevOps Server nakonfigurovat Server SMTP.

Další kroky