Łączenie zatwierdzeń, żądań ściągnięcia i problemów z elementami roboczymi w usłudze Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Po połączeniu projektu usługi Azure Boards z repozytorium GitHub możesz połączyć elementy robocze z zatwierdzeniami i żądaniami ściągnięcia usługi GitHub. Użyj składni #mention lub dodaj link zatwierdzenia lub żądania ściągnięcia usługi GitHub bezpośrednio z elementu roboczego usługi Azure Boards.

Uwaga

Dzięki aplikacji Azure Boards dla usług GitHub usługi Azure Boards i Azure DevOps Services obsługują integrację z repozytoriami GitHub.com i GitHub Enterprise Server. Serwery Azure DevOps Server 2019 i nowsze obsługują integrację tylko z repozytoriami GitHub Enterprise Server. Integracja z innymi repozytoriami Git nie jest obsługiwana.

Wymagania wstępne

• Projekt usługi Azure Boards musi być połączony z repozytorium GitHub, w którym istnieją zatwierdzenia i żądania ściągnięcia, do których chcesz utworzyć łącze. Aby uzyskać więcej informacji, zobacz Integracja z usługą Azure Boards-GitHub.
• Musisz być współautorem projektu usługi Azure Boards i repozytorium GitHub.

Uwaga

Projekty korzystające z modelu procesów Hostowany XML wymagają aktualizacji typów elementów roboczych w celu wyświetlenia sekcji Programowanie i typów linków usługi GitHub. Aby uzyskać więcej informacji, zobacz Aktualizowanie definicji XML dla wybranych typów elementów roboczych.

Użyj AB# polecenia , aby połączyć się z usługą GitHub do elementów roboczych usługi Azure Boards

Z poziomu zatwierdzenia usługi GitHub, żądania ściągnięcia lub problemu użyj następującej składni, aby utworzyć link do elementu roboczego usługi Azure Boards. AB#ID Wprowadź tekst komunikatu zatwierdzenia. W przypadku żądania ściągnięcia lub problemu wprowadź AB#ID wartość w tytule lub opisie. Użycie AB#ID w komentarzu nie powoduje utworzenia linku do elementu roboczego.

AB#{ID}

Na przykład AB#125 linki do elementu roboczego o identyfikatorze 125.

Możesz również wprowadzić komunikat zatwierdzenia lub żądania ściągnięcia, aby przenieść element roboczy. System rozpoznaje fix, fixes, fixed i stosuje go do elementu #-mention, który następuje poniżej. Wymienione elementy robocze przechodzą do pierwszego stanu skojarzonego ze stanem kategorii Rozwiązane przepływ pracy. Jeśli nie ma stanu skojarzonego z rozwiązaniem Resolved, nastąpi przejście do stanu skojarzonego z stanem ukończonego przepływu pracy. Aby uzyskać więcej informacji, zobacz How workflow category states are used in Azure Boards backlogs and boards (Jak są używane stany kategorii przepływu pracy w listach prac i tablicach usługi Azure Boards).

Zapoznaj się z poniższą tabelą przykładów:

Komunikat zatwierdzenia lub żądania ściągnięcia	Akcja
Fixed AB#123	Łączy i przenosi element roboczy do kategorii Stan rozwiązanego przepływu pracy lub, jeśli żaden nie jest zdefiniowany, to kategoria Ukończono stan przepływu pracy.
Adds a new feature, fixes AB#123.	Łączy i przenosi element roboczy do kategorii Stan rozwiązanego przepływu pracy lub, jeśli żaden nie jest zdefiniowany, to kategoria Ukończono stan przepływu pracy.
Fixes AB#123, AB#124, and AB#126	Linki do elementów roboczych usługi Azure Boards 123, 124 i 126. Przenosi tylko pierwszy element, 123 do kategorii Stan rozwiązanego przepływu pracy lub, jeśli żaden z nich nie jest zdefiniowany, a następnie kategoria Ukończony stan przepływu pracy.
Fixes AB#123, Fixes AB#124, Fixes AB#125	Linki do elementów roboczych usługi Azure Boards 123, 124 i 126. Przenosi wszystkie elementy do kategorii Stan rozwiązanego przepływu pracy lub, jeśli żaden z nich nie jest zdefiniowany, a następnie kategorię Ukończono stan przepływu pracy.
Fixing multiple bugs: issue #123 and user story AB#234	Linki do problemu 123 w usłudze GitHub i elementu roboczego usługi Azure Boards 234. Nie są wykonywane żadne przejścia.

Uwaga

Jeśli połączono to samo repozytorium GitHub z projektami zdefiniowanymi w co najmniej dwóch organizacjach usługi Azure DevOps, może zostać wyświetlone nieoczekiwane łączenie wzmianki AB# . Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z połączeniem. Z tego powodu zalecamy połączenie repozytorium GitHub tylko z projektami zdefiniowanymi w jednej organizacji usługi Azure DevOps.

Dodawanie linku z elementu roboczego do zatwierdzenia, żądania ściągnięcia lub problemu w usłudze GitHub

1. Aby połączyć się z zatwierdzeniem lub żądaniem ściągnięcia, otwórz element roboczy i wybierz pozycję Dodaj link w sekcji Programowanie.

   

   Wybierz typ linku z menu rozwijanego Typ łącza.

   

2. W oknie dialogowym Dodawanie linku wybierz jeden z typów linków usługi GitHub, wybierz repozytorium GitHub, wprowadź adres URL gałęzi GitHub, zatwierdzenia lub żądania ściągnięcia, a następnie wybierz pozycję Dodaj link.

   W poniższym przykładzie dodamy link do żądania ściągnięcia usługi GitHub.

   

   Usługa Azure Boards kończy sprawdzanie, aby upewnić się, że wprowadzono prawidłowy link. Repozytorium Połączone z usługą GitHub musi być połączone z projektem usługi Azure Boards lub walidacja kończy się niepowodzeniem.

Wyświetlanie lub otwieranie linków z sekcji Programowanie

Sekcja Programowanie w formularzu elementu roboczego zawiera linki utworzone do zatwierdzeń usługi GitHub i żądań ściągnięcia za pomocą ikony usługi GitHub.

Wybierz podany link, aby otworzyć zatwierdzenie lub żądanie ściągnięcia w usłudze GitHub.

Wyświetlanie obiektów usługi GitHub na tablicy

Dzięki włączeniu adnotacji usługi GitHub na tablicy można szybko otwierać połączone zatwierdzenia, żądania ściągnięcia lub problemy w usłudze GitHub, aby uzyskać więcej szczegółów. Aby uzyskać więcej informacji, zobacz Dostosowywanie kart.

Następne kroki

Konfigurowanie znaczków stanu

Powiązane artykuły

• Integracja usługi Azure Boards z usługą GitHub
• Jak są używane stany kategorii przepływu pracy na listach prac i tablicach usługi Azure Boards
• Łączenie elementów roboczych z obiektami
• Rozwiązywanie problemów z integracją z usługą GitHub i usługą Azure Boards