Udostępnij za pośrednictwem

Przewodnik referencyjny dla typów linków

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

Za pomocą różnych typów linków można zarządzać różnymi relacjami między elementami roboczymi i innymi artefaktami, takimi jak kompilacje, zatwierdzenia, żądania ściągnięcia i inne. W tym artykule opisano następujące typy linków.

  • #B0 #A1 typ linku pracy #A2 #A3: łączy elementy robocze, w tym wybrane elementy zarządzania przypadkami testowymi
  • #B0 #A1 Hiperłącze #A2 #A3: łączy element roboczy z dowolnym adresem URL lub udziałem sieciowym
  • #B0 #A1 typ łącza zewnętrznego #A2 #A3: łączy element roboczy z obiektem zewnętrznym, takim jak obiekt kodu, kompilacja lub strona typu wiki
  • #B0 #A1 typ łącza pracy zdalnej #A2 #A3: łączy elementy robocze zdefiniowane w różnych organizacjach
  • #B0 #A1 typ linku GitHub #A2 #A3: łączy element roboczy z zatwierdzeniem, problemem lub żądaniem ściągnięcia w repozytorium GitHub.

Określone pole utrzymuje liczbę łączy dla pierwszych czterech typów linków, takich jak liczba linków powiązanych, liczba hiperlinków, liczba linków zewnętrznych i liczba linków zdalnych.

  • #B0 #A1 Typ łącza pracy #A2 #A3: linki do elementów roboczych, w tym wybranych elementów zarządzania przypadkami testowymi
  • #B0 #A1 Hiperłącze#A2 #A3: łączy element roboczy z dowolnym adresem URL lub zasobem sieciowym
  • #B0 #A1 typ łącza zewnętrznego #A2 #A3: łączy element roboczy z obiektem zewnętrznym, takim jak obiekt kodu, kompilacja lub strona typu wiki
  • Typ linku GitHub: łączy element roboczy z zatwierdzeniem lub żądaniem pull w repozytorium GitHub.

Określone pole przechowuje liczbę łączy dla trzech pierwszych typów linków, takich jak liczba linków powiązanych, liczba hiperlinków i liczba linków zewnętrznych.

Typy łączy podlegają pewnym ograniczeniom na podstawie ich topologii. Skorzystaj ze wskazówek podanych w poniższych tabelach, aby wybrać typ łącza do użycia na podstawie typów zapytań i raportów, które chcesz utworzyć. Aby dowiedzieć się więcej na temat różnych topologii, zapoznaj się z Topologie i ograniczenia typów połączeń.

Typy łączy roboczych to zdefiniowane przez system, zdefiniowane przez proces lub zdefiniowane przez użytkownika (niestandardowe). Linki wymienione w poniższej tabeli są zdefiniowane przez system.

Każdy typ łącza roboczego definiuje etykiety linków, typ topologii i ograniczenia, które są używane podczas tworzenia łączy między elementami roboczymi. Na przykład typ linku rodzic-dziecko definiuje dwie etykiety: Rodzic i Dziecko. Typ łącza obsługuje również hierarchiczną lub topologię drzewa oraz zapobiega tworzeniu odwołań cyklicznych między elementami roboczymi.

#B0 #A1 Koncepcyjny obraz typu łącza elementów pracy. #A2 #C3

Liczba powiązanych łączy elementu roboczego odpowiada sumie wszystkich łączy zdefiniowanych o typie powiązania roboczego.

W poniższej tabeli opisano typy linków elementów roboczych, które można określić, aby zdefiniować zakres kontrolki łączy za pomocą elementu XML WorkItemLinksFilter.

nazwa

nazwa odwołania

Użycie

Affects-Affected według (tylko CMMI) Obraz koncepcyjny typu łącza wpływa.Obraz koncepcyjny typu łącza, na który wpływa.

Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Typ topologii: Zależność
Kategoria łącza: zdefiniowana przez proces

Użyj tego linku kierunkowego, aby utworzyć łącza między dowolnym zestawem elementów roboczych, ale nie tymi, które tworzyłyby zamknięte pętle. Zazwyczaj służy do śledzenia żądań zmian wprowadzonych w wymaganiach.

