Spojte potvrzení, pull requesty, větve a úlohy GitHubu s pracovními položkami v Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

V tomto článku se dozvíte, jak propojit pracovní položky s potvrzeními GitHubu, žádostmi o přijetí změn a větvemi po připojení projektu Azure Boards s úložištěm GitHub. Můžete použít syntaxi #mention pro potvrzení a větve nebo přidat potvrzení GitHubu, žádost o přijetí změn nebo odkaz na větev přímo z pracovní položky Azure Boards.

Note

Podpora integrace GitHubu:

• Azure DevOps Services: Integruje se s úložišti GitHub.com i GitHub Enterprise Server prostřednictvím aplikace Azure Boards pro GitHub.
• Azure DevOps Server 2020 a novější: Podporuje integraci pouze s úložišti GitHub Enterprise Serveru.
• Jiná úložiště Git: Integrace se nepodporuje.

Prerequisites

Category	Requirements
Permissions	Přispěvatel do projektu Azure Boards i úložiště GitHub.
Připojení projektu	Projekt Azure Boards je připojený k úložišti GitHub, kde jsou commity, pull requesty a větve, ke kterým chcete vytvořit propojení nebo z nichž chcete propojení vytvořit. Další informace najdete v tématu Azure Integrace Boards-GitHub.

Note

Projekty, které používají model hostovaného procesu XML, vyžadují aktualizace typů pracovních položek pro zobrazení oddílu Vývoj a typy odkazů GitHubu. Další informace naleznete v tématu Aktualizace definic XML pro vybrané typy pracovních položek.

Pomocí AB# odkazujte z GitHubu na pracovní položky Azure Boards

Z potvrzení GitHubu, žádosti o přijetí změn nebo problému vytvořte pomocí následující syntaxe odkaz na pracovní položku Azure Boards. Zadejte AB#ID do textu zprávy potvrzení. Nebo v případě žádosti o přijetí změn nebo problému zadejte AB#ID do popisu. Použití AB#ID v komentáři nebo názvu žádosti o přijetí změn nevytvoří odkaz na pracovní položku.

AB#{ID}

Například AB#125 odkazuje na pracovní položku s ID 125.

Můžete také zadat zprávu potvrzení nebo žádosti o přijetí změn a převést pracovní položku. Systém rozpozná {state} nebo {state category}, společně s fix, fixes a fixed, a použije to na položku, která následuje po #-zmínce.

Pokud popis žádosti o přijetí změn obsahuje například platný název Closed AB#1234stavu, systém aktualizuje odkazovanou pracovní položku na tento konkrétní stav. Pokud se název stavu nerozpozná přímo, Azure Boards se ho pokusí spárovat s kategorií pracovního postupu, například Resolved nebo Completed. Pokud se najde shoda, pracovní položka přejde do prvního dostupného stavu definovaného v této kategorii.

Ve výchozím nastavení pracovní položky odkazované pomocí fix, fixesnebo fixed přecházejí do prvního stavu přidruženého ke kategorii Vyřešeno . Pokud v aktuálním procesu žádný takový stav neexistuje, systém místo toho převede pracovní položku do prvního stavu v kategorii Dokončeno .

Important

Stále můžete propojit pracovní položky a cílit na jiné větve, ale pravidla přechodu stavu se neuplatní, pokud pull request není sloučena do výchozí větve.

Další informace najdete v tématu Použití stavů kategorií pracovních postupů v backlogech a panelech Azure Boards.

Projděte si následující tabulku příkladů:

