Łą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 a innym obiektem. Linki opisują relację między obiektami. 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	opis
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 nadrzędny/podrzędny, powiązanych i poprzedników, zobacz Work link types (Typy łączy 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.

   • 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 łączenia lub zmieniania łączy używających typu linku nadrzędnego/podrzędnego. Niektóre funkcje są zależne od wersji. Aby uzyskać szczegółowe informacje, zobacz połączone artykuły.

• 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ę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 linku, który chcesz utworzyć, na przykład Nadrzędny, Podrzędny lub Powiązany.

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żyto 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 wybór wielokrotny z listy prac produktu i wybierz pozycję Istniejący element....

   

3. Z listy rozwijanej Typ łącza wybierz typ linku, który chcesz utworzyć, na przykład Nadrzędny, Podrzędny lub Powiązany.

4. W polu Element roboczy wprowadź identyfikator elementu roboczego, z którym chcesz połączyć, a następnie wybierz przycisk OK.

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 lub 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:

   • Używa elementów z lub 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żyto typu linku Powiązane zdalnie, aby połączyć element roboczy 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 . Na liście jest wyświetlanych 50 ostatnio zmodyfikowanych elementów roboczych lub przypisanych do Ciebie.

   

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

   

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. Usługi GitHub można używać 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. Określ numer kompilacji.

   Numer kompilacji jest kombinacją potoku i nazwy kompilacji. Jeśli nie znasz numeru kompilacji, wyszukaj go, 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 lub wynik kompilacji, taki jak Wszystkie, powodzenie, częściowo zakończone powodzeniem, niepowodzenie 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. Twój zespół może zrozumieć, co zostało wykonane, lub jak usterka została naprawiona za pośrednictwem dziennika inspekcji zmian w bazie kodu.

Typy linków używane do konstruowania tych łączy to: Gałąź, Kompilacja, Zestaw zmian, Zatwierdzenie, Znalezione w kompilacji, Zintegrowane w kompilacji, Żądanie ściągnięcia, Wersja elementu i Zintegrowane w środowisku wydania. Te typy są wyświetlane na poniższej ilustracji.

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 usłudze Git Changes dla programu Visual Studio 2022 lub Team Explorer dla poprzednich wersji programu Visual Studio:

  

• 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 na potrzeby programowania w narzędziu Git z poziomu elementu roboczego. Aby uzyskać więcej informacji, zobacz Tworzenie aplikacji Git na podstawie elementu roboczego w usłudze Azure Boards.

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 przechodzenia do obiektów programistycznych. W tym artykule opisano kontrolkę Wdrażanie. Aby uzyskać informacje na temat kontrolki Programowanie, zobacz Temat Wspieranie programowania w usłudze 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 po wdrożeniu w różnych środowiskach wydania. Możesz przejść do każdego etapu wydania i uruchomić.

Elementy robocze skojarzone z zatwierdzeniami w kompilacji pokazują stan wydania. Tylko elementy robocze w ramach tego samego projektu są połączone z lokalizacją, w której zdefiniowano potok wydania.

Po otwarciu elementu roboczego można zobaczyć etapy w czasie rzeczywistym.

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. Aby uzyskać więcej informacji, zobacz Definiowanie potoku ciągłego wdrażania wieloetapowego (CD).

2. Skonfiguruj potok. Aby uzyskać więcej informacji, zobacz Konfigurowanie potoków do obsługi śledzenia pracy, Raportowanie stanu wdrożenia do tablic.

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. Aby uzyskać więcej informacji, zobacz Zaewidencjonuj swoją pracę.

Łą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ą ze sobą połączone 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. Zobacz Łączenie elementów roboczych.

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, uruchamiają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. Nie można dodać ich za pomocą określonego typu łącza. 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. Zobacz Łączenie elementów roboczych.

W przypadku używania 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 oferuje kilka sposobów wyświetlania zależności i śledzenia powiązanych prac:

• 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 Tablice 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 udostępnia 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. Możesz wykonywać zapytania dotyczące elementów roboczych za pomocą linków zewnętrznych. Aby uściślić wyszukiwanie, dodaj więcej filtrów zapytań.

Aby zapoznać się z przykładami zapytań, zobacz Tworzenie zapytań dotyczących elementów roboczych według linku lub liczby 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).> Aby uzyskać więcej informacji, zobacz Tworzenie planów testów i zestawów 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 jest fabrikam, a identyfikator projektu odpowiada aaaa-0000-1111-2222-bbbbbbbbbb. 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 .

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 i powiązane zdalnego. Aby uzyskać listę wszystkich typów linków, 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 określ 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]

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/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_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.

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

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/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_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 .

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

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/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_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.

Po połączeniu elementu roboczego 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.

Powiązane artykuły

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

• Zapoznaj się z przewodnikiem referencyjnym dotyczącym typów linków
• Omówienie usług Azure Boards i Azure Repos
• Wspieranie programowania w usłudze Git na podstawie elementu roboczego
• Śledzenie zależności przy użyciu planów dostarczania
• Organizowanie listy prac i mapowania podrzędnych elementów roboczych
• Zbiorcze dodawanie lub modyfikowanie elementów roboczych za pomocą programu Microsoft Excel