Ograniczenia i zalecenia:

  • Żądanie zmiany można połączyć tylko z jednym wymaganiem, używając polecenia Wpływ. Wymagania można połączyć z dowolną liczbą podrzędnych żądań zmiany, używając funkcji Affected by.
  • Używaj Affects-Affected tylko w linkach do łączenia elementów roboczych w tym samym projekcie. Zalecamy wykonanie tej akcji, jeśli planujesz użyć programu Excel do modyfikowania lub aktualizowania danych elementów roboczych.

Rodzic-Dziecko
#B0 #A1 Obraz koncepcyjny typu linku podrzędnego. #A2 #C3
Obraz koncepcyjny typu łącza nadrzędnego.

System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Typ topologii: Drzewo
Kategoria łącza: zdefiniowana przez system

Użyj tego linku kierunkowego, aby utworzyć relacje jeden do wielu między jednym elementem nadrzędnym a jednym lub więcej elementami podrzędnymi. Służy do organizowania elementu roboczego w hierarchii. Tę hierarchię można szybko utworzyć wśród elementów listy prac przy użyciu funkcji mapowania lub wśród elementów listy prac i zadań przy użyciu listy prac sprintu lub Taskboardu.

Typowe zastosowania obejmują:

  • Zachowaj relacje sumaryczne zadań. Łącza nadrzędno-podrzędne są tworzone dla zadań sumarycznych i podrzędnych.
  • Łączenie zadań z usługami PBI, scenariuszami użytkowników lub wymaganiami. Obsługuje raporty Przegląd listy prac, Przegląd historyjek i Przegląd wymagań.

Ograniczenia i zalecenia:

  • Użyj programu Excel, aby zbiorczo edytować zarówno elementy robocze, jak i łącza nadrzędno-podrzędne. Zobacz Zbiorcze dodawanie lub modyfikowanie zadań za pomocą programu Excel.
  • Element roboczy może mieć tylko jeden element nadrzędny. Nadrzędny element roboczy może mieć wiele elementów podrzędnych.
  • Używaj tylko linków nadrzędny-podrzędny, aby połączyć elementy robocze w tym samym projekcie. Ta akcja jest zalecana, jeśli planujesz użyć programu Excel do modyfikowania lub aktualizowania danych elementów roboczych.

Duplicate-Duplicateobraz koncepcyjny duplikatu drzewa do przodu.Obraz koncepcyjny duplikatu drzewa odwrotnego.

System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Typ topologii: Drzewo
Kategoria łącza: zdefiniowana przez system

Użyj tego linku, aby utworzyć relacje jeden do wielu między pojedynczym elementem nadrzędnym a jednym lub więcej elementami podrzędnymi. Służy do śledzenia zadań, usterek lub innych elementów roboczych, które są duplikatami siebie nawzajem.

Ograniczenia i zalecenia:

  • Element roboczy może mieć tylko jeden duplikat.
  • Użyj tylko funkcji Duplikuj lub Duplikuj łącza, aby połączyć elementy robocze w tym samym projekcie. Ta akcja jest zalecana, jeśli planujesz użyć programu Excel do modyfikowania lub aktualizowania danych elementów roboczych.

Referencje do-Referencji
#B0 #A1 obraz koncepcyjny testowany według typu łącza. #A2 #A3 #A4 #A5 Obraz koncepcyjny typu linku Testy. #A6 #C7

Microsoft.VSTS.TestCase.
WspółdzielonyParametrOdniesionyPrzez
Typ topologii: Zależność
Kategoria łącza: zdefiniowana przez proces

Użyj polecenia, aby połączyć przypadki testowe z parametrami udostępnionymi. Użyj, aby połączyć przypadki testowe z parametrami udostępnionymi w celu umożliwienia powtórzenia testu z różnymi danymi. Ogólnie rzecz biorąc, nie można dodać tego typu łącza do kontrolki łączy o określonym zakresie.

Powiązane
#B0 #A1 Obraz koncepcyjny typu "Link powiązany". #A2 #C3

System.LinkTypes.Related
Typ topologii: Sieć
Kategoria łącza: zdefiniowana przez system

Użyj tego niekierunkowego linku, aby utworzyć łącza między dowolnym zestawem elementów roboczych. Służy do łączenia elementów roboczych, które znajdują się na tym samym poziomie, takich jak dwa scenariusze użytkownika, które definiują funkcje nakładające się na siebie nawzajem. Typ linku związanego tworzy proste relacje przy niewielu ograniczeniach.

  • Powiąż elementy robocze, które znajdują się na tym samym poziomie, takie jak dwa scenariusze użytkownika, które definiują funkcje nakładające się na siebie nawzajem.
  • Połącz elementy robocze zdefiniowane w różnych projektach i zarządzane przez różne zespoły.
  • Znajdź i wyświetl elementy robocze oraz powiązane elementy robocze w widoku dwuwarstwowym.
  • Utwórz proste relacje z kilkoma ograniczeniami.

