Udostępnij za pośrednictwem

Elementy LinksControlOptions

  • Artykuł

Należy użyć elementu LinksControlOptions, aby zdefiniować opcje do kontrolowania tego, jakie łącza mogą zostać dodane do elementu pracy i domyślnych kolumn, jakie mają się pojawiać na liście łączy w elemencie roboczym.Kiedy dodajesz formant łączy do formularza elementu roboczego, możesz określić filtry, które ograniczają typy łączy, które użytkownicy mogą wyświetlać i tworzyć oraz typy elementów roboczych, do których użytkownicy mogą tworzyć łącza.W szczególności można użyć następujących elementów, jak wskazano:

  • WorkItemLinkFilters: Użyj, aby ograniczyć typy łączy między elementami roboczymi w bieżącym projekcie zespołowym.

  • ExternalLinkFilters: ogranicza typy łączy, które mogą być tworzone między elementów roboczymi i innymi obiektami, takimi jak zestawy zmian, hiperłącza i pliki zależne od wersji.

  • WorkItemTypeFilters: Użyj, aby ograniczyć relacje łączy, które użytkownicy mogą tworzyć na bazie typu elementu roboczego i faktu czy element roboczy jest zdefiniowany w bieżącym projekcie zespołowym.

W każdym z tych elementów, można określić Filter elementów, aby określić typy łączy lub typy elementów roboczych, które chcesz uwzględnić lub wykluczyć.Aby uzyskać więcej informacji na temat z tych elementów, zobacz Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi.

Element LinksControlOptions nie jest prawidłowym elementem potomnym elementu CONTROL .

Hierarchia schematu

WITD

   WORKITEMTYPE

       FORM

           Układ

               Grupa

               Kolumna

               Tab

                     Formant

<xs:element name="LinksControlOptions" type="LinksControlOptionsType" minOccurs="0"/>
<xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
<xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
<xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="WorkItemTypeFilters"   type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
<xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
<xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="reference name" | LinkAttribute="link attribute name"/>
   </LinkColumns>
</LinksControlOptions>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Elementy podrzędne i atrybuty

Element

Atrybut

Opis

LinksControlOptions

 

Opcjonalny element Control gdy type="LinksControl".

Oferuje kontener dla elementów, który określa łącza, które mogą być dodawane do elementu roboczego oraz domyślnych kolumn, aby pojawiły się na liście relacji łączy w elemencie roboczym.

Typ elementu to typ złożony: LinksControlOptionsType.

WorkItemLinkFilters

 

Opcjonalny LinksControlOptions element.

Oferuje kontener dla jednego lub kilku elementów Filter, które określają kryteria filtrowania łączy do typów łączy, które zostały zdefiniowane dla kolekcji projektu zespołowego i które tworzą relacje między elementami roboczymi.

Typ elementu to typ złożony: WorkItemLinkFiltersType.

 

FilterType

Wymagany WorkItemLinkFilters atrybut.

Określa metodę, która jest używana do filtrowania zestawów typów łączy dostarczanych w zestawie Filter elementów.Typ elementu to typ prosty: LinksControlFilterKind.

Prawidłowe wartości, z których możesz korzystać to:

  • exclude: zabrania tworzenia łączy na podstawie typów łączy wymienionych w elementach Filter.

  • excludeAll: zabrania tworzenia łączy dowolnego typu.

  • include: Służy do umożliwienia tylko tych typów łączy wymienionych w elementach Filter.

  • includeAll: Służy do umożliwienia tworzenia łączy z wszystkich typów łącza.

Filter

 

Wymagany element WorkItemLinkFilters gdy FilterType jest exclude lub include.

Kiedy FilterType to excludeAll lub includeAll, żadne elementy Filter nie powinny być określone.

Określa typy łączy, które mają być dołączone lub wykluczone z zestawu łączy, jakie mogą być tworzone dla elementu roboczego.Typ elementu to typ prosty: WorkItemLinkFilterElementType.

 

