Elementy LinksControlOptions
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
<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:
|
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:
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:
Jeśli nie określono tego parametru, do filtrowania typu łącza są używane nazwy wykonywalna i wsteczna.
|
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:
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:
|
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:
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:
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 |
---|---|
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="&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:
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 () stanie się dostępny dopiero po zapisaniu otwartego elementu roboczego.
Przyciski otwierające listę elementów roboczych w zapytaniu () i w kliencie Microsoft Office () stają się dostępne tylko wtedy, gdy co najmniej jeden element znajduje się na karcie sterowania łączem.
Przyciski otwierania elementu roboczego (), edycji łącza () i usuwania łą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.
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