następca-poprzednik
Koncepcyjny obraz zależności następcy, do przodu. Koncepcyjny obraz zależności poprzednika, do tyłu.

System.LinkTypes.Dependency

Typ topologii: Zależność
Kategoria łącza: zdefiniowana przez system
Wybierz typ łącza Poprzednik, gdy łączysz z elementem roboczym, który powinien zostać ukończony przed elementem roboczym, z którego tworzysz łącze. Wybierz typ łącza następnik podczas łączenia z elementem roboczym, który powinien zostać ukończony po do elementu roboczego, z którego tworzysz łącze.

Użyj tego linku kierunkowego, aby utworzyć łącza między dowolnym zestawem elementów roboczych, ale nie tymi, które tworzyłyby zamknięte pętle. Służy do śledzenia zadań, które należy wykonać przed rozpoczęciem pracy innych osób. Połączone zadania są przedstawiane jako łącza poprzednik-następnik w usłudze Azure Boards.

  • Śledź zadania, które należy wykonać, zanim będzie można rozpocząć inne.
  • Obsługuje relacje jeden do wielu.
  • Znajdź i wyświetl elementy robocze poprzedników oraz ich elementy robocze następników w dwupoziomowym widoku zapytań z bezpośrednimi linkami.

Ograniczenia i zalecenia:

  • Podczas próby utworzenia linków definiujących relacje cykliczne pojawia się błąd.
  • Utwórz łącza poprzednika i następcy tylko do elementów roboczych znajdujących się w ramach tego samego projektu. Można utworzyć łącza poprzednika następcy między elementami roboczymi zdefiniowanymi w różnych projektach. Jednak w przypadku eksportowania zapytania do programu Excel zaimportowane są tylko te elementy robocze zdefiniowane dla projektu, dla którego zdefiniowano zapytanie.

#B0 przetestowane przez testy #C1
#B0 #A1 obraz koncepcyjny testowany według typu łącza. #A2 #A3 #A4 #A5 Obraz koncepcyjny typu linku Testy. #A6 #C7

Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Typ topologii: Zależność
Kategoria łącza: zdefiniowana przez proces

Połącz przypadki testowe z elementami roboczymi, takimi jak usterki, historyjki użytkowników, wymagania i elementy backlogu produktu. Służy do śledzenia przypadków testowych, które testują scenariusze użytkownika (Agile), elementy listy prac produktu (Scrum) lub wymagania (CMMI). Może również łączyć się z innymi typami elementów roboczych, takimi jak błędy, problemy lub zadania. W przypadku lokalnej usługi Azure DevOps istnieje kilka raportów SQL, które zależą od tych linków. Zobacz Działania zespołu recenzentów wspierające przydatne raporty.

Kroki testu Case-Shared
#B0 #A1 obraz koncepcyjny testowany według typu łącza. #A2 #A3 #A4 #A5 Obraz koncepcyjny typu linku Testy. #A6 #C7

Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Typ topologii: Zależność
Kategoria łącza: zdefiniowana przez proces

Użyj, aby połączyć przypadki testowe z udostępnionymi krokami. Udostępnij kroki między przypadkami testowymi, aby uniknąć konieczności wielokrotnego tworzenia tej samej sekwencji kroków.

Hiperlink może połączyć element roboczy z dowolnym adresem URL. Licznik Liczba Hiperlinków śledzi liczbę linków do elementu roboczego.

#B0 #A1 Obraz koncepcyjny hiperłącza. #A2 #C3

nazwa łącza

#B0 Narzędzie jest obsługiwane #C1

Typ artefaktu

Użycie

Hiperłącze

Śledzenie elementów roboczych

Hiperłącze

Służy do łączenia elementu roboczego z adresem URL. Hiperłącze elementu roboczego to nazwa tego typu łącza w interfejsie API Artifact Link Types.

