Łączenie elementów roboczych z obiektami

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

Łącza elementów roboczych to skojarzenia między dwoma elementami roboczymi lub elementem roboczym i innym obiektem, które opisują ich relację. Możesz użyć linków elementów roboczych, aby śledzić zależności i powiązane prace w celu śledzenia, udostępniać informacje, zarządzać złożonymi projektami, które obejmują wiele zespołów lub produktów, śledzić zmiany kodu, testy i nie tylko.

• Łączenie elementów roboczych z różnymi obiektami
• Łączenie elementów roboczych z innymi elementami roboczymi
• Łączenie kilku elementów roboczych
• Zmienianie typu łącza istniejącego łącza
• Łączenie elementów roboczych z nowymi elementami roboczymi
• Łączenie elementów roboczych z elementami roboczymi w różnych projektach (między organizacjami)
• Łączenie elementów roboczych z żądaniami ściągnięcia
• Łączenie elementów roboczych z obiektami usługi GitHub
• Łączenie kilku elementów z nowymi gałęziami usługi Git
• Łączenie elementów roboczych z kompilacjami
• Łączenie elementów roboczych z wdrożeniami
• Łączenie elementów roboczych z programowaniem kodu TFVC
• Łączenie elementów roboczych z testami
• Łączenie elementów roboczych z witryną sieci Web, udziałem sieciowym, scenorysem lub dokumentem
• Wyświetlanie zależności i śledzenie powiązanej pracy
• Zapytanie dotyczące połączonych elementów roboczych
• Dodawanie, usuwanie lub pokazywanie linków za pomocą interfejsu wiersza polecenia platformy Azure
• Usuwanie łączy elementów roboczych

Wymagania wstępne

Wymaganie wstępne	opis
Administrator projektu lub członek współautora	Musisz zostać dodany do projektu jako członek grupy zabezpieczeń Współautorzy lub Administratorzy projektu.
Dostęp uczestników projektu	Aby dodać lub zmodyfikować elementy robocze, musisz udzielić uczestnikom projektu dostępu lub wyższego. Użytkownicy z dostępem uczestników projektu publicznego mają pełny dostęp do funkcji listy prac i tablic, takich jak użytkownicy z dostępem podstawowym . Aby uzyskać więcej informacji, zobacz Stakeholder access quick reference (Dostęp uczestnika projektu — krótki przewodnik).
Współautor członkowski lub Zezwalaj na perms na	— Aby wyświetlić lub zmodyfikować elementy robocze, musisz mieć pozycję Wyświetl elementy robocze w tym węźle i Edytować elementy robocze w tym węźle z uprawnieniami ustawionymi na Wartość Zezwalaj. Domyślnie grupa Współautorzy ma to uprawnienie ustawione na Wartość Zezwalaj. Aby uzyskać więcej informacji, zobacz Ustawianie uprawnień i dostępu do śledzenia pracy. — Aby skonfigurować opcje integracji dla klasycznego potoku wydania, musisz mieć uprawnienia do edytowania wydania. — Aby połączyć elementy robocze z zatwierdzeniami i żądaniami ściągnięcia, musisz mieć uprawnienia Edytuj elementy robocze w tym węźle ustawione na wartość Zezwalaj na ścieżkę obszaru przypisaną do elementu roboczego. Domyślnie grupa Współautorzy ma ten zestaw uprawnień. — Aby wyświetlić elementy robocze, musisz mieć uprawnienia Wyświetl elementy robocze w tym węźle ustawione na zezwalanie na ścieżkę obszaru przypisaną do elementu roboczego.
Zdefiniowane iteracji	Aby użyć okienka Planowanie , administrator zespołu musi zdefiniować ścieżki iteracji (przebiegu) i skonfigurować iteracji zespołu.

Jakie typy łączy istnieją?

Następujące typy linków ułatwiają zarządzanie różnymi relacjami między elementami roboczymi i innymi obiektami.

