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

작업 항목을 사용자 지정하여 서로 연결할 작업 항목을 제어할 수 있습니다. 특히 사용자가 링크 컨트롤에서 확인하고 추가할 수 있는 링크 및 작업 항목의 형식을 제어할 수 있습니다. 예를 들어 폼에 탭을 추가하여 종속된 기능을 쉽게 관리할 수 있습니다. 탭에서 링크 컨트롤을 추가하고 팀 멤버가 해당 컨트롤에서 보고 만들 수 있는 링크 관계를 제한하여 다른 기능에 대한 링크만 포함하도록 지정할 수 있습니다.

Control 요소 LinksControl Type 특성을 사용하여 작업 항목과 Team Foundation 데이터베이스의 다른 개체 간의 링크 관계를 만들 수 있습니다. 그러면 LinksControlOptions 자식 요소를 사용하여 팀 멤버가 작업 항목에 추가할 수 있는 링크와 연결할 수 있는 작업 항목 형식 또는 개체를 제어하는 옵션을 정의할 수 있습니다. 또한 링크 컨트롤에서 링크 목록에 대해 나타낼 기본 열을 정의할 수 있습니다.

TFS 프로세스 템플릿에 대해 정의된 링크 제안의 요약은 링크 컨트롤, 제한 사항 및 필드 참조를 참조하십시오. 링크 형식에 대한 자세한 내용은 링크 형식 요소 참조을 참조하십시오.

항목 내용

• 링크 컨트롤 지정

• 링크 관계 제어

• 작업 항목에 대한 링크 관계 제한

• 변경 집합, 하이퍼링크 및 기타 작업 항목 이외 항목에 대한 링크 관계 제한

• 작업 항목 형식에 대한 링크 관계 제한

• 표시할 기본 열 지정

링크 컨트롤 지정

LinksControl을 사용하여 작업 항목 폼에서 링크 관계를 추가하고, 보고, 관리할 수 있습니다. 이 컨트롤을 사용하면 링크를 열고, 편집하고, 추가하고, 제거할 수 있습니다.

한 개의 탭에서 부모 링크와 자식 링크만 표시하고 다른 탭에서 기타 모든 링크 형식을 표시하도록 폼을 사용자 지정할 수 있습니다. 다음 예제에서는 팀 멤버가 모든 링크 형식을 추가하는 데 사용할 수 있는 "All Links"라는 탭을 만드는 방법을 보여 줍니다. 또한 링크 표시에 나타나는 기본 열은 ID, 작업 항목 형식, 제목, 담당자, 상태, 링크 설명 필드입니다.

Links 컨트롤

<Tab Label="All Links">
   <Control Type="LinksControl" Name="All" >
      <LinksControlOptions>
         <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>
</Tab>

맨 위로 이동

링크 관계 제어

작업 항목 폼에 링크 컨트롤을 추가할 경우 팀 멤버가 컨트롤을 사용할 때 추가할 수 있는 링크와 작업 항목의 형식을 제한하는 필터를 지정할 수 있습니다. 다음 표에서는 링크 관계를 제어하는 선택적 자식 요소에 대해 설명합니다.

맨 위로 이동

작업 항목에 대한 링크 관계 제한

WorkItemLinkFilters 및 Filter 자식 요소를 사용하여 링크 컨트롤이 포함하거나 제외할 링크 형식을 정의합니다. 이 요소를 사용하여 링크 컨트롤에서 동일한 프로젝트에 정의되는 작업 항목에 대한 관계를 만들기 위해 선택할 수 있는 링크 형식을 제한합니다. 이러한 요소의 구문은 다음과 같습니다.

<WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
</WorkItemLinkFilters>

예제: 두 작업 항목 링크 형식 제외

