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

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:

  

• Na stránce Soubory:

  

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.

Pokud chcete v projektu vytvořit novou žádost o přijetí změn, použijte příkaz az repos pr create. Pokud chcete žádost o přijetí změn otevřít v prohlížeči po vytvoření, použijte parametr --open .

az repos pr create [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--open]
                   [--org]
                   [--project]
                   [--repository]
                   [--reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--subscription]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

Následující příkaz vytvoří žádost o přijetí změn z new větve do výchozí main větve úložiště Fabrikam, otevře žádost o přijetí změn v prohlížeči a zobrazí výstup příkazu v tabulce. Příklad používá výchozí konfiguraci: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos pr create --repository Fabrikam --source-branch new --open --output table

ID    Created     Creator              Title                         Status    IsDraft    Repository
----  ----------  -------------------  ----------------------------  --------  ---------  ------------
30    2021-10-31  jamalh@fabrikam.com  Updated note-new-git-tool.md  Active    False      Fabrikam

K vytvoření žádosti o přijetí změn nebo po jeho vytvoření můžete přidat mnoho dalších podrobností o žádosti o přijetí změn. Pokud chcete do žádosti o přijetí změn přidat podrobnosti, revidujícím, pracovní položky a možnosti dokončení, přečtěte si téma Přidání podrobností nebo úprava žádostí o přijetí změn.

Příkazy Rozhraní příkazového řádku Azure DevOps se pro Azure DevOps Server nepodporují.

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.

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

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.

Pokud chcete vytvořit žádost o přijetí změn jako koncept, nastavte --draft parametr při true vytváření žádosti o přijetí změn. (Vyžaduje Azure DevOps Server 2020 nebo novější verzi.)

Příklad:

az repos pr create --repository Fabrikam --source-branch new --draft true

Chcete-li nastavit existující žádost o přijetí změn na koncept, použijte az repos pr update --id <PR Id> --draft true.

Pokud chcete z žádosti o přijetí změn odebrat koncept, nastavte na hodnotu --draft false.

Příkazy Rozhraní příkazového řádku Azure DevOps se pro Azure DevOps Server nepodporují.

Během vytváření žádosti o přijetí změn můžete přidat podrobnosti pomocí příkazu az repos pr create nebo aktualizovat podrobnosti v existujících žádostech o přijetí změn pomocí příkazu az repos pr update.

Když vytvoříte žádost o přijetí změn, az repos pr createpřidejte --title a zobrazte podrobné --description informace o změnách, aby ostatní viděli, jaké problémy změny řeší. Parametr --description přijímá položku Markdownu a každá hodnota v argumentu je nový řádek popisu žádosti o přijetí změn.

Příklad:

az repos pr create --repository Fabrikam --source-branch new --title "Update the readme" --description "This PR updates the readme." "These are *new* changes."

Udržujte tato pole v aktualizovaném stavu, aby revidujícím pochopili změny v žádosti o přijetí změn. Pokud chcete aktualizovat podrobnosti žádosti o přijetí změn, použijte az repos pr update s požadovaným parametrem žádosti o přijetí změn --id .

Pokud chcete například aktualizovat název a popis žádosti o přijetí změn č. 21, použijte:

az repos pr update --id 21 --description "These updates are *no longer new*." --title "Old updates"

Příkazy Rozhraní příkazového řádku Azure DevOps se pro Azure DevOps Server nepodporují.

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.

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.

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.

   

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.

   

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.

K žádosti o přijetí změn můžete přidat volitelné revidujícím při vytváření pomocí
az repos pr create --reviewer "<Reviewer Name>" "<Another Reviewer>".

Příklad:

az repos pr create --repository Fabrikam --source-branch new --reviewer "[Fabrikam]\Fabrikam Team" "[Fabrikam Fiber]\Web"

Pokud chcete přidat požadované revidujících nebo změnit revidujících mezi volitelnými a požadovanými, otevřete a aktualizujte žádost o přijetí změn v prohlížeči.

Pokud chcete spravovat revidující existující žádosti o přijetí změn, použijte příkaz az repos pr reviewer.

• Pokud chcete do existující žádosti o přijetí změn přidat revidující, použijte
  az repos pr reviewer add --id <PR Id> --reviewer "<Reviewer Name>" "<Another Reviewer>".
• Chcete-li zobrazit seznam revidujících žádosti o přijetí změn, použijte az repos pr reviewer list --id <PR Id>.
• Pokud chcete revidujícím odebrat z žádosti o přijetí změn, použijte az repos pr reviewer remove --id <PR Id> --reviewer "<Reviewer Name>".

az repos pr reviewer add --id
                         --reviewers
                         [--detect {false, true}]
                         [--org]
                         [--subscription]

Příkazy Rozhraní příkazového řádku Azure DevOps se pro Azure DevOps Server nepodporují.

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 .

   

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.

   

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

Pracovní položky Azure Boards můžete propojit s žádostmi o přijetí změn při vytváření žádosti o přijetí změn s az repos pr create --work-items <Id1> <Id2>ID> pracovní položky.<

Například následující příkaz odkazuje na pracovní položky #63 a #64 na novou žádost o přijetí změn ve new větvi:

az repos pr create --repository Fabrikam --source-branch new --work-items 63 64

Pokud chcete spravovat pracovní položky pro existující žádost o přijetí změn, použijte příkaz az repos pr work-item.

• Chcete-li propojit pracovní položky s existující žádostí o přijetí změn, použijte az repos pr work-item add --id <PR Id> --work-items <Id1> <Id2>.
• Chcete-li zobrazit seznam pracovních položek propojených s žádostí o přijetí změn, použijte az repos pr work-item list --id <PR Id>.
• Pokud chcete zrušit propojení pracovní položky z žádosti o přijetí změn, použijte az repos pr work-item remove --id <PR Id> --work-items <Id1>příkaz . Zrušení propojení odebere pouze propojení mezi pracovní položkou a žádostí o přijetí změn. Odkazy vytvořené ve větvi nebo potvrzení zůstanou v pracovní položce.

az repos pr work-item add --id
                          --work-items
                          [--detect {false, true}]
                          [--org]
                          [--subscription]

Příkazy Rozhraní příkazového řádku Azure DevOps se pro Azure DevOps Server nepodporují.