LinkType

Wymagany Filter atrybut.

Określa nazwę odwołania do pewnego typu łącza.Prawidłowe typy obejmują poniższe zdefiniowane przez system typy łączy:

  • Storyboard

  • System.LinkTypes.Dependency

  • System.LinkTypes.Hierarchy

  • System.LinkTypes.Related

Ponadto można określić nazwę odwołania dla typów łączy niestandardowych zdefiniowanych dla kolekcji projektów zespołowego.Aby uzyskać więcej informacji, zobacz Odwołania do elementu typów łączy.

 

FilterOn

Opcjonalny atrybut Filter.

Określa typ filtru do zastosowania do typu łącza.Typ elementu to typ prosty: LinksControlFilterOnKind.

Prawidłowe wartości to:

  • forwardname: służy do filtrowania przesyłanej dalej nazwy zdefiniowanej dla typu łącza.

  • reversename: Służy do filtrowania przesyłanej z powrotem nazwy zdefiniowanej dla typu łącza.

Jeśli nie określono tego parametru, do filtrowania typu łącza są używane nazwy wykonywalna i wsteczna.

[!UWAGA]

Jeśli topologia typu łącza to sieć, nazwy wykonywalna i wsteczna są takie same.Aby uzyskać więcej informacji, zobacz Odwołania do elementu typów łączy.

ExternalLinkFilters

 

Opcjonalny LinksControlOptions element.

Oferuje kontener dla jednego lub kilku elementów Filter, które określają typy łączy, które użytkownicy mogą określić, aby utworzyć relacje z obiektami, które nie są elementami roboczymi, takimi jak zestawy zmian, hiperłącza i pliki znajdujące się pod kontrolą wersji.Typ elementu to typ złożony: ExternalLinkFiltersType.

 

FilterType

Opcjonalny atrybut ExternalLinkFilters.

Określa metodę, która jest używana do filtrowania listy typów łączy dostarczanych w zestawie Filter elementów.Typ elementu jest prosty: LinksControlFilterKind.

Można użyć poniższych wartości:

  • exclude: zabrania tworzenia łączy na podstawie typów łączy pojawiających się w elementach Filter.

  • excludeAll: zabrania tworzenia łączy dowolnego typu.

  • include: Służy do umożliwienia tylko tych typów łączy wymienionych w elementach Filter.

  • includeAll: Służy do umożliwienia tworzenia łączy z wszystkich typów łącza.

Jeśli nie określono tego parametru, wszystkie łącza do zewnętrznych elementów roboczych są wykluczone.

Filter

 

Wymagany element ExternalLinkFilters gdy FilterType jest exclude lub include.

Kiedy FilterType to excludeAll lub includeAll, żadne elementy Filter nie powinny być określone.

Typ elementu to typ złożony: ExternalLinkFilterElementType.

Określa nazwy typów łączy, które będą uwzględnione lub wyłączone z zestawu łączy, które użytkownicy mogą tworzyć dla elementu roboczego.

 

LinkType

Wymagany Filter atrybut.

Określa nazwę odwołania do pewnego typu łącza, aby wykluczyć lub uwzględnić.Typ atrybutu jest prosty: ExternalLinkTypeName.Możesz określić poniższe typy łączy:

  • Ustalone w grupie zmian

  • Załącznik wynikowy

  • Plik kodu źródłowego

  • Wyniki testu

  • Element roboczy hiperłącza

WorkItemTypeFilters

 

Opcjonalny LinksControlOptions element.

Oferuje kontener dla jednego lub kilku elementów Filter, które określają kryteria filtrowania do zastosowania do typów elementów roboczych.

Typ elementu to typ złożony: LinksControlWorkItemTypeFiltersElementType.

 

Scope

Opcjonalny atrybut WorkItemTypeFilters.