Typy linków zewnętrznych to zdefiniowane przez system typy łączy, które obsługują łączenie elementów roboczych z innymi obiektami przechowywanymi w usłudze Azure DevOps, jak pokazano na poniższej ilustracji. Liczba łączy zewnętrznych dla elementu roboczego odpowiada sumie wszystkich łączy zdefiniowanych jako linki zewnętrzne.

#B0 #A1 Koncepcyjny obraz rodzaju linku zewnętrznego. #A2 #C3

Uwaga

Do połączenia z obiektem usługi Azure DevOps można użyć tylko typu linku zewnętrznego. Aby połączyć elementy robocze z innymi obiektami spoza usługi Azure DevOps, użyj hiperlinku.

W poniższej tabeli opisano typy linków zewnętrznych, które można wybrać podczas dodawania typu łącza z elementu roboczego lub przypadku testowego.

W poniższej tabeli opisano typy linków zewnętrznych, które można wybrać podczas dodawania typu łącza z elementu roboczego lub przypadku testowego. Ponadto można określić jeden z tych typów linków, aby ustalić zakres kontrolki łączy przy użyciu elementu XML ExternalLinksFilter.

nazwa łącza

#B0 Tool obsługiwane #C1

Typ artefaktu

Użycie

Gałąź

Git

Gałąź

Służy do łączenia elementu roboczego z gałęzią.

Potoki/Budowa

Zbuduj

Zbuduj

Służy do łączenia elementu roboczego z kompilacją.

Zestaw zmian (lub poprawiony w zestawie zmian)

Kontrola wersji

Zestaw zmian

Używane do łączenia elementu pracy z zestawem zmian.

Zatwierdzenie (lub poprawka w zatwierdzeniu)

Git

Zobowiązać się

Służy do powiązania elementu roboczego z zatwierdzeniem.

Znaleziono w kompilacji

Potoki/Budowa

Zbuduj

Służy do łączenia elementu roboczego z kompilacją.

Zintegrowane w kompilacji

Zbuduj

Potok budowania

Służy do łączenia elementu roboczego z kompilacją.

Zintegrowane w środowisku wydań

Uwolnij

Proces wydania

Służy do łączenia wydania z elementem roboczym. System tworzy link tego typu, gdy użytkownik włączy opcję "Zgłoś stan wdrożenia do Pracy" w definicji wydania.

Prośba o połączenie

Git

PullRequestId

Służy do łączenia elementu roboczego z pull requestem.

Załącznik wyników

Zarządzanie testami

TcmResultAttachment

Służy do łączenia elementu roboczego z załącznikiem skojarzonym z wynikiem testu. Te łącza są wyświetlane po skojarzeniu elementu roboczego z wynikiem testu z Test lub Microsoft Test Manager.

Plik kodu źródłowego<

Kontrola wersji

NajnowszaWersjaElementu

Służy do łączenia elementu roboczego z plikiem w ramach kontroli wersji programu Team Foundation (TFVC).

Storyboard

Wymagania

Storyboard

Służy do łączenia elementu roboczego z plikiem programu PowerPoint lub innym plikiem zawierającym informacje o storyboardzie w lokalizacji sieciowej.

Etykieta

Git

Etykieta

Służy do łączenia elementu roboczego z tagiem zdefiniowanym dla zatwierdzenia Git lub repozytorium Git. Aby uzyskać więcej informacji, zobacz Praca w wierszu poleceń Git .

Wynik testu

Zarządzanie testami

TcmResult

Służy do łączenia elementu roboczego z wynikiem testu. Te łącza pojawiają się po skojarzeniu elementu roboczego z wynikiem testu z Test lub Microsoft Test Manager.

Element wersjonowany

Kontrola wersji

NajnowszaWersjaElementu

Służy do łączenia elementu roboczego z plikiem lub zestawem zmian zdefiniowanym w repozytorium TFVC. Plik kodu źródłowego jest nazwą tego typu łącza w interfejsie API typów połączeń artefaktów.

Wiki

Wiki

Wiki

Służy do łączenia elementu roboczego ze stroną typu wiki. Obsługiwane w przypadku wersji TFS 2018.2 i nowszych.

Typy linków usługi GitHub są zdefiniowane przez system i obsługują łączenie elementów roboczych z obiektami usługi GitHub, jak pokazano na poniższej ilustracji.

Obraz koncepcyjny rodzaju linku GitHub.

Ważne

Możesz linkować tylko do artefaktów usługi GitHub z repozytoriami połączonymi z usługą Azure Boards.

