Udostępnij za pośrednictwem


Łą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. Linki można dodawać przy użyciu składni #mention znanej użytkownikom usługi GitHub lub dodać typ linku zatwierdzenia usługi GitHub lub linku do żądania ściągnięcia usługi GitHub 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.

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. Lub w przypadku żądania ściągnięcia lub problemu wprowadź AB#ID w tytule lub opisie (a nie komentarz).

Uwaga

Łączenie z usługą GitHub wymaga usługi Azure DevOps Server 2019 Update 1 lub nowszej wersji.

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 dowiedzieć się, jak są mapowane stany przepływu pracy i stany kategorii, 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.

Uwaga

Łączenie z usługą GitHub wymaga usługi Azure DevOps Server 2019 Update 1 lub nowszej wersji.

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

    Screenshot of work item form, Development section, Add link option.

    Aby połączyć się z problemem, wybierz kartę Linki , a następnie wybierz pozycję Dodaj łącze>istniejący element.

    Screenshot of work item form, Links tab, Add link to issue.

  2. W oknie dialogowym Dodawanie linku wybierz jeden z typów linków usługi GitHub, wprowadź adres URL zatwierdzenia, żądania ściągnięcia lub problemu, a następnie wybierz przycisk OK.
    W tym miejscu dodajemy link do żądania ściągnięcia usługi GitHub.

    Screenshot of work item form, Links tab, Add link dialog, GitHub pull request link type selected.

    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.

    W tym miejscu dodajemy link do problemu z usługą GitHub.

    Screenshot of work item form, Links tab, Add link dialog, GitHub issue link type selected.

Uwaga

Podczas kończenia linków AB# występuje opóźnienie, jeśli używasz serwera Usługi Azure DevOps i serwera GitHub Enterprise Server. Mamy projekt "wypychania i ściągania" do ściągania ze zdarzeń usługi GitHub co godzinę w przypadku zmian przyrostowych w zatwierdzaniu, żądaniu ściągnięcia i problemu.

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.

Screenshot of work item form, Development section shows GitHub links.

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

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

Dzięki adnotacjom usługi GitHub włączonym na tablicy Kanban 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.

Screenshot of Kanban board that shows GitHub links on work item cards.

Uwaga

Adnotacje usługi GitHub wymagają usługi Azure DevOps Server 2019 Update 1 lub nowszej wersji.

Następne kroki