다음을 통해 공유


LinksControlOptions 요소

업데이트: 2011년 5월

LinksControlOptions 요소를 사용하여 작업 항목에 추가할 수 있는 링크를 제어하는 옵션과 작업 항목의 링크 목록에 대해 표시할 기본 열을 정의합니다. 작업 항목 폼에 링크 컨트롤을 추가할 경우 사용자가 보고 만들 수 있는 링크 형식과 링크를 만들 수 있는 작업 항목 형식을 제한하는 필터를 지정할 수 있습니다. 특히, 표시된 대로 다음 요소를 사용합니다.

  • WorkItemLinkFilters: 현재 팀 프로젝트에서 작업 항목 간의 링크 형식을 제한하는 데 사용합니다.

  • ExternalLinkFilters: 변경 집합, 하이퍼링크 또는 버전 제어 파일 등의 기타 개체와 작업 항목 간에 만들 수 있는 링크 형식을 제한하는 데 사용합니다.

  • WorkItemTypeFilters: 사용자가 작업 항목 형식 및 작업 항목이 현재 팀 프로젝트에 정의되었는지 여부에 따라 만들 수 있는 링크 관계를 제한하는 데 사용합니다.

이러한 각 요소에서 Filter 요소를 지정하여 포함하거나 제외할 링크 형식 또는 작업 항목 형식을 지정할 수 있습니다. 이러한 요소를 사용하는 방법에 대한 자세한 내용은 링크 관계를 제한하기 위한 링크 컨트롤 정의을 참조하십시오.

LinksControlOptions 요소는 CONTROL 요소의 자식 요소입니다.

스키마 계층 구조

WITD

   WORKITEMTYPE

       FORM

           레이아웃

               Group

               

               Tab

                     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

 

type="LinksControl"인 경우 선택적 Control 요소입니다.

작업 항목에 추가할 수 있는 링크와 작업 항목의 링크 관계의 목록에 대해 표시할 기본 열을 정의하는 요소에 대한 컨테이너를 제공합니다.

요소 형식은 복합 형식: LinksControlOptionsType입니다.

WorkItemLinkFilters

 

선택적 LinksControlOptions 요소입니다.

팀 프로젝트 컬렉션에 대해 정의되고 작업 항목 간의 관계를 만드는 링크 형식에 사용할 링크 필터 기준을 지정하는 하나 이상의 Filter 요소에 대한 컨테이너를 제공합니다.

요소 형식은 복합 형식: WorkItemLinkFiltersType입니다.

 

FilterType

필수 WorkItemLinkFilters 특성입니다.

Filter 요소 집합에서 제공되는 연결 종류 집합을 필터링하는 데 사용되는 메서드를 정의합니다. 요소 형식은 단순 형식입니다: LinksControlFilterKind.

사용할 수 있는 유효한 값은 다음과 같습니다.

  • exclude: 링크를 Filter 요소에 나열된 링크 형식에서 만들 수 없도록 합니다.

  • excludeAll: 모든 링크 형식을 허용하지 않습니다.

  • include: Filter 요소에 나열된 링크 형식만 허용하는 데 사용합니다.

  • includeAll: 링크를 모든 링크 형식에서 만들 수 있도록 합니다.

Filter

 

FilterType이 exclude 또는 include인 경우 필수적 WorkItemLinkFilters 요소입니다.

FilterType이 excludeAll 또는 includeAll이면 Filter 요소를 지정해서는 안 됩니다.

작업 항목에 대해 만들 수 있는 링크 집합에서 제외되거나 포함되는 링크 형식을 지정합니다. 요소 형식은 단순 형식입니다: WorkItemLinkFilterElementType.

 

LinkType

필수 Filter 특성입니다.

링크 형식에 대한 참조 이름을 지정합니다. 특성 형식은 typelib:ReferenceFieldName입니다. 자세한 내용은 링크 형식 작업을 참조하십시오.

 

FilterOn

선택적 Filter 특성입니다.

링크 형식에 적용할 필터 형식을 지정합니다. 요소 형식은 단순 형식입니다: LinksControlFilterOnKind.

올바른 값은 다음과 같습니다.

  • forwardName: 링크 형식에 대해 정의된 정방향 이름을 필터링할 수 있습니다.

  • revserseName: 링크 형식에 대해 정의된 역방향 이름을 필터링할 수 있습니다.

지정하지 않을 경우 링크 형식을 필터링하는 데 정방향 및 역방향 이름이 사용됩니다.

참고참고
링크 형식 토폴로지가 네트워크인 경우 정방향 및 역방향 이름이 동일합니다.자세한 내용은 링크 형식 작업을 참조하십시오.