Typ linku	Kolumna2
Hiperlink	Łączy element roboczy z dowolnym adresem URL lub udziałem sieciowym
Typ łącza zewnętrznego	Łączy element roboczy z obiektem zewnętrznym, takim jak obiekt kodu, kompilacja lub strona typu wiki
Typ łącza pracy zdalnej	Łączy elementy robocze zdefiniowane w różnych organizacjach
Typ linku usługi GitHub	Łączy element roboczy z zatwierdzeniem, problemem lub żądaniem ściągnięcia repozytorium GitHub
Typ łącza roboczego	Łączy elementy robocze, w tym wybieranie elementów roboczych zarządzania przypadkami testowymi

Aby uzyskać więcej informacji na temat typów linków, w tym elementów nadrzędnych/podrzędnych, powiązanych, poprzedników i tak dalej, zobacz Link type reference/Work link types (Typy linków linków linków linków/typy linków roboczych).

Łączenie elementów roboczych z różnymi obiektami

Aby połączyć elementy robocze z różnymi obiektami, wykonaj następujące kroki.

1. W portalu internetowym otwórz element roboczy, z którego chcesz utworzyć łącze, lub utwórz nowy.
2. Wybierz kartę Łącza , a następnie wybierz pozycję Połącz z.
3. Z listy rozwijanej Typ łącza wybierz typ łącza, który chcesz utworzyć.
4. W polu Połącz z wprowadź lub wybierz obiekt, do którego chcesz utworzyć łącze. W zależności od typu łącza można wprowadzić lub wybrać następujące obiekty. Wybierz każdy obiekt, aby uzyskać więcej szczegółów.
   • Inny identyfikator lub tytuł elementu roboczego
   • Adres URL zdalnego elementu roboczego
   • Zewnętrzny adres URL żądania ściągnięcia usługi Git
   • Numer kompilacji lub nazwa definicji
   • Nazwa etapu wdrożenia lub nazwa środowiska
   • Adres URL strony internetowej lub dokumentu
5. (Opcjonalnie) Wprowadź komentarz, aby opisać link.
6. Wybierz OK, aby utworzyć link.

Napiwek

Istnieją inne funkcje, których można użyć do szybkiego łączenia lub zmieniania linków korzystających z typu linku nadrzędnego/podrzędnego (niektóre funkcje są zależne od wersji, zobacz połączone artykuły, aby uzyskać szczegółowe informacje).

• Aby połączyć elementy listy prac z elementami listy prac portfela lub zmienić strukturę linków między tymi elementami, użyj okienka mapowania, aby zorganizować listę prac. Możesz też wybrać opcję Pokaż elementy nadrzędne i przeciągać i upuszczać elementy w hierarchii drzewa.
• Aby utworzyć i połączyć zadania z elementami listy prac, użyj strony listy prac przebiegu. W portalu internetowym można również przeciągać i upuszczać elementy, aby zmienić strukturę łącza.
• Aby wcięć (), wciągnięcie () i zmienić strukturę łącza hierarchii drzewa, przewróć i zmień kolejność elementów z listy prac w portalu internetowym lub użyj zapytania drzewa w programie Team Explorer.
• Aby dodać lub usunąć elementy robocze lub zmienić strukturę łącza, możesz użyć programu Excel. Zobacz Zbiorcze dodawanie lub modyfikowanie elementów roboczych za pomocą programu Excel.

Łączenie elementów roboczych z innymi elementami roboczymi

Wykonaj poniższe kroki, aby dodać link do innego scenariusza użytkownika, epika, funkcji, usterki, problemu lub zadania z portalu internetowego.

1. Otwórz element roboczy, który chcesz połączyć z innym elementem roboczym.
2. W formularzu elementu roboczego wybierz sekcję Powiązana praca .
3. Wybierz pozycję Dodaj link, a następnie pozycję Istniejący element.
4. Z listy rozwijanej Typ łącza wybierz typ łącza, który chcesz utworzyć (na przykład Nadrzędny, Podrzędny, Powiązany itd.).
5. W polu Element roboczy wprowadź identyfikator elementu roboczego, z którym chcesz połączyć, a następnie wybierz przycisk OK. W poniższym przykładzie użyjemy typu linku Powiązane , aby połączyć trzy elementy z usterkami o identyfikatorze 400.