다음 코드 예제를 사용하여 사용자 지정 요구 사항 링크 형식과 시스템 계층 구조 링크 형식을 제외한 모든 링크 형식에 대한 링크 관계를 허용하는 링크 컨트롤을 정의할 수 있습니다.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="exclude">
         <Filter LinkType="MyLinks.LinkTypes.Requirement" /> 
         <Filter LinkType="System.LinkTypes.Hierarchy" /> 
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
. . .
</Control>

맨 위로 이동

변경 집합, 하이퍼링크 및 기타 작업 항목 이외 항목에 대한 링크 관계 제한

ExternalLinkFilters 및 Filter 자식 요소를 사용하여 링크 컨트롤이 포함하거나 제외할 팀 프로젝트 외부 항목에 대한 링크 형식을 정의합니다. 이러한 요소의 구문은 다음과 같습니다.

<ExternalLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="externalLinkName" />
</ExternalLinkFilters>

예제: 모든 작업 항목이 아닌 링크 제외

다음 예제에서는 작업 항목(예: 관련 항목 및 부모/자식)에 대한 모든 링크 형식을 포함하고 작업 항목이 아닌 항목(예: 변경 집합, 하이퍼링크, 테스트 결과)에 대한 링크 형식을 제외하는 링크 컨트롤을 정의합니다.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="includeAll" /> 
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
</Control>

다음 예제에서는 사용자가 변경 집합 링크 형식만 지정하고 변경 집합에만 연결하도록 허용하는 링크 컨트롤을 정의합니다.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="excludeAll"/>
      <ExternalLinkFilters FilterType="include" /> 
         <Filter LinkType="Fixed in Changeset" />
      </ExternalLinkFilters> 
 </LinksControlOptions>
. . .
</Control>

맨 위로 이동

작업 항목 형식에 대한 링크 관계 제한

WorkItemTypeFilters 및 Filter 자식 요소를 사용하여 링크 컨트롤이 연결할 수 있는 작업 항목의 형식을 제한합니다. 작업 항목 형식별로 또는 팀 프로젝트로 링크 관계를 제한할 수 있습니다. 이러한 요소의 구문은 다음과 같습니다.

<WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" >
   <Filter WorkItemType="workItemTypeReferenceName" />
</WorkItemTypeFilters>

예제: 작업(Task) 작업 항목에 대한 링크 관계 제한

다음 예제에서는 팀 프로젝트에 정의되는 작업에 대해 계층적 관계만 만들 수 있도록 허용하는 링크 컨트롤을 정의합니다.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="System.LinkTypes.Hierarchy" />
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll"/>
      <WorkItemTypeFilters Scope ="project" FilterType="include" />
         <Filter WorkItemType="Task" />
      </WorkItemTypeFilters> 
   </LinksControlOptions>
. . .
</Control>

맨 위로 이동

표시할 기본 열 지정

LinkColumns 및 LinkColumn 자식 요소를 사용하여 링크 컨트롤에 표시할 기본 열을 지정합니다. 작업 항목 필드의 참조 이름 또는 링크 특성을 지정할 수 있습니다. 이러한 요소의 구문은 다음과 같습니다.

<LinkColumns>
   <LinkColumn RefName="reference name" | LinkAttribute=" link attribute name" />
</LinkColumns>

요소가 나열되는 순서에 따라 작업 항목 폼에 열 필드가 표시되는 순서가 정해집니다. 참조 이름 및 링크 특성 목록은 Visual Studio ALM의 작업 항목 필드 참조을 참조하십시오. 다음 구문은 ID, 상태, 제목 및 링크 특성 열의 표시를 정의합니다.

<Control Type="LinksControl">
. . .
   <LinksControlOptions>
      <LinkColumns>
         <LinkColumn RefName="System.ID" />
         <LinkColumn RefName="System.State" />
         <LinkColumn RefName="System.Title" />
         <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

맨 위로 이동

참고 항목

참조

LinksControlOptions 요소

개념

링크 컨트롤, 제한 사항 및 필드 참조

링크 형식 요소 참조

작업 항목 폼 컨트롤 지정