LinksControlOptions 要素

[アーティクル]
11/30/2015

LinksControlOptions 要素を使用して、作業項目に追加できるリンクを制御するオプションと、作業項目にリンクの一覧として表示する既定の列を制御するオプションを定義します。作業項目フォームにリンクコントロールを追加する場合、ユーザーが表示および作成できるリンクの種類を制限するフィルターと、ユーザーがリンクを作成できる作業項目の種類を制限するフィルターを指定できます。具体的には、以下の要素を指示に従って使用します。

WorkItemLinkFilters: 現在のチームプロジェクトの作業項目間のリンクの種類を制限します。
ExternalLinkFilters: 作業項目や、変更セット、ハイパーリンク、バージョン管理ファイルなどのその他のオブジェクト間で作成できるリンクの種類を制限します。
WorkItemTypeFilters: ユーザーが作業項目の種類に基づいて作成できるリンクの関係と、その作業項目が現在のチームプロジェクトで定義されるかどうかを制限します。

これらの各要素で、Filter 要素を指定して、含めるまたは除外するリンクの種類または作業項目の種類を指定できます。これらの要素を使用する方法の詳細については、「リンクコントロールの定義とリンク関係の制限」を参照してください。

LinksControlOptions 要素は、CONTROL 要素の子要素です。

スキーマの階層

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

子要素と属性

要素	属性	説明
LinksControlOptions		Control の場合、type="LinksControl" 要素は省略可能です。作業項目に追加できるリンクと、作業項目のリンクの関係の一覧として表示する既定の列を定義する要素のコンテナーを提供します。要素型は LinksControlOptionsType 複合型です。
WorkItemLinkFilters		省略可能な LinksControlOptions 要素。チームプロジェクトコレクションに定義されるリンクの種類に使用されるリンクのフィルター条件を指定し、作業項目間の関係を作成する 1 つ以上の Filter 要素用のコンテナーを提供します。要素型は WorkItemLinkFiltersType 複合型です。
	FilterType	必須の WorkItemLinkFilters 属性です。 Filter 要素のセットで指定された一連のリンクの種類をフィルターするために使用するメソッドを定義します。要素型は LinksControlFilterKind 単純型です。使用できる有効値は、次のとおりです。 exclude: Filter 要素の一覧に含まれるリンクの種類からのリンクの作成を許可しないようにします。 excludeAll: すべてのリンクの種類を許可しないようにします。 include: Filter 要素の一覧に含まれるリンクの種類のみ許可します。 includeAll: すべてのリンクの種類からのリンクの作成を許可します。
Filter		WorkItemLinkFilters が FilterType または exclude の場合には、include 要素は必須です。 FilterType が excludeAll または includeAll の場合、Filter 要素は指定できません。作業項目用に作成できるリンクのセットに含めるリンクの種類またはリンクのセットから除外するリンクの種類を指定します。要素型は WorkItemLinkFilterElementType 単純型です。
	LinkType	必須の Filter 属性です。リンクの種類の参照名を指定します。有効な種類には、システムで定義される次のリンクの種類が含まれています。 Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related また、チームプロジェクトコレクションに対して定義されるカスタムのリンクの種類の参照名を指定できます。詳細については、「リンクの種類要素のリファレンス」を参照してください。
	FilterOn	省略可能な Filter 属性です。リンクの種類に適用するフィルターの種類を指定します。要素型は LinksControlFilterOnKind 単純型です。次の値を指定できます。 forwardname: リンクの種類に定義されている転送名をフィルターします。 reversename: リンクの種類に定義されている反転名をフィルターします。この値を指定しない場合、転送名と反転名の両方を使用してリンクの種類がフィルターされます。注意リンクの種類のトポロジがネットワークの場合、転送名と反転名は同じになります。詳細については、「リンクの種類要素のリファレンス」を参照してください。
ExternalLinkFilters		省略可能な LinksControlOptions 要素。変更セット、ハイパーリンク、バージョン管理下のファイルなど、作業項目でないオブジェクトとの関係を作成するためにユーザーが指定できるリンクの種類を指定する 1 つ以上の Filter 要素用のコンテナーを提供します。要素型は ExternalLinkFiltersType 複合型です。
	FilterType	省略可能な ExternalLinkFilters 属性です。 Filter 要素のセットで指定された一連のリンクの種類をフィルターするために使用するメソッドを定義します。要素型は LinksControlFilterKind 単純型です。使用できる値は次のとおりです。 exclude: Filter 要素に表示されるリンクの種類からのリンクの作成を許可しないようにします。 excludeAll: すべてのリンクの種類を許可しないようにします。 include: Filter 要素の一覧に含まれるリンクの種類のみ許可します。 includeAll: すべてのリンクの種類からのリンクの作成を許可します。値を指定しない場合、外部の作業項目に対するすべてのリンクが除外されます。