Łącza można dodawać tylko pojedynczo. Nie można wprowadzać ich identyfikatorów rozdzielonych przecinkami ani spacjami.

6. (Opcjonalnie) Jeśli pracujesz na stronie Wyniki zapytania, zapisz zbiorczo zmodyfikowane elementy robocze. Podczas pracy z listy prac elementy robocze są automatycznie zapisywane.

Łączenie kilku elementów roboczych

1. W portalu internetowym otwórz stronę listy prac lub wyników zapytania, a następnie wybierz wiele elementów roboczych, do których chcesz dodać link.

2. Otwórz menu kontekstowe ... jednego z wybranych elementów roboczych, wybierz pozycję Dodaj link, a następnie wybierz pozycję Istniejący element... lub Nowy element....

   W poniższym przykładzie wybieramy wiele elementów z listy prac produktu i wybieramy pozycję Istniejący element....

Zmienianie typu łącza istniejącego łącza

1. W portalu internetowym otwórz element roboczy i wybierz pozycję Linki.

2. Wybierz pozycję Więcej akcji>Edytuj link.

   

3. Wybierz typ łącza, na który chcesz zmienić, a następnie wybierz pozycję Zapisz.

   

4. Zapisz element roboczy.

Łączenie elementów roboczych z nowymi elementami roboczymi

Wykonaj następujące kroki, aby połączyć element roboczy z nowym elementem roboczym.

1. Określ typ łącza, typ elementu roboczego i tytuł nowego elementu roboczego. Wybierz przycisk OK. Zostanie otwarty element roboczy wybranego typu.

   

2. Wprowadź dodatkowe informacje i zapisz element roboczy.

   

3. (Opcjonalnie) Jeśli pracujesz ze strony Wyniki zapytania, zapisz zbiorczo zmodyfikowane elementy robocze.

Łączenie elementów roboczych ze zdalnymi elementami roboczymi (między organizacjami)

Organizacje korzystające z identyfikatora Entra firmy Microsoft mogą łączyć się z elementami roboczymi istniejącymi w różnych projektach w organizacjach. Użyj następujących typów linków, jak wskazano:

• Użyj opcji Użycie z/tworzy typy łączy, jeśli chcesz śledzić zależności elementów roboczych zdefiniowanych w różnych organizacjach i zarządzanych przez różne zespoły.
• Użyj typu linku Powiązane zdalnie, gdy połączone elementy robocze są definiowane w różnych organizacjach i zarządzane przez różne zespoły, ale nie mają silnych zależności między nimi.

Wykonaj następujące kroki, aby połączyć elementy robocze z obiektami zdefiniowanymi w innych organizacjach usługi Azure DevOps. Można to zrobić tylko wtedy, gdy obie organizacje używają tego samego identyfikatora Entra firmy Microsoft do zarządzania użytkownikami.

1. Wybierz jeden z następujących typów linków zdalnych:

   • Korzysta z/tworzy dla: jeśli chcesz śledzić zależności elementów roboczych zdefiniowanych w różnych organizacjach i zarządzanych przez różne zespoły.
   • Powiązane zdalnie: gdy połączone elementy robocze są definiowane w różnych organizacjach i zarządzane przez różne zespoły, ale nie mają silnych zależności między nimi.

2. W oknie dialogowym Dodawanie linku wybierz typ linku, wprowadź adres URL zdalnego elementu roboczego, a następnie wybierz przycisk OK.

   W poniższym przykładzie użyjemy typu linku Remote Related do linku do elementu roboczego o identyfikatorze 350 , który istnieje w organizacji remotelinkingtest2 , projekcie RemoteLinking .

Karta linku przechowuje liczbę wszystkich linków do elementu roboczego. Pole Liczba linków zdalnych przechowuje liczbę łączy dodanych do elementu roboczego, który łączy się z elementem roboczym zdefiniowanym w innym projekcie lub organizacji.