Definiuje zakres filtru zastosowany do zestawu typów elementów roboczych dostarczanych w zestawie Filter elementów.Typ elementu to typ prosty: LinksControlWorkItemTypeFilterScopeKind.

Prawidłowe wartości, z których możesz korzystać to:

  • all: Służy do zezwalania, aby łącze zostało utworzone na wszystkich typach elementów pracy, określonych Filter zakładkach.

  • project: Służy do umożliwienia utworzenia łącza tylko do tych typów elementów roboczych, które są zdefiniowane dla bieżącego projektu.

Jeśli nie określono tego parametru, łącza do wszystkich typów elementów roboczych są dozwolone.

 

FilterType

Wymagany WorkItemTypeFilters atrybut.

Określa metodę, która jest używana do filtrowania zestawu typów elementów roboczych dostarczanych w zestawie Filter elementów.Typ elementu jest prosty: LinksControlWorkItemTypeFilterKind.

Można użyć poniższych wartości:

  • exclude: zabrania typów elementu roboczego w elementach Filter.

  • excludeAll: zabrania tworzenia elementów roboczych dowolnego typu.

  • include: Służy do umożliwienia typów elementu roboczego w elementach Filter.

  • includeAll: Służy do umożliwienia typów elementu roboczego.

Jeśli nie określisz żadnej z tych wartości, łącza do wszystkich typów elementów roboczych są dozwolone.

Filter

 

Opcjonalny element WorkItemTypeFilters, gdy FilterType jest exclude lub include.

Kiedy FilterType to excludeAll lub includeAll, nie należy określać żadnych elementów Filter.

Określa typy elementów roboczych, które mają być dołączone lub wykluczone z zestawu typów elementów roboczych, jakie mogą być połączone.Typ elementu to typ złożony: LinksControlWorkItemTypeFilterElementType.

 

WorkItemType

Wymagany Filter atrybut.

Określa nazwę odwołania pola w typie elementu roboczego do przefiltrowania.Typ atrybutu jest: typelib:NonEmptyPlainConstant.

Minimalna długość: 1; Maksymalna długość: 255.

PWartość wzorca: ^[^\\]*$

Przykład wartości wzorca: Zadanie

LinkColumns

 

Opcjonalny LinksControlOptions element.

Oferuje kontener dla jednego lub kilku elementów LinkColumn.Typ elementu to typ złożony: LinkColumnsType.

LinkColumn

 

Wymagany LinkColumns element.

Określa pola elementu roboczego i atrybuty typu łącza wyświetlane dla listy łączy zdefiniowane dla elementu roboczego.Typ elementu to typ złożony: LinkColumnType.

Lista kolumn jest domyślnym wyświetlaczem.Użytkownik może dodać i usunąć kolumny z listy łączy.

Kolejność, w której elementy LinkColumn są wyszczególnione na liście definiuje kolejność, w jakiej pola kolumny są wyświetlane w formularzu elementu roboczego.

 

RefName

Opcjonalny atrybut LinkColumn.Określ RefName lub LinkAttribute, ale nie obu.

Określa nazwę odwołania, odpowiadającą ważnemu polu elementu roboczego do kolekcji projektu zespołowego.Typ atrybutu typelib:ReferenceFieldName.

 

LinkAttribute

Opcjonalny atrybut LinkColumn.Określ RefName lub LinkAttribute, ale nie obu.

Określa nazwę odwołania, odpowiadającą dowolnemu atrybutowi do ważnego typu łącza do kolekcji projektu zespołowego.Typ atrybutu typelib:ReferenceFieldName.

Elementy nadrzędne

Element

Opis

Formant

Wymagany.Określa pola, tekst, hiperłącze lub inne elementy sterowania do pojawienia się na formularzu elementu pracy.

Uwagi