W poniższej tabeli opisano typy linków GitHub, które można wybrać podczas dodawania typu linku do elementu roboczego.

nazwa łącza

Typ artefaktu

Użycie

Zatwierdzenie w usłudze GitHub

Zatwierdzenie repozytorium GitHub

Służy do powiązania elementu roboczego z zatwierdzeniem w GitHubie.

Problem z usługą GitHub

Problem z repozytorium GitHub

Służy do łączenia elementu roboczego z zgłoszeniem w GitHub.

Żądanie ściągnięcia w usłudze GitHub

Żądanie ściągnięcia repozytorium GitHub

Służy do łączenia elementu pracy z pull request w GitHub.

Typy linków pracy zdalnej to zdefiniowane przez system typy połączeń, które obsługują łączenie elementów roboczych zdefiniowanych w różnych organizacjach, pod warunkiem że zarządza nimi ten sam Microsoft Entra ID zgodnie z opisem w „Połącz swoją organizację z Microsoft Entra ID”.

Liczba zdalnych łączy elementu zadania odpowiada sumie wszystkich łączy zdefiniowanych za pomocą typu zdalnego łącza roboczego.

nazwa

nazwa odwołania

Użycie

Zużywa From-Produced w celu
pl-PL: (Topologia zależności) #B0 #A1 Koncepcyjny obraz topologii "Konsumowane przez". #A2 #A3 #A4 #A5 Koncepcyjny obraz topologii "Produkowane dla". #A6 #C7

System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Typ topologii: Zależność
Kategoria łącza: zdefiniowana przez system

Użyj tego linku kierunkowego, aby utworzyć łącza między elementami roboczymi, które mają zależności i są zdefiniowane w różnych organizacjach, o ile zarządza nimi ten sam identyfikator Entra firmy Microsoft. Zazwyczaj służy do śledzenia żądań zmian wprowadzonych w wymaganiach.

Powiązane z zdalnością
Koncepcyjny obraz topologii zdalnego połączenia.

System.TypyŁączy.Zdalny.Powiązany
Typ topologii: Sieć
Kategoria łącza: zdefiniowana przez system

Użyj tego niestronniczego linku, aby utworzyć łącza między elementami roboczymi zdefiniowanymi w różnych organizacjach, o ile zarządza nimi ten sam Microsoft Entra ID.

Możesz utworzyć niestandardowy typ łącza; eksportowanie i importowanie definicji typów łączy; oraz usuwać, uaktywniać, dezaktywować i ponownie uaktywniać typy łączy. Odwiedź następujące artykuły:

Aby uzyskać listę typów linków, możesz użyć jednego z obsługiwanych narzędzi wiersza polecenia.

az boards typ listy relacji elementu roboczego

Typy linków obsługiwanych przez organizację można wyświetlić za pomocą polecenia az boards work-item relation list-type lub polecenia REST API Typy relacyjne elementów roboczych - Lista. Aby rozpocząć, zobacz Wprowadzenie do interfejsu wiersza polecenia usługi Azure DevOps.

az boards work-item relation list-type [--org]

Parametry opcjonalne

  • org: Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli nie skonfigurowano wartości domyślnej lub wartość została pobrana przy użyciu git config. Przykład: --org https://dev.azure.com/MyOrganizationName/.

Przykład

Poniższe polecenie wyświetla listę typów linków elementów roboczych w formacie tabeli, które są zdefiniowane dla organizacji Fabrikam.

az boards work-item relation list-type --org fabrikam --output table
Name                  ReferenceName                                                Enabled    Usage
--------------------  -----------------------------------------------------------  ---------  ------------
Produces For          System.LinkTypes.Remote.Dependency-Forward                   True       workItemLink
Consumes From         System.LinkTypes.Remote.Dependency-Reverse                   True       workItemLink
Duplicate             System.LinkTypes.Duplicate-Forward                           True       workItemLink
Duplicate Of          System.LinkTypes.Duplicate-Reverse                           True       workItemLink
Referenced By         Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward  True       workItemLink
References            Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse  True       workItemLink
Tested By             Microsoft.VSTS.Common.TestedBy-Forward                       True       workItemLink
Tests                 Microsoft.VSTS.Common.TestedBy-Reverse                       True       workItemLink
Test Case             Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward       True       workItemLink
Shared Steps          Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse       True       workItemLink
Successor             System.LinkTypes.Dependency-Forward                          True       workItemLink
Predecessor           System.LinkTypes.Dependency-Reverse                          True       workItemLink
Child                 System.LinkTypes.Hierarchy-Forward                           True       workItemLink
Parent                System.LinkTypes.Hierarchy-Reverse                           True       workItemLink
Related               System.LinkTypes.Related                                     True       workItemLink
Remote Related        System.LinkTypes.Remote.Related                              True       workItemLink
Attached File         AttachedFile                                                 True       resourceLink
Hyperlink             Hyperlink                                                    True       resourceLink
Artifact Link         ArtifactLink                                                 True       resourceLink