W poniższym przykładzie pokazano dwa linki zdalne wskazywane przez ikonę chmury dodane do scenariusza użytkownika.

Łączenie elementów roboczych z żądaniami ściągnięcia

1. W opisie żądania ściągnięcia wprowadź , # aby wyzwolić selektor elementów roboczych #ID . Zostanie wyświetlona lista zawierająca 50 ostatnio zmodyfikowanych elementów roboczych lub przypisanych do Ciebie.

   

2. Wprowadź maksymalnie pięć słów kluczowych pasujących do typu elementu roboczego, identyfikatora lub tytułu, aby zawęzić listę sugerowanych elementów roboczych.

   

Aby uzyskać więcej informacji, zobacz Łączenie z elementami roboczymi z żądań ściągnięcia, zatwierdzeń i komentarzy.

Łączenie elementów roboczych z obiektami usługi GitHub

Po połączeniu usługi Azure Boards z repozytoriami GitHub możesz połączyć elementy robocze z zatwierdzeniem usługi GitHub, żądaniem ściągnięcia usługi GitHub, usługą GitHub Branch i problemem z usługą GitHub. W ten sposób możesz używać usługi GitHub do tworzenia oprogramowania, gdy używasz usługi Azure Boards do planowania i śledzenia pracy.

Ważne

Elementy robocze można łączyć tylko z obiektami usługi GitHub, które mają repozytoria połączone z usługą Azure Boards. Aby uzyskać więcej informacji, zobacz Łączenie usługi Azure Boards z usługą GitHub i Łączenie z elementami roboczymi z żądań ściągnięcia, zatwierdzeń i komentarzy.

Aby uzyskać więcej informacji, zobacz Łączenie zatwierdzeń usługi GitHub, żądań ściągnięcia, gałęzi i problemów z elementami roboczymi oraz Automatyczne uzupełnianie elementów roboczych przy użyciu żądań ściągnięcia.

Łączenie kilku elementów roboczych z nowymi gałęziami usługi Git

Na stronie listy prac lub wyników zapytania wybierz wiele elementów roboczych, które chcesz połączyć z nową gałęzią git, wybierz ikonę akcji, a następnie pozycję Nowa gałąź.... Aby uzyskać więcej informacji, zobacz Łączenie elementów roboczych z obiektami programistycznymi Git.

Łączenie elementów roboczych z kompilacjami

Wykonaj następujące kroki, aby połączyć elementy robocze z istniejącymi kompilacjami. Te kompilacje mogą znajdować się w projekcie lub w innych projektach w organizacji lub kolekcji.

1. Na karcie Linki elementu roboczego wybierz pozycję Dodaj link>Istniejący element.

2. W oknie dialogowym Dodawanie linku wybierz jeden z typów linków kompilacji — Kompilacja, Znaleziona w kompilacji, Zintegrowana w kompilacji — i określ numer kompilacji.

   Jeśli nie znasz numeru kompilacji — kombinacji potoku i nazwy kompilacji — możesz go wyszukać, wybierając ikonę .

   

3. W oknie dialogowym Łączenie kompilacji wybierz parametry do filtrowania wyszukiwania kompilacji.

   Aby połączyć się z kompilacją w innym projekcie, najpierw wybierz projekt , z którym chcesz utworzyć łącze.

   Można na przykład określić numer kompilacji, wybrać potok kompilacji, wynik kompilacji — na przykład Wszystkie, powodzenie, częściowo zakończone powodzeniem, niepowodzeniem lub anulowane. Możesz też wybrać pozycję Wszystkie wybrane dla pozycji Wynik, aby wyświetlić listę dostępnych kompilacji, z których chcesz utworzyć link.

   

4. Wybierz kompilację z listy, do której chcesz utworzyć łącze, a następnie wybierz przycisk OK.

5. W oknie dialogowym Dodawanie linku wybierz przycisk OK, aby ukończyć operację.

   

Łączenie elementów roboczych z wdrożeniami