Zpráva o potvrzení nebo žádosti o přijetí změn	Action
Fixed AB#123	Propojí a přepojí pracovní položku do kategorie Vyřešený stav pracovního postupu nebo pokud není definována žádná, pak kategorie Dokončený stav pracovního postupu.
Closed AB#123	Umožňuje propojit a převést pracovní položku do stavu Uzavřený pracovní postup. Pokud není definován žádný, neprovedou se žádné přechody.
Adds a new feature, fixes AB#123.	Propojí a přepojí pracovní položku do kategorie Vyřešený stav pracovního postupu nebo pokud není definována žádná, pak kategorie Dokončený stav pracovního postupu.
Fixes AB#123, AB#124, and AB#126	Odkazy na pracovní položky Azure Boards 123, 124 a 126. Provede přechod pouze první položku, 123 do kategorie Vyřešený stav pracovního postupu, nebo pokud není definován žádný, pak kategorie Dokončeno stav pracovního postupu.
Fixes AB#123, Fixes AB#124, Fixes AB#125	Odkazy na pracovní položky Azure Boards 123, 124 a 126. Přemísí všechny položky do kategorie Vyřešený stav pracovního postupu nebo pokud není definována žádná, pak kategorie Dokončený stav pracovního postupu.
Fixing multiple bugs: issue #123 and user story AB#234	Odkazy na problém s GitHubem 123 a pracovní položkou Azure Boards 234 Neprovedou se žádné přechody.

Note

Pokud jste připojili stejné úložiště GitHub k projektům definovaným ve dvou nebo více organizacích Azure DevOps, může se zobrazit neočekávané propojení zmínek s označením AB#. Další informace najdete v tématu Řešení problémů s připojením. Z tohoto důvodu doporučujeme připojit úložiště GitHub pouze k projektům definovaným v jedné organizaci Azure DevOps.

Když přidáte odkaz na pracovní položku pomocí AB#, zobrazí se tyto odkazy v části Vývoj žádosti o přijetí změn.

Vytvoření větve GitHubu z pracovní položky

Pokud chcete vytvořit větev GitHubu přímo z pracovní položky, postupujte takto:

1. Na panelu najděte pracovní položku, ze které chcete vytvořit větev GitHubu.

2. Vyberte Akce pracovní položky>Nová větev na GitHubu.

   

3. V dialogovém okně Vytvořit větev GitHubu zadejte název větve a vyberte úložiště GitHub a základní větev.

4. Vyberte Vytvořit.

   

   Azure Boards vytvoří větev v zadaném úložišti GitHub a propojí ji s pracovní položkou. Další informace najdete v tématu Azure Integrace Boards-GitHub.

Přidejte odkaz na pracovní položku do větve, commitu nebo pull requestu v GitHubu.

1. Otevřete pracovní položku a přejděte na kartu Odkazy .

   

2. V dialogovém okně Přidat odkaz vyberte jeden z typů odkazů GitHubu , vyberte úložiště GitHub, zadejte adresu URL větve GitHubu, potvrzení nebo žádost o přijetí změn a pak vyberte Přidat odkaz.

   V následujícím příkladu přidáme odkaz na pull request na GitHubu.

   

   Azure Boards dokončí kontrolu, abyste měli jistotu, že jste zadali platný odkaz. Úložiště propojené s GitHubem musí být připojené k projektu Azure Boards nebo ověření selže.

Automatické aktualizace propojení

Několik událostí automaticky aktualizuje propojení ve formuláři pracovní položky, takže je nemusíte vytvářet ručně. Patří mezi ně:

Událost GitHubu	Action
Odkaz na větev	Když se vytvoří pull request z větve, automaticky se propojuje s pracovní položkou.
Potvrzení sloučení	Po sloučení pull requestu se výsledný potvrzovací sloučení automaticky propojuje s pracovní položkou.
Odstranit větev	Pokud je větev odstraněna (obvykle po sloučení), její odkaz se automaticky odebere z pracovní položky.

Zobrazení nebo otevření odkazů z části Vývoj

Sekce Vývoj ve formuláři pracovní položky obsahuje odkazy vytvořené na commity a pull requesty na GitHubu s ikonkou GitHubu .

Vyberte poskytnutý odkaz pro otevření commitu nebo pull requestu na GitHubu.

Zobrazení objektů GitHubu na panelu

Pokud jsou na panelu povolené poznámky GitHubu, můžete rychle otevřít propojené potvrzení GitHubu, žádosti o přijetí změn nebo problémy, abyste mohli získat další podrobnosti. Další informace naleznete v tématu Přizpůsobení karet.

Další kroky

Konfigurace odznáček stavu

Související obsah

• Integrace Azure Boards s GitHubem
• Vysvětlení způsobu použití stavů kategorií pracovního postupu v backlogech a panelech Azure Boards
• Propojení pracovních položek s objekty
• Řešení potíží s integrací GitHubu a Azure Boards