Elementy LinksControlOptions

Artykuł
09/13/2015

Możesz użyć LinksControlOptions elementu do definiowania opcje do sterowania tym, co stanowi łącze można dodać do elementu pracy i domyślne kolumny, które mają być wyświetlane dla listy łączy w elemencie pracy. Po dodaniu formantu łączy do formularza elementu pracy, można określić filtry ograniczyć typy łączy, czy użytkownicy mogą być widok i tworzyć i typy elementów roboczych, do których użytkownicy można tworzyć łącza. W szczególności następujące elementy możesz używać wyszczególnionych:

WorkItemLinkFilters: Służy do ograniczania typów łączy między elementami pracy w bieżącym projekcie zespołowym.
ExternalLinkFilters: Użyj, aby ograniczyć typy łączy, które mogą być tworzone między elementów roboczych i innych obiektów, takich jak pliki wersji kontrolowane, hiperłącza lub grup zmian.
WorkItemTypeFilters: Służy do ograniczania relacje łącze, które użytkownicy mogą tworzyć na podstawie typu elementu roboczego i określa, czy element pracy jest zdefiniowana w bieżącym projekcie zespołowym.

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

LinksControlOptions Element jest elementem podrzędnym CONTROL elementu.

Schemat hierarchii

<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 Control elementu po type="LinksControl". Udostępnia kontener dla elementów, które określają, jakie łącza można dodać do elementu pracy i domyślne kolumny są wyświetlane na liście relacji łącze w elementu pracy. Typ elementu jest typ złożony: LinksControlOptionsType.
WorkItemLinkFilters		Opcjonalny LinksControlOptions elementu. Udostępnia kontener dla co najmniej jednego Filter kryteria na potrzeby typy łączy, które są definiowane dla kolekcji projektów zespołowych i który tworzyć relacje między elementami pracy filtrowania elementów, które określają łącza. Typ elementu jest typ złożony: WorkItemLinkFiltersType.
	FilterType	Wymagane WorkItemLinkFilters atrybutu. Określa metodę używaną do filtrowania zestawu typy łączy w zestawie Filter elementów. Typ elementu jest typu prostego: LinksControlFilterKind. Prawidłowe wartości, których można używać to: exclude: Użyj, aby uniemożliwić łącza do można utworzyć na podstawie tych typów łączy się na liście Filter elementów. excludeAll: Użyj, aby uniemożliwić wszystkie typy łączy. include: Umożliwia Zezwalaj tylko na typy łączy się na liście Filter elementów. includeAll: Użyj, aby umożliwić łącza do utworzenia ze wszystkich typów łącza.
Filter		Wymagane WorkItemLinkFilters elementu po FilterType jest exclude lub include. Gdy FilterType jest excludeAll lub includeAll, nie Filter powinny być określone elementy. Określa typy łączy, które mają być uwzględnione lub wykluczone z zestawu łączy, które mogą być tworzone dla elementu roboczego. Typ elementu jest typu prostego: WorkItemLinkFilterElementType.
	LinkType	Wymagane Filter atrybutu. Określa nazwę odwołania dla typu łącza. Prawidłowe typy następujące typy łącza systemu zdefiniowane: 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łowych. Aby uzyskać więcej informacji, zobacz Odwołania do elementu typów łączy.
	FilterOn	Opcjonalny Filter atrybutu. Określa typ filtrów do zastosowania do typu łącza. Typ elementu jest typu prostego: LinksControlFilterOnKind. Prawidłowe wartości to: forwardname: Służy do filtrowania do przodu nazwy zdefiniowane dla typu łącza. reversename: Służy do filtrowania odwrotnej nazwy zdefiniowane dla typu łącza. Jeśli nie zostanie podany, do przodu i Wstecz nazwy są używane do filtrowania typu łącza. Uwaga Jeśli topologii typu łącza sieciowego, do przodu i Wstecz nazwy są takie same.Aby uzyskać więcej informacji, zobacz Odwołania do elementu typów łączy.
ExternalLinkFilters		Opcjonalny LinksControlOptions elementu. Udostępnia kontener dla co najmniej jednego Filter elementów, które określają typy łączy, które użytkownicy mogą określić w celu utworzenia relacji dla obiektów, które są działa elementów, takich jak grupy zmian, hiperłącza i pliki w kontroli wersji. Typ elementu jest złożony: ExternalLinkFiltersType.
	FilterType	Opcjonalny ExternalLinkFilters atrybutu. Definiuje metody, która jest używana do filtrowania listy typów łącza zawarte w zestawie Filter elementów. Typ elementu jest proste: LinksControlFilterKind. Można użyć następujących wartości: exclude: Użyj, aby uniemożliwić łącza do można utworzyć na podstawie tych typów łącza, które są widoczne w Filter elementów. excludeAll: Użyj, aby uniemożliwić wszystkie typy łączy. include: Umożliwia Zezwalaj tylko na typy łączy się na liście Filter elementów. includeAll: Użyj, aby umożliwić łącza do utworzenia ze wszystkich typów łącza. Jeśli nie zostanie podany, wszystkie łącza z elementami pracy zewnętrzne są wyłączone.
