LinksControlOptions Öğeleri

LinksControlOptions öğesini, bir iş öğesine ne tür bağlantıların eklenebileceğini denetlemek için seçenekleri ve bir iş öğesinde bağlantılar listesinde görünmesini istediğiniz varsayılan sütunları belirlemek üzere kullanırsınız. Bir iş öğesi formuna bir bağlantılar denetimi eklediğinizde, kullanıcıların görüntüleyebildikleri ve oluşturabildikleri bağlantı türlerini ve kullanıcıların bağlantı oluşturabildikleri çalışma öğesi türlerini sınırlayan filtreler belirtebilirsiniz. Özel olarak, aşağıdaki öğeleri gösterildiği gibi kullanırsınız:

• WorkItemLinkFilters: Geçerli ekip projesinde çalışma öğeleri arasındaki bağlantı türlerini kısıtlamak için kullanın.

• ExternalLinkFilters: İş öğeleri ve değişim kümeleri, köprüler veya sürüm denetimli dosyalar gibi diğer nesneler arasında oluşturulabilen türleri kısıtlamak için kullanılır.

• WorkItemTypeFilters: Kullanıcıların çalışma öğesi türüne ve çalışma öğesinin geçerli ekip projesinde tanımlanıp tanımlanmadığına bağlı olarak oluşturdukları bağlantı ilişkilerini kısıtlamak için kullanın.

Bu öğelerin her birinde, dahil etmek veya hariç tutmak istediğiniz bağlantı türlerini veya iş öğesi türlerini belirlemek üzere Filter öğelerini belirtebilirsiniz. Bu öğeleri kullanma hakkında daha fazla bilgi için bkz. Bağlantı İlişkilerini Kısıtlamak için Bağlantı Denetimlerini Tanımlama.

LinksControlOptions öğesi CONTROL öğesinin bir alt öğesidir.

Şema Hiyerarşisi

WITD

   WORKITEMTYPE

       FORM

           LAYOUT

               GROUP

               COLUMN

               SEKME

                     DENETİM

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

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Alt Öğeler ve Öznitelikler

Öğe	Öznitelik	Açıklama
LinksControlOptions		Seçime bağlı Control öğesi type="LinksControl" olduğunda. Bir iş öğesine ne tür bağlantıların eklenebileceğini ve bir iş öğesinde bağlantı ilişkileri listesi için hangi varsayılan sütunların görüneceğini tanımlayan öğeler için bir kapsayıcı sağlar. Öğe türü karmaşık türdür: LinksControlOptionsType.
WorkItemLinkFilters		İsteğe bağlı LinksControlOptions ögesi. Bir ya da daha fazla Filter öğesi için, takım projesi koleksiyonunda tanımlanmış ve çalışma öğeleri arasında ilişki oluşturan bağlantı türlerini kullanmak üzere bağlantı filtresi kriterlerini belirten bir kapsayıcı sağlar. Öğe türü karmaşık türdür: WorkItemLinkFiltersType.
	FilterType	Gerekli WorkItemLinkFilters özniteliği. Filter öğeleri kümesinde sağlanan bağlantı türleri kümesini filtrelemek üzere yöntemi tanımlar. Öğe türü basit türdür: LinksControlFilterKind. Kullanabileceğiniz geçerli değerler: exclude: Filter öğelerinde listelenen bağlantı türlerinden oluşturulacak bağlantıları, engellemekte kullanılır. excludeAll: Bütün bağlantı türlerini engellemek için kullanın. include: Filter öğelerinde listelenmiş bağlantı türlerine izin vermek üzere kullanın. includeAll: Bütün bağlantı türlerinden oluşturulacak bağlantılara izin vermek için kullanın.
Filter		FilterType, exclude veya include olduğu zaman, gerekli WorkItemLinkFilters öğesi. FilterType, excludeAll veya includeAll olduğunda, Filter öğeleri tanımlanmamalıdır. İş öğesi için oluşturulabilecek bağlantı türleri kümesinden dahil edilecek veya hariç tutulacak bağlantı türlerini belirtir. Öğe türü basit türdür: WorkItemLinkFilterElementType.
	LinkType	Gerekli Filter özniteliği. Bir bağlantı türü için başvuru adını belirtir. Öznitelik türü typelib:ReferenceFieldName'dir. Daha fazla bilgi için bkz. Bağlantı Türleriyle Çalışma.
	FilterOn	İsteğe Bağlı Filter özniteliği. Bağlantı türüne uygulanacak filtrenin türünü belirtir. Öğe türü basit türdür: LinksControlFilterOnKind. Geçerli değerler şunlardır: forwardName: Bir bağlantı türü için ileri adında filtreleme yapmak üzere kullanın. revserseName: Bir bağlantı türü için ters adında filtreleme yapmak üzere kullanın. Belirtilmemişse, hem ileri hem de ters adlar bağlantı türünü filtrelemekte kullanılır. Not Bağlantı türü topolojisi Ağ ise, ileri ve ters adlar aynıdır.Daha fazla bilgi için bkz. Bağlantı Türleriyle Çalışma.