Podczas opracowywania oprogramowania można przechwycić, które zmiany kodu i kompilacje obsługują ukończenie elementu roboczego. Dzięki temu twój zespół może zrozumieć, co działało, lub jak usterka została naprawiona za pośrednictwem dziennika inspekcji zmian w bazie kodu.

Typy linków używane do konstruowania tych łączy — jak pokazano na poniższej ilustracji — to: Gałąź, Kompilacja, Zestaw zmian, Zatwierdzenie, Znalezione w kompilacji, Zintegrowane w kompilacji, Żądanie ściągnięcia, Element wersji i Zintegrowane w środowisku wydania.

Napiwek

Zalecamy, aby programować z poziomu elementu roboczego podczas jego tworzenia. Identyfikator elementu roboczego można również dodać podczas tworzenia gałęzi, zatwierdzeń i żądań ściągnięcia. Usługa Git umożliwia łączenie elementów roboczych z zatwierdzeniami przy użyciu typu linku Zatwierdź . Można to zrobić w następujący sposób.

• Przed zatwierdzeniem zmian dodaj identyfikatory elementów roboczych w programie Visual Studio Team Explorer.
  
• Użyj polecenia git-commit i dołącz identyfikator elementu roboczego w komentarzu. Na przykład zastosuj ten komentarz #35 Catch null exception do zatwierdzenia. Po wypchnięciu zatwierdzenia system tworzy link Commit między zatwierdzeniem a elementem roboczym #35.
• Użyj kontrolki Programowanie , aby sterować programowaniem usługi Git z poziomu elementu roboczego.

Jak pokazano na poniższej ilustracji, kontrolka Wdrażanie wyświetla informacje o wersji dla dwóch etapów wydania. Zawiera on elementy robocze połączone z zatwierdzeniem usługi Git lub żądaniem ściągnięcia dla potoku wydania skonfigurowanego do integracji z usługą Azure Boards.

Kontrola wdrożenia

Formularze elementów roboczych udostępniają dwie kontrolki do wyświetlania i szybkiego przechodzenia do obiektów programistycznych. Kontrolka Wdrażanie została opisana w tym artykule, a kontrolka Programowanie jest opisana w temacie Tworzenie aplikacji Git na podstawie elementu roboczego.

Domyślnie kontrolka Wdrażanie jest wyświetlana w formularzach elementów roboczych dla typów elementów roboczych User Story (Agile), Product Backlog Item (Scrum), Issue (Basic), Requirement (CMMI), Feature, Epic, Bug, Task i Test Case work item (Problem).

Niestandardowe typy elementów roboczych używające procesu dziedziczonego są automatycznie włączone. Kontrolka Wdrażanie wyświetla informacje o wersji dla dwóch etapów potoku wydania zintegrowanego z usługą Azure Boards.

Ta kontrolka pokazuje tylko elementy robocze połączone z zatwierdzeniem lub żądaniem ściągnięcia usługi Git dla tego potoku. Możesz również uzyskać wizualny wgląd w stan elementu roboczego w miarę wdrażania go w różnych środowiskach wydania i szybkiego przechodzenia do każdego etapu wydania i uruchamiania.

Elementy robocze skojarzone z zatwierdzeniami w kompilacji pokazują stan wydania. Jednak tylko elementy robocze w tym samym projekcie są połączone z miejscem, w którym zdefiniowano potok wydania.

Etapy są widoczne w czasie rzeczywistym po otwarciu elementu roboczego.

Aby wypełnić kontrolkę Wdrażanie , wykonaj następujące czynności:

Uwaga

Kontrolka Wdrażanie wymaga konfiguracji klasycznego potoku wydania. Nie obsługuje łączenia z etapami wydania zdefiniowanymi dla potoku YAML.

