다음을 통해 공유


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

업데이트: 2010년 7월

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

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

MSF(Microsoft Solutions Framework) for Agile Software Development v5.0용 프로세스 템플릿에 대해 정의되는 링크 제한 사항과 관련한 요약 설명은 작업 항목 링크(Agile)를 참조하십시오. 링크 형식에 대한 자세한 내용은 링크 형식 작업을 참조하십시오.

항목 내용

  • 링크 컨트롤 지정

  • 링크 관계 제어

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

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

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

  • 표시할 기본 열 지정

링크 컨트롤 지정

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

작업 항목에 연결하는 데 사용할 수 있는 링크 형식을 제한합니다.

ExternalLinkFilters

변경 집합, 하이퍼링크, 버전 제어 항목 등과 같이 작업 항목 형식이 아닌 개체에 연결하는 데 사용할 수 있는 링크 형식을 제한합니다.

WorkItemTypeFilters

사용자가 연결할 수 있는 작업 항목의 형식과 작업 항목을 정의할 팀 프로젝트를 제한합니다.

Filter

포함하거나 제외하려는 링크 형식 또는 작업 항목 형식을 지정합니다.

맨 위로 이동

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

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

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

특성

설명

FilterType

필수 WorkItemLinkFilters 특성입니다.

Filter 요소 집합에서 제공하는 링크 형식 집합을 필터링하는 데 사용되는 메서드를 정의합니다. 유효한 값은 다음과 같습니다.

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

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

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

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

LinkType

필수 Filter 특성입니다.

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

FilterOn

선택적 Filter 특성입니다.

링크 형식에 적용할 필터 형식을 지정합니다. 유효한 값은 다음과 같습니다.

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

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

지정하지 않을 경우 링크 형식을 필터링하는 데 정방향 이름과 역방향 이름이 모두 사용됩니다. 링크 형식 토폴로지가 네트워크인 경우 정방향 및 역방향 이름이 동일합니다. 자세한 내용은 링크 형식 작업을 참조하십시오.

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

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

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

특성

설명

FilterType

선택적 ExternalLinkFilters 특성입니다.

Filter 요소 집합에서 제공하는 링크 형식 집합을 필터링하는 데 사용되는 메서드를 정의합니다. 유효한 값은 다음과 같습니다.

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

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

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

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

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

LinkType

필수 Filter 특성입니다.

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

  • 변경 집합에서 수정됨

  • 결과 첨부 파일

  • 소스 코드 파일

  • 테스트 결과

  • 작업 항목 하이퍼링크

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

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

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

특성

설명

Scope

선택적 WorkItemTypeFilters 특성입니다.

Filter 요소 집합에서 제공하는 작업 항목 형식 집합에 적용되는 필터의 범위를 정의합니다. 유효한 값은 다음과 같습니다.

  • all: 링크를 Filter 요소에 지정된 모든 작업 항목 형식에 대해 만들 수 있도록 합니다.

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

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

FilterType

필수 WorkItemTypeFilters 특성입니다.

Filter 요소 집합에서 제공하는 링크 형식 집합을 필터링하는 데 사용되는 메서드를 정의합니다. 유효한 값은 다음과 같습니다.

  • exclude: Filter 요소에 나열된 작업 항목 형식을 허용하지 않습니다.

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

  • include: Filter 요소에 나열된 작업 항목 형식을 허용합니다.

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

WorkItemType

필수 Filter 특성입니다.

작업 항목 형식의 참조 이름을 지정합니다.

예제: 작업(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>

요소가 나열되는 순서에 따라 작업 항목 폼에 열 필드가 표시되는 순서가 정해집니다. 참조 이름 및 링크 특성 목록은 MSF 프로세스 템플릿에 정의된 필드 및 시스템 필드 사용을 참조하십시오. 다음 구문은 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 요소

개념

작업 항목 링크(Agile)

링크 형식 작업

작업 항목 폼 컨트롤 지정

변경 기록

날짜

변경 내용

이유

2010년 7월

ExternalLinkFilters 요소에 사용할 수 있는 전체 참조 이름 목록이 추가되었습니다. 이해를 돕기 위해 텍스트가 일부 수정되었습니다.

향상된 기능 관련 정보