Filter		Wymagane ExternalLinkFilters elementu po FilterType jest exclude lub include. Gdy FilterType jest excludeAll lub includeAll, nie Filter powinny być określone elementy. Typ elementu jest złożony: ExternalLinkFilterElementType. Określa nazwę typy łączy, które zostaną uwzględnione lub wykluczone z zestawu łączy, które użytkownicy mogą tworzyć dla elementu roboczego.
	LinkType	Wymagane Filter atrybutu. Określa nazwę odwołania dla typu łącze, aby wykluczyć lub dołączyć. Typ atrybutu jest proste: ExternalLinkTypeName. Można określić następujące łącza: Ustalone w grupie zmian Załącznik wynikowy. Plik kodu źródłowego Wynik testu Hiperłącze do elementu pracy
WorkItemTypeFilters		Opcjonalny LinksControlOptions elementu. Udostępnia kontener dla co najmniej jednego Filter elementy, które Określ kryteria filtrowania, które ma być stosowana do elementu pracy typów. Typ elementu jest złożony: LinksControlWorkItemTypeFiltersElementType.
	Scope	Opcjonalny WorkItemTypeFilters atrybutu. Definiuje zakres filtr zastosowany do zestawu typów elementów roboczych w zestawie Filter elementów. Typ elementu jest typu prostego: LinksControlWorkItemTypeFilterScopeKind. Prawidłowe wartości, których można używać to: all: Użyć, aby umożliwić łącza do utworzenia dla wszystkich typów elementów pracy, określona w Filter tagów. project: Użyj, aby umożliwić łącza do utworzenia tylko do tych typów elementów pracy, które są definiowane dla bieżącego projektu. Jeśli nie zostanie podany, łącza do wszystkich typów elementów roboczych są dozwolone.
	FilterType	Wymagane WorkItemTypeFilters atrybutu. Definiuje metody, która jest używana do filtrowania zestaw typów elementów roboczych w zestawie Filter elementów. Typ elementu jest proste: LinksControlWorkItemTypeFilterKind. Można użyć następujących wartości: exclude: Użyj, aby uniemożliwić typy elementów roboczych w Filter elementów. excludeAll: Użyj, aby uniemożliwić wszystkie typy elementów roboczych. include: Użyj, aby zezwolić na typy elementów pracy w Filter elementów. includeAll: Użyj zezwalająca na wszystkie typy elementów roboczych. Jeśli nie określisz któregokolwiek z tych wartości, łącza do wszystkich typów elementów roboczych są dozwolone.
Filter		Opcjonalny WorkItemTypeFilters elementu po FilterType jest exclude lub include. Gdy FilterType jest excludeAll lub includeAll, nie należy określać żadnego Filter elementów. Określa typy elementów pracy, które mają być uwzględnione lub wykluczone z zestawu typów elementów pracy, które mogą być połączone z. Typ elementu jest typ złożony: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Wymagane Filter atrybutu. Nazwa odwołania typu elementu roboczego do filtrowania. Typ atrybutu: typelib:NonEmptyPlainConstant. Minimalna długość: 1; Maksymalna długość: 255. Wartość do wzorca: ^ [^ \\] * $ Przykład wartość wzorzec: zadania
LinkColumns		Opcjonalny LinksControlOptions elementu. Udostępnia kontener dla co najmniej jednego LinkColumn elementów. Typ elementu jest typ złożony: LinkColumnsType.
LinkColumn		Wymagane LinkColumns elementu. Określa pola elementów roboczych i wyświetlany dla listy łączy zdefiniowanych dla elementu roboczego atrybuty typu łącza. Typ elementu jest typ złożony: LinkColumnType. Ta lista kolumny jest wyświetlana domyślna. Użytkownik może dodawać i usuwać kolumny z listy łącza. Kolejność, w której LinkColumn elementy są wyświetlane definiuje kolejność wyświetlania pola kolumn w postaci elementów roboczych.
	RefName	Opcjonalny LinkColumn atrybutu. Określ RefName lub LinkAttribute, ale nie oba jednocześnie. Określa nazwę odniesienia odpowiadającą wartości pola elementu pracy prawidłowe dla kolekcji projektów zespołowych. Typ atrybutu typelib:ReferenceFieldName.
	LinkAttribute	Opcjonalny LinkColumn atrybutu. Określ RefName lub LinkAttribute, ale nie oba jednocześnie. Określa nazwę odwołania odpowiadające dowolnego atrybutu dla określonego typu prawidłowe łącze do kolekcji projektów zespołowych. Typ atrybutu typelib:ReferenceFieldName.