1. Zdefiniuj klasyczny potok wydania i skonfiguruj etapy wydania zgodnie z opisem w artykule Definiowanie potoku ciągłego wdrażania wieloetapowego (CD).
2. Skonfiguruj potok zgodnie z opisem w temacie Konfigurowanie potoków w celu obsługi śledzenia pracy, Stan wdrożenia raportu na tablice.
3. Połącz elementy robocze z zatwierdzeniem lub żądaniem ściągnięcia w repozytorium Git usługi Azure Repos. Aby uzyskać więcej informacji, zobacz:
   • Wspieranie programowania w usłudze Git na podstawie elementu roboczego
   • Łączenie z elementami roboczymi z innych obiektów
4. Uruchom potok.

Łączenie elementów roboczych z programowaniem kodu TFVC

Kontrola wersji programu Team Foundation (TFVC) umożliwia łączenie elementów roboczych z zestawami zmian kontroli wersji lub plikami kodu źródłowego wersji przy użyciu typów linków Zestaw zmian i Wersja elementu. Gdy zaewidencjonujesz oczekujące zmiany lub zaewidencjonujesz zmiany za pomocą funkcji Moja praca, elementy robocze zostaną automatycznie połączone ze zmianami.

Łączenie elementów roboczych z testami

Typy linków związanych z testami łączą elementy robocze zarządzania przypadkami testowymi ze sobą lub z innymi elementami roboczymi. W portalu internetowym lub programie Microsoft Test Manager można wyświetlić przypadki testowe zdefiniowane dla zestawu testów oraz zestawy testów zdefiniowane dla planu testu. Te obiekty nie są jednak połączone ze sobą za pośrednictwem typów łączy.

Elementy robocze można połączyć z przypadkami testowym przy użyciu typów linków Testowane/Testowane według . Użyj tych samych kontrolek linków, których używasz do łączenia elementów roboczych z innymi elementami roboczymi, jak opisano wcześniej.

Na poniższej ilustracji przedstawiono pełny zestaw typów linków, których można używać z typami elementów roboczych zarządzania testami. Większość łączy między obiektami zarządzania testami występuje, wykonując zadanie ze stron testowych lub programu Microsoft Test Manager.

Na przykład po dodaniu udostępnionych kroków do przypadku testowego zostaną one automatycznie połączone przy użyciu typów linków Przypadek testowy/Kroki udostępnione. Aby uzyskać więcej informacji, zobacz Udostępnianie kroków między przypadkami testowym.

W obszarze Test możesz dodawać plany testów, zestawy testów i przypadki testowe — które są połączone, ale nie za pomocą określonego typu łącza. Ponadto system testowy tworzy skojarzenia wyników testów i zarządza nimi w przypadku przypadków testowych i planów testów.

Łączenie elementów roboczych z witryną sieci Web, udziałem sieciowym, scenorysem lub dokumentem

Możesz użyć typu linku hiperłącza lub scenorysu, aby połączyć element roboczy z witryną sieci Web, udziałem sieciowym lub dokumentem znajdującym się w udziale sieciowym. Oba te typy łączy są jednokierunkowe. Aby dodać te typy linków, użyj tych samych kontrolek opisanych wcześniej do łączenia elementów roboczych.

W przypadku korzystania z typu linku scenorysu należy odróżnić link w celu określenia scenorysu lub dokumentu zawierającego specyfikacje elementów roboczych. Użyj tego typu linku, aby zapewnić zespołowi dostęp do udostępnionego pliku, w którym mogą dodawać komentarze.

Wyświetlanie zależności i śledzenie powiązanej pracy

Usługa Azure DevOps udostępnia kilka sposobów wyświetlania zależności i śledzenia powiązanych zadań: • Edytor Power Query: za pomocą Edytor Power Query można tworzyć zapytania niestandardowe, które pokazują wszystkie elementy robocze połączone z określonym elementem roboczym. • Listy prac i tablice: Widoki listy prac i tablic pokazują relacje nadrzędny-podrzędny między elementami roboczymi, co pozwala na błyskawiczne wyświetlanie zależności. • Śledzenie zależności: Tracker zależności to raport usługi Power BI, który zapewnia wizualną reprezentację zależności między elementami roboczymi.