ExternalLinkFilters

 

선택적 LinksControlOptions 요소입니다.

사용자가 변경 집합, 하이퍼링크 및 버전 제어 중인 파일 같은 작업 항목이 아닌 개체에 대한 관계를 만들기 위해 지정할 수 있는 링크 형식을 지정하는 하나 이상의 Filter 요소를 위한 컨테이너를 제공합니다. 요소 형식은 복합 형식입니다: ExternalLinkFiltersType.

 

FilterType

선택적 ExternalLinkFilters 특성입니다.

Filter 요소 집합에서 제공되는 연결 종류 목록을 필터링하는 데 사용되는 메서드를 정의합니다. 요소 형식은 단순 형식입니다: LinksControlFilterKind.

다음과 같은 값을 사용할 수 있습니다.

  • exclude: 링크를 Filter 요소에 나타나는 링크 형식에서 만들 수 없도록 합니다.

  • excludeAll: 모든 링크 형식을 허용하지 않습니다.

  • include: Filter 요소에 나열된 링크 형식만 허용하는 데 사용합니다.

  • includeAll: 링크를 모든 링크 형식에서 만들 수 있도록 합니다.

지정하지 않을 경우 외부 작업 항목에 대한 모든 링크가 제외됩니다.

Filter

 

FilterType이 exclude 또는 include인 경우 필수적 ExternalLinkFilters 요소입니다.

FilterType이 excludeAll 또는 includeAll이면 Filter 요소를 지정해서는 안 됩니다.

요소 형식은 복합 형식입니다: ExternalLinkFilterElementType.

작업 항목에 대해 사용자가 만들 수 있는 링크 집합에서 제외되거나 포함되는 링크 형식의 이름을 지정합니다.

 

LinkType

필수 Filter 특성입니다.

제외하거나 포함할 링크 형식에 대한 참조 이름을 지정합니다. 특성 형식은 간단한 형식입니다: ExternalLinkTypeName. 다음과 같은 링크 형식을 지정할 수 있습니다.

  • 변경 집합에서 수정됨

  • 결과 첨부 파일

  • 소스 코드 파일

  • 테스트 결과

  • 작업 항목 하이퍼링크

WorkItemTypeFilters

 

선택적 LinksControlOptions 요소입니다.

작업 항목 형식에 적용할 필터 기준을 지정하는 하나 이상의 Filter 요소에 대한 컨테이너를 제공합니다.

요소 형식은 복합 형식입니다: LinksControlWorkItemTypeFiltersElementType.

 

Scope

선택적 WorkItemTypeFilters 특성입니다.

Filter 요소 집합에서 제공되는 작업 항목 종류 집합에 적용되는 필터의 범위를 정의합니다. 요소 형식은 단순 형식입니다: LinksControlWorkItemTypeFilterScopeKind.

사용할 수 있는 유효한 값은 다음과 같습니다.

  • all: 링크를 Filter 태그가 지정된 모든 작업 항목 형식을 만들 수 있도록 합니다.

  • project: 링크를 현재 프로젝트에 대해 정의된 작업 항목 형식에 대해서만 만들 수 있도록 합니다.

지정하지 않을 경우 모든 작업 항목 형식에 대한 링크가 허용됩니다.

 

FilterType

필수 WorkItemTypeFilters 특성입니다.

Filter 요소 집합에서 제공되는 작업 항목 종류 집합을 필터링하는 데 사용되는 메서드를 정의합니다. 요소 형식은 단순 형식입니다: LinksControlWorkItemTypeFilterKind.

다음과 같은 값을 사용할 수 있습니다.

  • exclude: Filter 요소의 작업 항목 형식을 허용하지 않는 데 사용합니다.

  • excludeAll: 모든 작업 항목 형식을 허용합니다.

  • include: Filter 요소의 작업 항목 형식을 허용하는 데 사용합니다.

  • includeAll: 모든 작업 항목 형식을 허용합니다.

이 값을 지정하지 않은 경우 모든 작업 항목 형식에 대한 링크를 사용할 수 있습니다.

Filter

 

FilterType이 exclude 또는 include인 경우 선택적 WorkItemTypeFilters 요소입니다.

FilterType이 excludeAll 또는 includeAll이면 Filter 요소를 지정해서는 안 됩니다.

연결할 수 있는 작업 항목 형식 집합에 포함하거나 제외할 작업 항목 형식을 지정합니다. 요소 형식은 복합 형식입니다: LinksControlWorkItemTypeFilterElementType.

 

WorkItemType

필수 Filter 특성입니다.

필터링할 작업 항목 형식의 참조 이름을 지정합니다. 특성 형식은 typelib:NonEmptyPlainConstant입니다.

