LinksControlOptions 요소

아티클
08/10/2011

업데이트: 2011년 5월

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		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 요소에 대한 설명을 수정했습니다.	콘텐츠 버그 수정

2011년 5월

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

콘텐츠 버그 수정

2011년 1월

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

향상된 기능 관련 정보

2010년 7월

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

콘텐츠 버그 수정

2010년 6월

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

콘텐츠 버그 수정

다음을 통해 공유

LinksControlOptions 요소

특성 및 요소

자식 요소 및 특성

부모 요소

설명

예제

스키마 정의

LinksControlOptionsType

WorkItemLinkFiltersType

WorkItemLinkFilterElementType

ExternalLinkFiltersType

ExternalLinkFilterElementType

LinksControlFilterKind

LinksControlFilterOnKind

ExternalLinkTypeName

LinksControlWorkItemTypeFiltersElementType

LinksControlWorkItemTypeFilterElementType

LinksControlWorkItemTypeFilterScopeKind

LinksControlWorkItemTypeFilterKind

LinkColumnsType

LinkColumnType

요소 정보

참고 항목

개념

기타 리소스

변경 기록

추가 리소스