LinksControlOptions 요소

아티클
04/10/2013

업데이트: 2012 년 9 월

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 특성입니다. 링크 형식에 대한 참조 이름을 지정합니다.유효한 유형은 다음과 같은 시스템 정의 링크 형식을 다음과 같습니다. 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 or LinkAttribute을 지정하지만 둘 모두를 지정할 수는 없습니다. 팀 프로젝트 컬렉션에 대한 유효한 작업 항목 형식에 해당하는 참조 이름을 지정합니다.특성 형식은 typelib:ReferenceFieldName입니다.
	LinkAttribute	선택적 LinkColumn 특성입니다.RefName or 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 도구 모음 단추

각 Control 요소의 Type=”LinksControl” 다음 그림과 같이 단추가 들어 있는 도구 모음을 제공 합니다.

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

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

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

표시 되는 링크 컨트롤 모두에 대해 동일 Team Web Access 및 팀 탐색기만 구성 되어 있을 때 렌더링 하는 점을 제외 하 고, 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>

요소 정보

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
스키마 이름	작업 항목 형식 정의
유효성 검사 파일	WorkItemTypeDefinition.xsd
요소 형식	LinksControlOptionsType
비워 둘 수 있음	해당 없음

참고 항목

개념

링크 형식 요소 참조

작업 항목 폼 컨트롤 지정

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

기타 리소스

사용자 지정 링크 형식 정의

변경 기록

날짜	변경 내용	이유
2012 년 9 월	대/소문자 구문 구조를 수정합니다.열거 값 모두 대 소문자를 구분 합니다.	콘텐츠 버그 수정

2012 년 9 월

대/소문자 구문 구조를 수정합니다.열거 값 모두 대 소문자를 구분 합니다.

콘텐츠 버그 수정

다음을 통해 공유