최소 길이: 1, 최대 길이: 255

패턴 값: ^[^\\]*$

패턴 값 예: Task

LinkColumns

 

선택적 LinksControlOptions 요소입니다.

하나 이상의 LinkColumn 요소에 대한 컨테이너를 제공합니다. 요소 형식은 복합 형식: LinkColumnsType입니다.

LinkColumn

 

필수적 LinkColumns 요소입니다.

작업 항목에 정의된 링크 목록에 대해 표시된 작업 항목 필드 및 링크 형식 특성을 지정합니다. 요소 형식은 복합 형식: LinkColumnType입니다.

이 열 목록은 기본적으로 표시됩니다. 사용자가 링크 목록에 열을 추가하고 제거할 수 있습니다.

LinkColumn 요소가 나열되는 순서는 작업 항목 폼에 열 필드가 표시되는 순서를 정의합니다.

 

RefName

선택적 LinkColumn 특성입니다. RefName or LinkAttribute을 지정하지만 둘 모두를 지정할 수는 없습니다.

팀 프로젝트 컬렉션에 대한 유효한 작업 항목 형식에 해당하는 참조 이름을 지정합니다. 특성 형식은 typelib:ReferenceFieldName입니다.

 

LinkAttribute

선택적 LinkColumn 특성입니다. RefName or LinkAttribute을 지정하지만 둘 모두를 지정할 수는 없습니다.

팀 프로젝트 컬렉션에 대한 유효한 링크 형식의 특성에 해당하는 참조 이름을 지정합니다. 특성 형식은 typelib:ReferenceFieldName입니다.

부모 요소

요소

설명

Control

필수적 요소로서, 작업 항목 폼에 나타나는 필드, 텍스트, 하이퍼링크 또는 기타 컨트롤 요소를 정의합니다.

설명

LinksControlOptions는 ControlType="LinksControl"인 Control 요소의 선택적 자식 요소입니다. LinksControlOptions 요소를 사용하여 다음과 같은 작업을 지원할 수 있습니다.

  • 링크 형식을 기반으로 다른 작업 항목에 대한 관계 작성 및 선택적으로 링크 형식의 정방향 및 역방향 이름에 적용되는 제한을 지정합니다.

  • 변경 집합, 하이퍼링크 등 외부 형식을 기반으로 하는 작업 항목 이외의 개체에 대한 관계 작성에 적용되는 제한을 지정합니다.

  • 작업 항목 형식을 기반으로 다른 작업 항목에 대한 관계 작성 및 선택적으로 이러한 형식 항목이 정의된 팀 프로젝트를 지정합니다.

  • 링크 목록에 대한 정보를 표시할 기본 열 필드를 지정합니다.

예제

다음 예제에서는 형식이 Microsoft.VSTS.Common.TestedBy인 링크를 만드는 방법을 지정하고 이 링크 형식에 대한 Forward Name을 보여줍니다. 필터 옵션은 모든 외부 링크 형식에 대한 링크를 만드는 것을 허용하지 않습니다. 뿐만 아니라, displayed나열된 링크에 대한 기본 열 필드는 링크에 대해 정의된 작업 항목 형식, 제목, 담당자, 상태 및 주석 필드에 해당합니다. 추가 예제는 링크 관계를 제한하기 위한 링크 컨트롤 정의를 참조하십시오.

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

스키마 정의

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

요소 정보

Namespace

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

스키마 이름

작업 항목 형식 정의

유효성 검사 파일

WorkItemTypeDefinition.xsd

요소 형식

LinksControlOptionsType

비워 둘 수 있음

해당 없음

참고 항목

개념

링크 형식 작업

작업 항목 폼 컨트롤 지정

기타 리소스

링크 형식을 통해 작업 항목의 관련 방식 사용자 지정

링크 관계를 제한하기 위한 링크 컨트롤 정의

변경 기록

날짜

변경 내용

이유

2011년 5월

여러 XML 요소의 케이스를 수정했습니다. 작업 항목 추적을 위한 스키마 정의는 FORM 요소의 모든 자식 요소를 카멜식 대/소문자로 정의하고 다른 모든 요소는 모두 대문자로 정의합니다.

콘텐츠 버그 수정

2011년 1월

제거된 항목 링크를 교체했습니다.

향상된 기능 관련 정보

2010년 7월

ExternalLinkFilters 요소와 함께 사용할 수 있는 참조 이름의 전체 목록이 추가되었습니다.

콘텐츠 버그 수정

2010년 6월

ExternalLinkFilters 및 WorkItemTypeFilters 요소에 대한 설명을 수정했습니다.

콘텐츠 버그 수정