LinksControlOptions jest podrzędnym elementem opcjonalnym elementu Control gdzie ControlType="LinksControl".Można użyć elementu LinksControlOptions, aby wesprzeć następujące czynności:

  • Określ ograniczenia, które określają sposób tworzenia relacji z innymi elementami roboczymi opartymi na typie łącza oraz — opcjonalnie – na nazwach wykonywalnych i wstecznych typów łączy.

  • Określ ograniczenia, które określają sposób tworzenia relacji z obiektami innymi niż elementy robocze, jak zestaw zmian, hiperłącze i tak dalej, na podstawie typów łączy zewnętrznych.

  • Określ ograniczenia, które określają sposób tworzenia relacji z innymi elementami roboczymi opartymi na elementach roboczych oraz — opcjonalnie – projektach zespołowych, gdzie zdefiniowane są te elementy robocze.

  • Określ domyślne pola kolumn, w których mają być wyświetlane informacje o liście łączy.

Przykład

Poniższy przykład określa, jak włączyć funkcję tworzenia łączy, których typ to Microsoft.VSTS.Common.TestedBy i pokazać Forward Name dla tego typu łącza.Opcje filtrowania uniemożliwiają tworzenie łączy do wszystkich typów łączy zewnętrznych.Ponadto, wyświetlane pola kolumn domyślnych do wymienionych łączy odpowiadają następującym przyjaznym nazwom: identyfikator, typ elementu roboczego, tytuł, przydzielone do, stan i pole komentarz zdefiniowanym dla łącza.Aby uzyskać więcej przykładów, zobacz Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi.

<Control Type="LinksControl" Name="TestedBy" Label="&amp;Work items testing this bug:" LabelPosition="Top">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="Microsoft.VSTS.Common.TestedBy" FilterOn="forwardname" />
      </WorkItemLinkFilters>
      <WorkItemTypeFilters FilterType="include">
          <Filter WorkItemType="Test Case" />
      </WorkItemTypeFilters>
          <ExternalLinkFilters FilterType="excludeAll"/>
      <LinkColumns>
          <LinkColumn RefName="System.ID" />
          <LinkColumn RefName="System.WorkItemType" />
          <LinkColumn RefName="System.Title" />
          <LinkColumn RefName="System.AssignedTo" />
          <LinkColumn RefName="System.State" />
          <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

Przyciski paska narzędzi LinksControl

Każdy Control elementu Type=”LinksControl” zawiera pasek narzędzi, który zawiera przyciski wyświetlane na następnej ilustracji:

Przy użyciu narzędzi łącza kontrolek elementu pracy

Przyciski te stają się dostępne jedynie po wykonaniu określonych operacji:

  • Przycisk tworzący element roboczy, który jest połączony z otwartym elementem roboczym (Dodawanie ikony nowego połączonego elementu pracy) stanie się dostępny dopiero po zapisaniu otwartego elementu roboczego.

  • Przyciski otwierające listę elementów roboczych w zapytaniu (Otwieranie w zapytaniu) i w kliencie Microsoft Office (Otwórz w pakiecie Office) stają się dostępne tylko wtedy, gdy co najmniej jeden element znajduje się na karcie sterowania łączem.

  • Przyciski otwierania elementu roboczego (Otwórz element roboczy), edycji łącza (Edytuj łącze) i usuwania łącze (Usuń łącze) stają się dostępne dopiero po kliknięciu jednego lub więcej elementów roboczych wymienionych na karcie sterowania łączem.

Formant łącza, który jest wyświetlany, jest taki sama zarówno dla Team Web Access i Team Explorer, z wyjątkiem przypadków, gdy jest skonfigurowany wyłącznie w celu generowania łączy Storyboard.W tym przypadku pasek narzędzi zawiera tylko te ustawienia, aby dodać nowy link, otworzyć połączony element i usunąć link.Ponadto Team Web Access wersja wyświetla Start sceny łącze znajdujące się w menu sterowania.

Kontrola łącza scenorysu w dostępu do sieci Web zespołu