Elementy nadrzędne

Element	Opis
Formant	Parametr wymagany. Definiuje pole, tekst, hiperłącze lub innego elementu sterowania pojawi się w formularzu elementu pracy.

Uwagi

LinksControlOptions jest opcjonalne podrzędny element Control elementu gdzie ControlType="LinksControl". Można użyć LinksControlOptions elementu, aby wspierać następujące działania:

Określ ograniczenia, które ma zastosowanie w przypadku utworzenia relacji do innych elementów pracy na podstawie typu łącza i opcjonalnie nazwy typów łącza do przodu i do tyłu.
Określ ograniczenia, które określają sposób tworzenia relacje z obiektów innych niż pracy elementy, takie jak grupa zmian, hiperłącze i tak dalej, w oparciu o typy łączy zewnętrznych.
Określ ograniczenia, które określają sposób tworzenia relacji do innych elementów roboczych w oparciu o typu elementu roboczego i opcjonalnie projektu zespołowego, w którym te elementy pracy są zdefiniowane.
Określ domyślne pola kolumny, które mają być wyświetlane informacje o liście łącze.

Przykład

W poniższym przykładzie określa sposób umożliwiają tworzenie łączy, którego typem jest Microsoft.VSTS.Common.TestedBy i Pokaż Forward Name dla tego typu łącza. Opcje filtru zabraniać tworzenia łączy do wszystkich typów zewnętrznego łącza. Ponadto są wyświetlane domyślne pola kolumn na liście łącza odpowiadają następujące przyjazne nazwy: identyfikator typu elementu roboczego, tytuł, przydzielone do, stanu i pole Komentarz zdefiniowane 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 element Type=”LinksControl” udostępnia narzędzi zawiera przyciski wyświetlane w następnej ilustracji:

Work item form link toolbar controls

Przyciski te stają się dostępne tylko wtedy, gdy wykonywanie określonych akcji:

Przycisk, aby utworzyć element pracy, która jest połączona z elementem pracy otwarte () jest dostępna tylko, po zapisaniu Otwórz element roboczy.
Przyciski, aby otworzyć listę elementów pracy w zapytaniu () i w kliencie programu Microsoft Office () są dostępne tylko podczas pracy co najmniej jeden element znajduje się w karcie kontroli łącza.
Przyciski, aby otworzyć element pracy (), Edytuj łącze () i Usuń łącze () są dostępne tylko w przypadku, gdy zostanie kliknięty przycisk jednego lub wielu elementów pracy na liście kartę Formant łącza.

Formant łącza, który jest wyświetlany jest taki sam dla obu Team Web Access i Team Explorer, z wyjątkiem, gdy jest on skonfigurowany do tylko renderowania Storyboard łącza. W takim przypadku pasek narzędzi zawiera tylko te formanty, aby dodać nowe łącze, otwórz element połączonych i Usuń łącze. Ponadto Team Web Access Wyświetla wersję Start Scenorysy łącze w menu Kontrola.

Storyboard links control

Definicje schematu

LinksControlOptionsType
WorkItemLinkFiltersType
WorkItemLinkFilterElementType
ExternalLinkFiltersType
ExternalLinkFilterElementType
LinksControlFilterKind
LinksControlFilterOnKind
ExternalLinkTypeName
LinksControlWorkItemTypeFiltersElementType
LinksControlWorkItemTypeFilterElementType
LinksControlWorkItemTypeFilterScopeKind
LinksControlWorkItemTypeFilterKind
LinkColumnsType
LinkColumnType

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>

ExternalLinkFiltersType

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

ExternalLinkFilterElementType

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

ExternalLinkTypeName

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

LinkColumnType

<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 elementach

Przestrzeń nazw	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/TypeDef
Nazwa schematu	Definicja typu elementu roboczego
Sprawdzanie poprawności plików	WorkItemTypeDefinition.xsd
Typ elementu	LinksControlOptionsType
Może być pusta.	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

Udostępnij za pośrednictwem