LinksControlOptions 요소

아티클
11/18/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 요소입니다. 팀 프로젝트 컬렉션에 대해 정의되고 작업 항목 간의 관계를 만드는 링크 형식에 사용할 링크 필터 기준을 지정하는 하나 이상의 Filter 요소에 대한 컨테이너를 제공합니다. 요소 형식은 복합 형식: WorkItemLinkFiltersType입니다.
	FilterType	필수 WorkItemLinkFilters 특성입니다. Filter 요소 집합에서 제공되는 연결 종류 집합을 필터링하는 데 사용되는 메서드를 정의합니다. 요소 형식은 단순 형식: LinksControlFilterKind입니다. 사용할 수 있는 유효한 값은 다음과 같습니다. exclude: 링크를 Filter 요소에 나열된 링크 형식에서 만들 수 없도록 합니다. excludeAll: 모든 링크 형식을 허용하지 않습니다. include: Filter 요소에 나열된 링크 형식만 허용하는 데 사용합니다. includeAll: 링크를 모든 링크 형식에서 만들 수 있도록 합니다.
Filter		FilterType이 exclude 또는 include인 경우 필수 WorkItemLinkFilters 요소입니다. FilterType이 excludeAll 또는 includeAll이면 Filter 요소를 지정해서는 안 됩니다. 작업 항목에 대해 만들 수 있는 링크 집합에서 제외되거나 포함되는 링크 형식을 지정합니다. 요소 형식은 단순 형식: WorkItemLinkFilterElementType입니다.
	LinkType	필수 Filter 특성입니다. 링크 형식에 대한 참조 이름을 지정합니다. 유효한 형식에는 다음과 같은 시스템 정의 링크 형식이 있습니다. Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related 또한 팀 프로젝트 컬렉션에 정의된 사용자 지정 링크 형식에 대한 참조 이름을 지정할 수 있습니다. 자세한 내용은 링크 형식 요소 참조를 참조하세요.
	FilterOn	선택적 Filter 특성입니다. 링크 형식에 적용할 필터 형식을 지정합니다. 요소 형식은 단순 형식: LinksControlFilterOnKind입니다. 올바른 값은 다음과 같습니다. forwardname: 링크 형식에 대해 정의된 정방향 이름을 필터링할 수 있습니다. reversename: 링크 형식에 대해 정의된 역방향 이름을 필터링할 수 있습니다. 지정하지 않을 경우 링크 형식을 필터링하는 데 정방향 및 역방향 이름이 사용됩니다. 참고 링크 형식 토폴로지가 네트워크인 경우 정방향 및 역방향 이름이 동일합니다.자세한 내용은 링크 형식 요소 참조를 참조하세요.
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 또는 LinkAttribute를 지정하지만 둘 모두를 지정할 수는 없습니다. 팀 프로젝트 컬렉션에 대한 유효한 작업 항목 형식에 해당하는 참조 이름을 지정합니다. 특성 형식은 typelib:ReferenceFieldName입니다.
	LinkAttribute	선택적 LinkColumn 특성입니다. RefName 또는 LinkAttribute를 지정하지만 둘 모두를 지정할 수는 없습니다. 팀 프로젝트 컬렉션에 대한 유효한 링크 형식의 특성에 해당하는 참조 이름을 지정합니다. 특성 형식은 typelib:ReferenceFieldName입니다.

부모 요소

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

설명

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>

LinksControl 도구 모음 단추

Type=”LinksControl”의 각 Control 요소는 다음 그림에 표시된 단추가 포함된 도구 모음을 제공합니다.

작업 항목 폼 링크 도구 모음 컨트롤

특정 작업을 수행한 후에만 이러한 단추를 사용할 수 있습니다.

열린 작업 항목에 연결되는 작업 항목을 만드는 단추()는 열린 작업 항목을 저장한 후에만 사용 가능합니다.
최소 하나 이상의 작업 항목이 링크 컨트롤 탭에 나열될 때만 쿼리() 및 Microsoft Office 클라이언트()에서 작업 항목의 목록 열기 단추를 사용할 수 있습니다.
작업 항목을 여는 단추(), 링크를 편집하는 단추() 및 링크를 삭제하는 단추()는 링크 컨트롤 탭에 있는 작업 항목을 하나 이상 클릭한 후에만 사용 가능합니다.

표시되는 링크 컨트롤은 Storyboard 링크만 렌더링하도록 구성되어 있는 경우를 제외하고는 Team Web Access 및 팀 탐색기 모두에 대해 동일합니다. 이 경우 도구 모음에는 새 링크 추가, 연결된 항목 열기 및 링크 삭제를 위한 컨트롤만 포함됩니다. 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
비워 둘 수 있음	적용할 수 없음

참고 항목

개념

링크 형식 요소 참조

작업 항목 폼 컨트롤 지정

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

기타 리소스

사용자 지정 링크 형식 정의

다음을 통해 공유