ExternalLinkFilters		İsteğe bağlı LinksControlOptions ögesi. Değişiklik kümeleri, köprüler ve sürüm denetimi altındaki dosyalar gibi, çalışma öğeleri dışındaki nesneler için ilişki oluşturmak amacıyla kullanıcıların belirtebileceği bağlantı türlerini belirten bir veya daha fazla Filter öğesi için bir kapsayıcı sağlar. Öğe türü karmaşıktır: ExternalLinkFiltersType.
	FilterType	İsteğe Bağlı ExternalLinkFilters özniteliği. Filter öğeleri kümesi üzerinde sağlanmış olan bağlantı türü listesini filtrelemek için kullanılan yöntemi tanımlar. Öğe türü basittir: LinksControlFilterKind. Aşağıdaki değerleri kullanabilirsiniz: exclude: Filter öğelerinde görülen bu bağlantı türlerinden oluşturulacak bağlantıları engellemek için kullanın. excludeAll: Bütün bağlantı türlerini engellemek için kullanın. include: Filter öğelerinde listelenmiş bağlantı türlerine izin vermek üzere kullanın. includeAll: Bütün bağlantı türlerinden oluşturulacak bağlantılara izin vermek için kullanın. Belirtilmezse, dış iş öğelerine olan bütün bağlantılar hariç tutulur.
Filter		FilterType, exclude veya include olduğu zaman, gerekli ExternalLinkFilters öğesi. FilterType, excludeAll veya includeAll olduğunda, Filter öğeleri tanımlanmamalıdır. Öğe türü karmaşıktır: ExternalLinkFilterElementType. İş öğesi için kullanıcıların oluşturulabileceği bağlantı türleri kümesinden dahil edilecek veya hariç tutulacak bağlantı türlerinin adını belirtir.
	LinkType	Gerekli Filter özniteliği. İçermek veya hariç tutmak üzere, bir bağlantı türü için başvuru adını belirtir. Öznitelik türü basit türdür:ExternalLinkTypeName. Aşağıdaki bağlantı türlerini belirleyebilirsiniz: Changeset üzerinde sabit Sonuç eki Kaynak Kodu Dosyası Test Sonucu Çalışma Öğesi Köprüsü
WorkItemTypeFilters		İsteğe bağlı LinksControlOptions öğesi. İş öğesi türlerine uygulanacak filtre kriterlerini belirten bir ya da daha fazla Filter öğesi için bir kapsayıcı sağlar. Öğe türü karmaşıktır: LinksControlWorkItemTypeFiltersElementType.
	Scope	İsteğe Bağlı WorkItemTypeFilters özniteliği. Filter öğeleri kümesinde sağlanan iş öğesi türleri kümesine uygulanmış filtrenin kapsamını tanımlar. Öğe türü basit türdür: LinksControlWorkItemTypeFilterScopeKind. Kullanabileceğiniz geçerli değerler: all: Filter etiketlerinde belirtilen bütün iş öğesi türlerinde oluşturulacak bağlantılara izin vermek üzere kullanın. project: Yalnızca güncel proje için tanımlanmış iş öğesi türlerinde oluşturulacak bağlantılara izin vermek üzere kullanın. Belirtilmezse, bütün iş öğesi türlerine olan bağlantılara izin verilir.
	FilterType	Gerekli WorkItemTypeFilters özniteliği. Filter öğeleri kümesinde sağlanan iş öğesi türleri kümesini filtrelemek üzere kullanılan yöntemi tanımlar. Öğe türü basittir: LinksControlWorkItemTypeFilterKind. Aşağıdaki değerleri kullanabilirsiniz: exclude: İş öğesi türlerine Filter öğelerini engellemek için kullanın. excludeAll: Tüm iş öğesi türlerini engellemek için kullanın. include: İş öğesi türlerine Filter öğelerinde izin verilmesini sağlamak için kullanın. includeAll: Tüm iş öğe türlerine izin vermek için kullanın. Bu değerlerin herhangi birini belirtmezseniz, tüm iş öğe türlerine bağlantılara izin verilir.