Definicje schematu

  • LinksControlOptionsType

  • WorkItemLinkFiltersType

  • WorkItemLinkFilterElementType

  • Typ ExternalLinkFilter

  • Typ elementu ExternalLinkFilter

  • LinksControlFilterKind

  • LinksControlFilterOnKind

  • Nazwa ExternalLinkFilter

  • LinksControlWorkItemTypeFiltersElementType

  • LinksControlWorkItemTypeFilterElementType

  • LinksControlWorkItemTypeFilterScopeKind

  • LinksControlWorkItemTypeFilterKind

  • LinkColumnsType

  • Typ LinkColumn

LinksControlOptionsType

<xs:complexType name="LinksControlOptionsType">
   <xs:all>
      <xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
      <xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemTypeFilters" type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
   </xs:all>
</xs:complexType>

WorkItemLinkFiltersType

<xs:complexType name="WorkItemLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

WorkItemLinkFilterElementType

<xs:complexType name="WorkItemLinkFilterElementType" >
   <xs:attribute name="LinkType" type="typelib:ReferenceFieldName" use="required" />
   <xs:attribute name="FilterOn" type="LinksControlFilterOnKind" use="optional" />
</xs:complexType>

Typ ExternalLinkFilter

<xs:complexType name="ExternalLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

Typ elementu ExternalLinkFilter

<xs:complexType name="ExternalLinkFilterElementType" >
   <xs:attribute name="LinkType" type="ExternalLinkTypeName" use="required" />
</xs:complexType>

LinksControlFilterKind

<xs:simpleType name="LinksControlFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
      <xs:enumeration value="excludeAll" />
   </xs:restriction>
</xs:simpleType>

LinksControlFilterOnKind

<xs:simpleType name="LinksControlFilterOnKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="forwardname" />
      <xs:enumeration value="reversename" />
   </xs:restriction>
</xs:simpleType>

Nazwa ExternalLinkFilter

<xs:simpleType name="ExternalLinkTypeName">
   <xs:restriction base="xs:string">
      <xs:minLength value="1"/>
      <xs:maxLength value="128"/>
   </xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFiltersElementType

<xs:complexType name="LinksControlWorkItemTypeFiltersElementType" >
   <xs:sequence>
      <xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="Scope" type="LinksControlWorkItemTypeFilterScopeKind" use="optional" />
      <xs:attribute name="FilterType" type="LinksControlWorkItemTypeFilterKind" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterElementType

<xs:complexType name="LinksControlWorkItemTypeFilterElementType" >
   <xs:attribute name="WorkItemType" type="typelib:NonEmptyPlainConstant" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterScopeKind

<xs:simpleType name="LinksControlWorkItemTypeFilterScopeKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="project" />
   <xs:enumeration value="all" />
</xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFilterKind

<xs:simpleType name="LinksControlWorkItemTypeFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
   </xs:restriction>
</xs:simpleType>

LinkColumnsType

<xs:complexType name="LinkColumnsType" >
   <xs:sequence>
      <xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>
   </xs:sequence>
</xs:complexType>

Typ LinkColumn

<xs:complexType name="LinkColumnType" >
   <!-- Must be one or the other, but not both -->
      <xs:attribute name="LinkAttribute" type="typelib:ReferenceFieldName" use="optional" />
      <xs:attribute name="RefName" type="typelib:ReferenceFieldName" use="optional" />
</xs:complexType>

Informacje o elemencie

Przestrzeń nazw

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

Nazwa schematu

Definicja typu elementu roboczego

Plik walidacji

WorkItemTypeDefinition.xsd

Typ elementu

LinksControlOptionsType

Może być pusty.

Nie dotyczy

Zobacz też

Koncepcje

Odwołania do elementu typów łączy

Określanie sterowania formularzem elementu pracy

Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi

Inne zasoby

Definiowanie niestandardowego typu łącza