Domyślny format JSON zawiera dodatkowe informacje o atrybutach zdefiniowanych dla typów linków. Na przykład, informacje o typach linków Tworzy dla i Zużywa z są wymienione w następujący sposób.

  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": true,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Produces For",
    "referenceName": "System.LinkTypes.Remote.Dependency-Forward",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
  },
  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": false,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Consumes From",
    "referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
  },

witadmin listlinktypes

Typy linków obsługiwanych dla kolekcji projektów można wyświetlić przy użyciu narzędzia wiersza poleceń witadmin listlinktypes lub polecenia API REST Lista typów relacji elementów roboczych.

W tym miejscu wyświetlimy listę typów linków dla domyślnej kolekcji fabrikam-sever:

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection

Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True

Poniższa tabela zawiera opisy atrybutów każdego typu linku zwracanych przez interfejs wiersza polecenia usługi Azure Boards lub interfejs API REST.

Atrybut

Opis

Nazwy, name

Określa przyjazną nazwę przypisaną do typów linków. Linki kierunkowe są definiowane w parach, dlatego zawierają nazwę do przodu i odwrotnej.

Nazwa odwołania,referenceName

Określa nazwę przypisaną do typu łącza lub pary typu łącza.

acyclic

Wskazuje, czy typ łącza zezwala na (#A0) lub ogranicza (#A1) relacje cykliczne. Na przykład linki typu drzewa ograniczają relacje cykliczne. Aby uzyskać więcej informacji, zobacz odnośnik do elementów LinkTypes.

directional

Wskazuje, czy typ łącza jest kierunkowy ( #A0 ) czy nie ( #A1 ). Typy łączy kierunkowych są definiowane w parach z komponentem przód i wstecz. Aby uzyskać więcej informacji, zobacz w referencjach elementów LinkTypes.

editable

Wskazuje, czy typ łącza jest edytowalny ( #A0 ) czy nie ( #A1 ). Można jedynie dodawać i edytować niestandardowe typy linków dla wdrożeń lokalnych przy użyciu narzędzia wiersza poleceń witadmin "Zarządzaj typem linku". Typy łączy systemowych zawsze mają editable=false.

Jest aktywny, enabled

Wskazuje, czy typ łącza jest aktywny ( #A0 ) czy nie ( #A1 ). Można używać niestandardowych typów linków tylko w przypadku wdrożeń lokalnych, korzystając z narzędzia wiersza poleceń witadmin Zarządzaj typem linku.

isForward

Wskazuje, czy typ łącza określa link do przodu ( #A0 ) lub nie ( #A1 ) w parze typu łącza.

oppositeEndReferenceName

Określa nazwę referencyjną typu łącza, który definiuje łącze w odwrotnym kierunku w parze typów łączy.

remote

Wskazuje, czy typ łącza obsługuje łączenie z elementem roboczym zdalnym ( #A0 ) czy nie ( #A1 ). Typy łączy z remote=false wymagają, aby docelowy element roboczy znajdował się w tej samej organizacji lub kolekcji co element roboczy źródłowy.

singleTarget

Wskazuje, czy typ łącza zezwala na więcej niż jeden element docelowy ( #A0 ) lub jest ograniczony do jednego obiektu docelowego ( #A1 ).

topology

Określa typ topologii — sieć zależności, drzewo, and . Aby uzyskać opisy, zobacz Topologie typów linków i ograniczenia.

usage

Określa typ użycia — resourceLink lub workItemLink. Wartość workItemLinkvalue indicates a link type that links two work items. TheresourceLink wskazuje typ linku używany do łączenia elementu roboczego z zasobem, takiego jak adres URL lub załącznik.

url

Wyświetla listę atrybutów typu łącza w formacie json.