Autouzupełnianie elementów roboczych przy użyciu żądań pobrania

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

Po połączeniu elementu roboczego z pull requestem (PR), można automatycznie zamknąć te elementy robocze po zakończeniu PR. Alternatywnie można określić stan przepływu pracy, aby przejść do elementu roboczego podczas scalania żądania ściągnięcia.

Ta automatyzacja usprawnia przepływ pracy programowania, zapewniając, że elementy robocze odzwierciedlają bieżący stan zmian kodu bez ręcznej interwencji.

Aby uzyskać więcej informacji, zobacz Tworzenie, wyświetlanie i zarządzanie żądaniami ściągnięcia.

Wymagania wstępne

Kategoria	Wymagania
Uprawnienia	— Aby wyświetlać, śledzić i edytować elementy robocze: Wyświetl elementy robocze w tym węźle i Edytuj elementy robocze w tym węźle uprawnienia ustawione na Zezwalaj. Domyślnie grupa Współautorzy ma te uprawnienia. Aby uzyskać więcej informacji, zobacz Ustaw uprawnienia śledzenia pracy. — Aby dodać tagi do elementów roboczych: na poziomie projektu Utwórz nową definicję tagu ustawioną na Zezwalaj na. Domyślnie grupa Współautorzy ma to uprawnienie.
poziomy dostępu	- członek projektu. — Aby dodać nowe tagi do elementów roboczych, przeglądać lub śledzić żądania ściągnięcia: co najmniej podstawowy dostęp. - Aby wyświetlić lub śledzić elementy robocze: co najmniej dostęp dla interesariusza. Aby uzyskać więcej informacji, zobacz About access levels (Informacje o poziomach dostępu). — Wszyscy członkowie projektu, w tym członkowie grupy Czytelnicy, mogą wysyłać wiadomości e-mail zawierające elementy robocze.
uprawnienia usługi GitHub	współautor do repozytorium GitHub.

Autouzupełnianie zadań roboczych

Aby włączyć automatyczne ukończenie połączonych elementów roboczych podczas scalania pull requesta, zaznacz pole wyboru Ukończ połączone elementy robocze po scaleniu, jak pokazano na poniższym obrazku. System zapisuje wybór jako domyślny dla przyszłych pull requestów.

Gdy automatyczne uzupełnianie nie występuje

System nie aktualizuje automatycznie stanu elementu roboczego do kategorii Gotowe, Zamknięte lub Ukończone dla typu elementu roboczego (WIT) w następujących okolicznościach:

• Element roboczy już w stanie Rozwiązany: element roboczy, którego typ elementu roboczego (WIT) używa modelu procesu dziedziczenia, jest już w stanie Rozwiązany. W tym przypadku system nie aktualizuje stanu. Na przykład, jeśli usterka pochodząca z procesu Agile jest w Stanie Rozwiązany, system nie przenosi jej do Stanu Zamkniętego.
• Element roboczy został już ukończony: element roboczy znajduje się już w kategorii Ukończono . Nie jest wymagane żadne dalsze przejście.
• Reguły przepływu pracy uniemożliwiają przejście: WIT zawiera reguły pól przepływu pracy, które uniemożliwiają przechodzenie elementu roboczego do następnego stanu. Na przykład reguła może wymagać zdefiniowania innego pola podczas zamykania elementu roboczego.
• Konfiguracja lokalnego przepływu pracy: w przypadku wdrożeń lokalnych i modelu procesów hostowanych w usłudze Azure Boards należy zmodyfikować przepływ pracy, aby określić akcje (element ACTION ), które mają mieć miejsce podczas przechodzenia przepływu pracy. Aby uzyskać więcej informacji, zobacz Zmienianie przepływu pracy dla funkcji WIT, Określanie akcji.

Aby uzyskać więcej informacji na temat dostosowywania przepływów pracy, zobacz Dostosowywanie środowiska śledzenia pracy.

Określanie stanu przepływu pracy połączonych elementów roboczych