Aby wyświetlić listę wszystkich obiektów połączonych z elementem roboczym, wykonaj następujące kroki.

1. Otwórz element roboczy i wybierz pozycję Łącza. Karta linki wskazuje liczbę wszystkich połączonych obiektów. Połączone obiekty są grupowane pod ich typem linku z liczbą w każdej grupie.

2. (Opcjonalnie) Rozwiń lub zwiń każdą grupę i sortuj w każdej grupie według stanu, najnowszej aktualizacji lub komentarza , wybierając odpowiedni tytuł kolumny.

Na przykład poniższa karta Linki zawiera część 64 połączonych obiektów dla elementu roboczego.

Linki poprzedzone wykrzyknikiem wskazują, że usunięto kompilację, wydanie lub inny obiekt. Ze względu na zasady przechowywania te obiekty są automatycznie usuwane po upływie określonego czasu.

Zapytanie dotyczące połączonych elementów roboczych

Aby filtrować elementy na podstawie linków hierarchicznych, użyj typu zapytania Drzewo elementów roboczych . Aby filtrować elementy na podstawie wszystkich typów linków, użyj elementów roboczych i linków bezpośrednich.

Aby znaleźć elementy robocze połączone z innymi elementami roboczymi z określonymi typami linków, użyj zapytania zawierającego podstawowy i pomocniczy zestaw elementów roboczych. Zestaw podstawowy spełnia kryteria pola, a zestaw pomocniczy jest połączony z zestawem podstawowym. Nie można wykonywać zapytań dotyczących elementów roboczych w wersjach, ale możesz wykonywać zapytania dotyczące elementów roboczych za pomocą linków zewnętrznych. Aby ponownie finiować wyszukiwanie, dodaj więcej filtrów zapytań.

Przykłady zapytań można znaleźć w temacie Łączenie i zapytania dotyczące załączników.

Nie można utworzyć zapytania, które pokazuje hierarchiczny widok planów testów, zestawów testów i przypadków testowych. Te elementy nie są połączone razem przy użyciu elementu nadrzędnego/podrzędnego ani żadnego innego typu łącza. Hierarchię można wyświetlić tylko na stronie Test Test Test Plans (Plany testów).>

Dodawanie, usuwanie lub pokazywanie linków za pomocą interfejsu wiersza polecenia platformy Azure

Możesz dodawać, usuwać i wyświetlać szczegóły linków do elementu roboczego za pomocą polecenia az boards work-item relation . Aby uzyskać więcej informacji, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Azure DevOps.

Typy linków obejmują typy linków roboczych, typy linków zdalnych, hiperlinki i dołączone pliki. Aby uzyskać listę wszystkich typów linków, które można określić, uruchom polecenie az boards work-item relation list-type .

az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show

W poniższych przykładach organizacja to fabrikam , a identyfikator projektu odpowiada cebd7ef5-4282-448b-9701-88c8637581b7. Format tabeli służy do wyświetlania danych wyjściowych. Aby zapoznać się z innymi formatami, zobacz Formaty danych wyjściowych dla poleceń interfejsu wiersza polecenia platformy Azure.

Łączenie elementów roboczych

Aby połączyć jeden lub więcej elementów roboczych z jednym elementem roboczym, wprowadź polecenie az boards work-item relation add .

Składnia

Wymagane parametry obejmują identyfikator elementu roboczego, z który ma być łączem i typem łącza. Obsługiwane typy linków obejmują element nadrzędny, podrzędny, powiązane, powiązane, powiązane zdalnego. Aby uzyskać listę wszystkich typów linków, które można określić, uruchom polecenie az boards work-item relation list-type .

W przypadku elementów roboczych zdefiniowanych w tej samej organizacji należy określić identyfikator elementu roboczego lub docelowy adres URL. W przypadku elementów roboczych zdefiniowanych w organizacji zdalnej należy określić docelowy adres URL. Można określić wiele wartości, oddzielając identyfikatory lub adresy URL przecinkami.

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org]
                                 [--target-id]
                                 [--target-url]

Przykład