Filter		ExternalLinkFilters が FilterType または exclude の場合には、include 要素は必須です。 FilterType が excludeAll または includeAll の場合、Filter 要素は指定できません。要素型は ExternalLinkFilterElementType 複合型です。作業項目用に作成できるリンクのセットに含めるリンクの種類またはリンクのセットから除外するリンクの種類の名前を指定します。
	LinkType	必須の Filter 属性です。除外する、または含めるリンクの種類の参照名を指定します。属性型は ExternalLinkTypeName 単純型です。指定できるリンクの種類は次のとおりです。変更セットで修正済み結果の添付ファイルソースコードファイル Test Result 作業項目ハイパーリンク
WorkItemTypeFilters		省略可能な LinksControlOptions 要素。作業項目の種類に適用されるフィルター条件を指定する 1 つ以上の Filter 要素用のコンテナーを提供します。要素型は LinksControlWorkItemTypeFiltersElementType 複合型です。
	Scope	省略可能な WorkItemTypeFilters 属性です。 Filter 要素のセットで指定された一連の作業項目の種類に適用されるフィルターのスコープを定義します。要素型は LinksControlWorkItemTypeFilterScopeKind 単純型です。使用できる有効値は、次のとおりです。 all: Filter タグで指定されたすべての作業項目の種類へのリンクの作成を許可します。 project: 現在のチームプロジェクトに対して定義されている作業項目の種類に対してのみリンクの作成を許可します。値を指定しない場合、すべての種類の作業項目に対するリンクが許可されます。
	FilterType	必須の WorkItemTypeFilters 属性です。 Filter 要素のセットで指定された一連の作業項目の種類をフィルターするために使用するメソッドを定義します。要素型は LinksControlWorkItemTypeFilterKind 単純型です。使用できる値は次のとおりです。 exclude: Filter 要素で作業項目の種類を許可しないようにします。 excludeAll: すべての作業項目の種類を許可しないようにします。 include: Filter 要素で作業項目の種類を許可します。 includeAll: すべての作業項目の種類を許可します。これらの値のいずれも指定しない場合は、すべての作業項目の種類へのリンクが許可されます。
Filter		WorkItemTypeFilters が FilterType または exclude の場合には、include 要素は省略可能です。 FilterType が excludeAll または includeAll の場合、Filter 要素は指定できません。リンク先の作業項目の種類のセットに含める作業項目の種類または除外する作業項目の種類を指定します。要素型は LinksControlWorkItemTypeFilterElementType 複合型です。
	WorkItemType	必須の Filter 属性です。フィルターする作業項目の種類の参照名を指定します。属性型は typelib:NonEmptyPlainConstant です。最小長は 1、最大長は 255 です。パターン値: ^[^\\]*$ パターン値の例: Task
LinkColumns		省略可能な LinksControlOptions 要素。 1 つ以上の LinkColumn 要素用のコンテナーを提供します。要素型は、LinkColumnsType 複合型です。
LinkColumn		必須の LinkColumns 要素です。作業項目に対して定義されているリンクの一覧に表示する作業項目のフィールドとリンクの種類の属性を指定します。要素型は、LinkColumnType 複合型です。この列の一覧は、既定の表示です。ユーザーは、この一覧に対して列を追加または削除できます。 LinkColumn 要素が表示される順序は、作業項目フォームで列フィールドが表示される順序を定義します。
	RefName	省略可能な LinkColumn 属性です。 RefName または LinkAttribute の一方だけを指定します。チームプロジェクトコレクションの有効な作業項目の種類に対応する参照名を指定します。属性型は typelib:ReferenceFieldName です。
	LinkAttribute	省略可能な LinkColumn 属性です。 RefName または LinkAttribute の一方だけを指定します。チームプロジェクトコレクションの有効なリンクの種類の属性に対応する参照名を指定します。属性型は typelib:ReferenceFieldName です。

親要素

要素	説明
コントロール	必須。作業項目フォームに表示するフィールド、テキスト、ハイパーリンク、その他のコントロール要素を定義します。

解説

LinksControlOptions は、Control の場合、ControlType="LinksControl" 要素の省略可能な子要素です。 LinksControlOptions 要素を使用して、次の操作をサポートできます。