Element roboczy można przenieść do określonego stanu przepływu pracy poprzez wprowadzenie informacji w opisie pull requestu. Prefiks #ID z prawidłowym stanem przepływu pracy dla wymienionego elementu roboczego. Takie podejście zapewnia dokładną kontrolę nad sposobem przejścia elementów roboczych podczas scalania zmian kodu.

W poniższym przykładzie przedstawiono scenariusze użytkownika, które przechodzą — jeden do stanu Rozwiązane , a drugi do stanu Recenzja . System oznacza również dwa zadania jako Gotowe.

Składnia przejść stanu

Użyj następujących wzorców składni w opisie prośby o zatwierdzenie, aby określić przejścia stanu:

• Resolves #123 — Przenosi element roboczy 123 do stanu Rozwiązane
• Fixes #456 — Przenosi element roboczy 456 do odpowiedniego stanu ukończonego
• Closes #789 — Przechodzi element roboczy 789 do stanu Zamknięte
• Review #101 — Przenosi element roboczy 101 do stanu Recenzja

System rozpoznaje typowe słowa kluczowe i stosuje odpowiednie przejście stanu w zależności od konfiguracji przepływu pracy dla typu elementu roboczego.

Wyłączanie automatycznego uzupełniania skojarzonych elementów roboczych

Aby wyłączyć automatyczne zakończenie skojarzonych elementów roboczych po ukończeniu pull requestów przez użytkowników, wykonaj następujące kroki:

1. Przejdź do obszaruRepozytoria>ustawień> projektu i wybierz repozytorium.
2. Na karcie Ustawieniawyłącz przełącznikw polu Zatwierdzanie rozpoznawania elementów roboczych.

Po wyłączeniu tego ustawienia system nie zezwala na zamykanie elementów roboczych w komentarzach zatwierdzeń (na przykład "Poprawki nr 123"). To ustawienie ma wpływ zarówno na uzupełnianie żądań ściągnięcia, jak i bezpośrednie wzmianki o zatwierdzeniach.

Najlepsze rozwiązania

Podczas korzystania z automatycznego uzupełniania elementów roboczych należy wziąć pod uwagę następujące najlepsze rozwiązania:

• Przejrzyj stany elementów roboczych: przed włączeniem automatycznego uzupełniania upewnij się, że stany elementów roboczych są zgodne z oczekiwaniami dotyczącymi przepływu pracy zespołu.
• Użyj określonych przejść stanu: jeśli potrzebujesz dokładnej kontroli, użyj składni przejścia stanu w opisach żądań pobrania, zamiast polegać na zachowaniu domyślnego uzupełniania.
• Testowanie reguł przepływu pracy: sprawdź, czy żadne niestandardowe reguły przepływu pracy nie uniemożliwiają automatycznych przejść stanu.
• Komunikacja z zespołem: upewnij się, że wszyscy członkowie zespołu rozumieją, jak automatyczne uzupełnianie wpływa na śledzenie elementów roboczych.

Rozwiązywanie problemów

Jeśli elementy robocze nie zostaną automatycznie ukończone zgodnie z oczekiwaniami:

1. Sprawdź uprawnienia: Sprawdź, czy masz uprawnienia niezbędne do edytowania elementów roboczych.
2. Przejrzyj reguły przepływu pracy: upewnij się, że żadne reguły pól przepływu pracy nie uniemożliwiają przejścia stanu.
3. Weryfikowanie powiązań elementów roboczych: Potwierdź, że elementy robocze są prawidłowo powiązane z żądaniem ściągnięcia.
4. Sprawdź bieżący stan: Sprawdź, czy element roboczy nie jest jeszcze w stanie ukończonym.
5. Przejrzyj ustawienia repozytorium: Upewnij się, że automatyczne uzupełnianie jest włączone w ustawieniach repozytorium.

Treści powiązane

• Tworzenie, przeglądanie i zarządzanie pull requestami
• Dostosowywanie przepływu pracy (proces dziedziczenia)
• Dostosowywanie środowiska śledzenia pracy
• Jak są używane stany przepływu pracy i kategorie stanów w backlogach i tablicach
• Łączenie elementów roboczych z innymi obiektami