Filter		FilterType, exclude veya include olduğu zaman, tercihe bağlı WorkItemTypeFilters öğesi. FilterType öğesi excludeAll veya includeAll olduğunda herhangi bir Filter öğesi belirtmemeniz gerekir. Bağlanılabilecek iş öğesi türleri kümesinden dahil edilecek veya hariç tutulacak iş öğesi türlerini belirtir. Öğe türü karmaşık türdür: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Gerekli Filter özniteliği. Filtrelenecek bir iş öğesi türünün başvuru adını belirtir. Öznitelik türü typelib:NonEmptyPlainConstant'dir. En az uzunluk: 1; en fazla uzunluk: 255. Desen değeri: ^[^\\]*$ Desen değeri örneği: Görev
LinkColumns		İsteğe bağlı LinksControlOptions öğesi. Bir veya daha fazla LinkColumn öğesi için bir kapsayıcı sağlar. Öğe türü karmaşık türdür: LinkColumnsType.
LinkColumn		Gerekli LinkColumns öğesi. Bir iş öğesi için tanımlı bağlantılar listesinde görüntülenen, iş öğesi türlerini ve bağlantı türü özniteliklerini belirtir. Öğe türü karmaşık türdür: LinkColumnType. Sütun listesi varsayılan görüntüdür. Kullanıcı, bağlantı listesinden sütunları ekleyebilir veya kaldırabilir. LinkColumn öğelerinin listelendiği sıra, iş öğesi formunda sütun alanlarının görüntülendiği sırayı tanımlar.
	RefName	İsteğe Bağlı LinkColumn özniteliği RefName'i veya LinkAttribute 'ü belirleyin, ama ikisini birden değil. Takım projesi koleksiyonu için geçerli bir iş öğesi alanına karşılık gelen başvuru adını belirtir. Öznitelik türü typelib:ReferenceFieldName'dir.
	LinkAttribute	İsteğe Bağlı LinkColumn özniteliği RefName'i veya LinkAttribute 'ü belirleyin, ama ikisini birden değil. Takım projesi koleksiyonu için geçerli bir bağlantı türünün herhangi bir özniteliğine karşılık gelen başvuru adını belirtir. Öznitelik türü typelib:ReferenceFieldName'dir.

Üst Öğeler

Açıklamalar

LinksControlOptions, ControlType="LinksControl" olduğu yerde, CONTROL öğesinin tercihe bağlı bir alt öğesidir. LinksControlOptions öğesini aşağıdaki eylemleri desteklemek üzere kullanabilirsiniz:

• Bağlantı türüne ve tercihe bağlı biçimde bağlantı türlerinin ileri ve ters adlarına bağlı olarak, diğer çalışma öğeleriyle ilişkilerin oluşturulmasını düzenleyen kısıtlamaları belirtin.

• Harici bağlantı türlerine bağlı olarak, değişiklik kümesi, köprü vb. gibi çalışma öğeleri dışındaki nesnelerle ilişkilerin oluşturulmasını düzenleyen kısıtlamaları belirtin.

• Çalışma öğesi türüne ve tercihe bağlı biçimde söz konusu çalışma öğelerinin tanımlandığı ekip projesine bağlı olarak, diğer çalışma öğeleriyle ilişkilerin oluşturulmasını düzenleyen kısıtlamaları belirtin.

• Bağlantı listesi bilgisini görüntülemek istediğiniz varsayılan sütun adlarını belirtin.

Örnek

Aşağıdaki örnek, türü Microsoft.VSTS.Common.TestedBy olan bağlantıları oluşturmanın nasıl etkinleştirildiğini ve bu bağlantı türü için Forward Name'in nasıl gösterildiğini belirtir. Filtre seçenekleri, bütün dış bağlantı türlerine bağlantı oluşturmayı engeller. Ayrıca, listelenmiş bağlantıların görüntülenen varsayılan sütunları şu kolay adlara karşılık gelir: kimlik, iş öğesi türü, başlık, atanan, devlet ve bağlantı için tanımlı yorum alanı. Daha fazla örnek için bkz. Bağlantı İlişkilerini Kısıtlamak için Bağlantı Denetimlerini Tanımlama.

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

Şema Tanımları

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

Öğe Bilgisi

Ayrıca bkz.

Kavramlar

Bağlantı Türleriyle Çalışma

Çalışma Öğesi Formu Denetimlerini Belirtme

Diğer Kaynaklar

İş Öğeleri'nin Bağlantı Türleri ile Nasıl İlişkili Olduğunu Özelleştirme

Bağlantı İlişkilerini Kısıtlamak için Bağlantı Denetimlerini Tanımlama

Değişiklik Geçmişi