Następujące polecenie łączy identyfikator elementu roboczego =2807 z identyfikatorem elementu roboczego=2794 z typem linku Podrzędne. Polecenie zwraca listę wszystkich linków aktualnie zdefiniowanych dla elementu roboczego.

az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2807

Aby wyświetlić informacje dotyczące połączonych elementów roboczych, wprowadź jeden z adresów URL wymienionych w przeglądarce.

Usuwanie łączy elementów roboczych

Aby usunąć jeden lub więcej połączonych elementów roboczych z jednego elementu roboczego, wprowadź polecenie az boards work-item relation remove .

Wymagane parametry obejmują identyfikator elementu roboczego w celu usunięcia linku z i typu łącza. Można usuwać tylko linki do elementów roboczych zdefiniowanych w tej samej organizacji. Można określić dowolne z obsługiwanych typów linków z wyjątkiem typów linków zdalnych.

Należy określić identyfikator docelowego elementu roboczego. Można określić wiele wartości, oddzielając identyfikatory lub adresy URL przecinkami.

Składnia

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org]
                                    [--yes]

Przykład

Następujące polecenie usuwa link do elementu roboczego ID=2794 z identyfikatora elementu roboczego=2856 do elementu roboczego z typem linku Podrzędne. Polecenie zwraca listę wszystkich linków aktualnie zdefiniowanych dla elementu roboczego.

az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2805 

Aby wyświetlić informacje dotyczące połączonych elementów roboczych, wprowadź jeden z adresów URL wymienionych w przeglądarce.

Pokaż szczegóły łączy wykonanych dla pojedynczego elementu roboczego

Aby wyświetlić elementy robocze połączone z pojedynczym elementem roboczym, wprowadź polecenie az boards work-item relation show . Aby uzyskać listę wszystkich typów linków, które można zwrócić, uruchom polecenie az boards work-item relation list-type .

Składnia

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org]

Przykład

Poniższe polecenie zawiera listę szczegółów linków zdefiniowanych dla identyfikatora elementu roboczego=2931 w organizacji fabrikam w formacie tabeli.

az boards work-item relation show --id 2931 --output table
Relation Type    Url
---------------  -----------------------------------------------------------------------------------------------------------------------------------
Related          https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/847568d2-6541-4a99-a240-228510ccbff7/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

Aby wyświetlić informacje dotyczące połączonych elementów roboczych, wprowadź jeden z adresów URL wymienionych w przeglądarce. Wybierz adres URL dołączonego pliku, aby pobrać załącznik.

Usuwanie łączy elementów roboczych

Wykonaj następujące kroki, aby usunąć link elementu roboczego.

1. Otwórz element roboczy zawierający linki lub wybierz go z wyniku zapytania.
2. Wybierz kartę Linki , aby wyświetlić listę łączy.
3. Wybierz link, który chcesz usunąć, a następnie wybierz pozycję Usuń łącze.
4. Upewnij się, że chcesz usunąć link.

Gdy element roboczy zostanie połączony z zatwierdzeniem lub żądaniem ściągnięcia, będzie on nadal wyświetlany jako część etapów wydania. Jeśli na przykład masz element roboczy, który nie przeszedł kryteriów testowania, możesz go usunąć z kompilacji i wydań.

Aby usunąć element roboczy z udziału w przyszłych kompilacjach i wydaniach, usuń link do najnowszego zatwierdzenia i żądania ściągnięcia.

Następne kroki

Wizualizowanie powiązanej pracy i innych obiektów. Pobierz rozszerzenie wizualizacji elementu roboczego dostępne na karcie Visual Studio Marketplace i Azure DevOps.

Powiązane artykuły

• Dokumentacja typów łączy
• Omówienie między usługami
• Wspieranie programowania w usłudze Git na podstawie elementu roboczego
• Śledzenie zależności przy użyciu planów dostarczania
• Używanie mapowania do łączenia elementów listy prac z funkcjami i epikami
• Zbiorcze modyfikowanie łączy przy użyciu programu Excel