リンクの種類に基づいた他の作業項目との関係の作成の管理と、省略可能なリンクの種類の転送名と反転名に対する制限を指定します。
変更セットやハイパーリンクなど、外部リンクの種類に基づいた、作業項目以外のオブジェクトとの関係の作成を管理する制限を指定します。
作業項目の種類に基づいた他の作業項目との関係の作成の管理と、省略可能なこれらの作業項目が定義されているチームプロジェクトに対する制限を指定します。
リンクの一覧で情報を表示する既定の列フィールドを指定します。

使用例

次の例では、種類が Microsoft.VSTS.Common.TestedBy のリンクの作成を有効にし、このリンクの種類の Forward Name を表示する方法を示します。フィルターオプションでは、すべての外部のリンクの種類に対するリンクの作成を許可しません。また、一覧に含まれるリンクで表示される既定の列フィールドは、リンクで定義されている [ID]、[作業項目の種類]、[タイトル]、[担当者]、[状態]、および [コメント] のフィールドの表示名に対応しています。例については、「リンクコントロールの定義とリンク関係の制限」を参照してください。

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

LinksControl のツールバーのボタン

Type=”LinksControl” の各 Control 要素にはツールバーが用意されています。このツールバーには、次の図に示されるようなボタンがあります。

作業項目フォームリンクツールバーコントロール

これらのボタンは、特定のアクションを実行した後にのみ使用できるようになります。

開いている作業項目にリンクされた作業項目を作成するボタン () は、開いている作業項目を保存した後にのみ使用できるようになります。
クエリ内の作業項目の一覧を開くボタン () と Microsoft Office クライアント内の作業項目の一覧を開くボタン () は、リンクのコントロールタブに少なくとも 1 つの作業項目が表示されたときにのみ使用できるようになります。
作業項目を開くボタン ()、リンクを編集するボタン ()、およびリンクを削除するボタン () は、リンクのコントロールタブに表示された作業項目を 1 つ以上クリックした後にのみ使用できるようになります。

表示されるリンクコントロールは、Team Web Access とチームエクスプローラーで同じですが、Storyboard リンクのみを表示するように構成されている場合は例外です。この場合は、ツールバーには、新しいリンクを追加するコントロール、リンクされた項目を開くコントロール、およびリンクを削除するコントロールだけが含まれます。また、Team Web Access バージョンでは、コントロールメニュー内に [ストーリーボード操作の開始] リンクが表示されます。

ストーリーボードリンクの制御

スキーマ定義

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>

要素情報

名前空間	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
スキーマ名	作業項目の種類の定義
検証ファイル	WorkItemTypeDefinition.xsd
要素型	LinksControlOptionsType
空も使用できる	利用不可

参照

概念

リンクの種類要素のリファレンス

作業項目フォーム上のコントロールの指定

リンクコントロールの定義とリンク関係の制限

その他の技術情報

ユーザー設定のリンクの種類の定義

次の方法で共有

LinksControlOptions 要素

属性および要素

子要素と属性

親要素

解説

使用例

LinksControl のツールバーのボタン

スキーマ定義

LinksControlOptionsType

WorkItemLinkFiltersType

WorkItemLinkFilterElementType

ExternalLinkFiltersType

ExternalLinkFilterElementType

LinksControlFilterKind

LinksControlFilterOnKind

ExternalLinkTypeName

LinksControlWorkItemTypeFiltersElementType

LinksControlWorkItemTypeFilterElementType

LinksControlWorkItemTypeFilterScopeKind

LinksControlWorkItemTypeFilterKind

LinkColumnsType

LinkColumnType

要素情報

参照

概念

その他の技術情報

その他のリソース

次の方法で共有

LinksControlOptions 要素

属性および要素

子要素と属性

親要素

解説

使用例

LinksControl のツール バーのボタン

スキーマ定義

LinksControlOptionsType

WorkItemLinkFiltersType

WorkItemLinkFilterElementType

ExternalLinkFiltersType

ExternalLinkFilterElementType

LinksControlFilterKind

LinksControlFilterOnKind

ExternalLinkTypeName

LinksControlWorkItemTypeFiltersElementType

LinksControlWorkItemTypeFilterElementType

LinksControlWorkItemTypeFilterScopeKind

LinksControlWorkItemTypeFilterKind

LinkColumnsType

LinkColumnType

要素情報

参照

概念

その他の技術情報

その他のリソース

LinksControl のツールバーのボタン