작업 항목 필드 사용

작업 항목 형식에 대한 데이터를 추적하고 쿼리에 대한 필터 조건을 정의하고 보고서를 생성하는 데 작업 항목을 사용합니다.핵심 시스템 데이터 필드를 제외한 모든 데이터 요소 Team Foundation Server (TFS) 추적 하거나, 워크플로 정의 하려면 사용 하거나 작업 항목 형식 작업 항목 필드로 정의 되어야 합니다 폼에 표시 하려는 경우.작업 항목 형식 또는 전역 워크플로 정의 내에서 작업 항목 필드를 정의할 수 있습니다.

작업 항목 필드는 팀 프로젝트 컬렉션을 위해 유지 관리할 수 있습니다.다음 작업 중 하나를 수행할 때 필드를 추가합니다.

• 팀 프로젝트를 만듭니다.작업 항목 형식 또는 전역 워크플로에 대한 정의 내에서 정의된 모든 필드 및 선택한 프로세스 템플릿에 대해 정의된 모든 필드가 만들어집니다.핵심 시스템 필드는 팀 프로젝트에 대해 정의된 모든 작업 항목 형식에 대해 자동으로 정의됩니다.이러한 필드의 목록을 보려면 Visual Studio ALM에 대한 작업 항목 필드 참조을 참조하십시오.

• 작업 항목 형식에 대한 정의 가져올.작업 항목 형식에 대한 정의 내에 정의된 모든 새 필드가 컬렉션에 추가됩니다.자세한 내용은 모든 WITD XML 요소 참조을 참조하십시오.

• 전역 워크플로 정의 가져오기.전역 워크플로 내에 정의된 모든 새 필드가 컬렉션에 추가됩니다.여러 작업 항목 형식이 공유하는 작업 항목 필드 집합을 유지 관리하려는 경우 전역 워크플로를 정의합니다.자세한 내용은 전역 워크플로 사용자 지정을 참조하십시오.

• 프로젝트 컬렉션에 프로젝트 웹 응용 프로그램 (PWA)의 인스턴스를 매핑할.설치 후에 Team Foundation Server Project Server에 대한 확장을 통합 구성의 다양 한 구성 요소를 매핑하여 Team Foundation.컬렉션을 매핑하면 Project Server 필드에서 여러 필드를 지원하는 전역 워크플로 정의를 가져옵니다.자세한 내용은 데이터 동기화를 지원하기 위해 추가된 Project Server 필드을 참조하십시오.

모든 작업 항목 형식에 정의된 모든 필드 및 모든 팀 프로젝트에 대한 모든 전역 워크플로는 컬렉션에 대해 정의된 전체 필드 집합을 구성합니다.기존 필드의 특성을 변경하고 이름을 바꾸고 삭제할 수 있습니다.하지만 이러한 항목을 변경하면 특정 비용이 발생하게 됩니다.자세한 내용은 프로젝트 추적 데이터, 폼, 워크플로 및 기타 개체 사용자 지정을 참조하십시오.

추가 또는 컬렉션에 대한 필드를 사용자 지정 하려면 전역 워크플로 또는 작업 항목 형식 정의 대 한 XML 콘텐츠를 수정 합니다.각 필드를 통해 정의 하는 FIELD 요소 내에서 FIELDS 섹션에 작업 항목 형식 또는 전역 워크플로에 대한 정의.이러한 파일의 구조 및 필드에 대한 자세한 내용은 모든 WITD XML 요소 참조 및 전역 워크플로 사용자 지정을 참조하십시오.

항목 내용

• FIELD(정의) 구문 구조

• 필드 데이터 형식

• 필드에 할당된 보고 가능한 특성

• 인덱싱된 필드

• FIELD(정의) 자식 요소

• 시스템 필드 및 미리 정의된 필드

FIELD(정의) 구문 구조

각 FIELD(정의) 요소에는 선택 항목인 이름과 필수 항목인 참조 이름이 있습니다.참조 이름은 컬렉션 내에서 고유해야 합니다.자세한 내용은 작업 항목 추적 개체의 명명 규칙을 참조하십시오.

중요
witadmin changefield 명령줄 도구를 사용하여 필드에 대한 이름을 변경할 수 있습니다.하지만 필드 이름을 바꾸면 해당 컬렉션 내의 모든 팀 프로젝트에서 모든 작업 항목 형식에 영향을 줍니다.

작업 항목 형식 정의 파일에서 다음 XML 구문으로 필드를 정의 합니다.

<FIELD name="fieldDisplayName"
   refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID"
   syncnamechanges="true | false"
   reportingname="reportingDisplayName"
   reportingrefname="reportingReferenceName"
   reportable="Dimension | Detail | Measure" 
   formula="sum" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

자세한 내용은 FIELD(정의) 요소을 참조하십시오.

맨 위로 이동

필드 데이터 형식

필드 형식은 필드에 저장할 수 있는 데이터의 유형과 크기를 정의합니다.필드는 팀 프로젝트 컬렉션에서 정의 된 형식 중 하나만 가질 수 있습니다.이 제한 사항 때문에 조직에서 모든 프로젝트 및 작업 항목 형식에 대해 공통 필드를 사용합니다.

다음 목록에서는 지원되는 필드 형식을 보여 줍니다.

데이터 형식	설명
DateTime	UTC(Coordinated Universal Time) 시간에 따라 날짜를 지정합니다. 추가 된 DateTime 필드를 사용 하 여 작업 항목 폼의 FieldControl 또는 DateTimeControltype 특성.
Double	부동 소수점 값을 지정합니다.이 필드는 대개 쿼리 필터와 결과 목록에 사용됩니다. 추가 된 Double 필드를 사용 하 여 작업 항목 폼의 FieldControltype 특성.
GUID	고유 식별자가 포함될 필드를 지정합니다. GUID 필드는 작업 항목 폼에 추가할 수 없습니다.
History	토론 스레드 보기 및 기타 기록 정보 추적을 지원합니다. 참고 System.History 필드는 이 데이터 형식을 사용하는 유일한 필드입니다.이 데이터 형식을 사용하여 사용자 지정 필드를 정의할 수 없습니다. 추가 된 System.History 필드를 사용 하 여 작업 항목 폼의 WorkItemLogControltype 컨트롤, 서식 있는 텍스트 서식 지정을 지 원하는 특성.
HTML	서식 있는 데이터를 캡처하고 작업 항목 설명과 같은 긴 텍스트 설명을 사용할 수 있는 기능을 지원합니다.HTML 필드는 정보를 다양하게 표시할 수 있기 때문에 HTML에 적합하다는 점에서 PlainText 필드와는 다릅니다. 추가 된 HTML 필드를 사용 하 여 작업 항목 폼의 HTMLControltype 컨트롤, 서식 있는 텍스트 서식 지정을 지 원하는 특성을.
Integer	부호 있는 32비트 정수 값을 지정합니다.이 필드는 대개 쿼리 필터와 결과 목록에 사용됩니다. 추가 된 Integer 필드를 사용 하 여 작업 항목 폼의 FieldControltype 특성.
PlainText	255자 이상의 유니코드 문자가 포함될 수 있는 텍스트 문자열의 입력을 지원합니다. 추가 된 PlainText 필드를 사용 하 여 작업 항목 폼의 FieldControl type 특성과 일반 텍스트로 제한 또는 HTMLControltype 컨트롤, 서식 있는 텍스트 서식 지정을 지 원하는 특성.
String	최대 255자의 유니코드 문자가 포함될 수 있는 텍스트 문자열의 입력을 지원합니다.최대 한 줄 길이까지 레이블 또는 기타 짧은 텍스트 문자열에 대해 String 필드를 사용합니다.String 필드는 대개 쿼리 필터와 결과 목록에 사용됩니다. 추가 된 String 필드를 사용 하 여 작업 항목 폼의 FieldControltype 특성.
TreePath	제품에 대한 영역 및 반복 경로 표시 요구 사항과 같이 항목을 계층적 또는 트리 구조로 표시하는 필드를 지정합니다. 참고 System.AreaPath 및 System.IterationPath 필드는 이 데이터 형식을 사용하는 유일한 필드입니다.이 데이터 형식을 사용하여 사용자 지정 필드를 정의할 수 없습니다. 추가 된 System.AreaPath 및 System.IterationPath 필드를 작업 항목 폼을 사용 하 여은 WorkItemClassificationControl type 특성.

맨 위로 이동

필드에 할당된 보고 가능한 특성

일부 필드 값은 보고 목적으로 사용될 때 특히 유용합니다.작업 항목 형식 정의 언어를 사용하면 다음과 같은 선택적 특성을 지정할 수 있습니다.

• reportable.Reportable 특성을 설정 None, Detail, Dimension, 또는 Measure여부 및 방법을 보고서에 포함 될 필드를 따라.이 특성 값이 None이 아닌 필드의 데이터가 데이터 웨어하우스로 내보내지며 보고서에 포함될 수 있습니다.

  기존 필드를 작업 항목 형식에 추가할 때 reportable 특성의 현재 값이 사용됩니다.필드를 작업 항목 형식에 추가할 때 reportable 특성을 사용하여 명시적으로 보고 기능을 지정하지 않으면 보고 기능이 해제됩니다.

• reportingname.다른 레이블에서 데이터를 보고서에 표시 되는 필드에 할당 합니다.값을 지정하지 않으면 name 특성에 대해 할당된 이름이 사용됩니다.

• reportingrefname.관계형 데이터 웨어하우스 데이터를 내보낼 때 사용 되는 필드에 다른 참조 이름을 할당 합니다.값을 지정하지 않으면 refname 특성에 할당된 값이 사용됩니다.

  이 특성을 사용 하 여 병합 하거나 보고서에 포함 된 필드를 분기할 수 있습니다.서로 다른 프로젝트 컬렉션에 정의되어 있고 고유한 참조 이름을 가진 두 필드를 병합하려면 두 필드에 동일한 reportingrefname을 할당해야 합니다.참조 이름이 같고 서로 다른 프로젝트 컬렉션에 정의되어 있는 두 필드를 분기하려면 각 필드에 서로 다른 reportingrefname을 할당합니다.

필드를 정의한 후에 명령 프롬프트에서 witadmin changefield 명령을 사용하여 refname 특성을 제외한 모든 특성의 값을 변경할 수 있습니다.

보고를 위한 최선의 필드 레이블 지정 방법에 대한 자세한 내용은 보고를 지원하도록 작업 항목 필드 추가 및 수정을 참조하십시오.

맨 위로 이동

Reportable 특성 값

다음 표의 설명과 같이 reportable 특성에 none, dimension, detail 및, measure 값 중 하나를 할당할 수 있습니다.

[!참고]

필드가 작업 항목에 사용된 후에 필드를 보고 가능 필드로 만들 수 있습니다.Reportable 값을 설정하면 웨어하우스에 새로 복사되는 작업 항목의 수정 버전에 이 필드 값이 포함됩니다.그러나 웨어하우스에 이미 있는 수정 버전의 경우 기존 값이 포함되지 않습니다.

특성 값	설명
Detail	Detail 형식은 Integer, Double, String 또는 DateTime 필드에만 사용합니다. 이 필드의 데이터는 관계형 웨어하우스 데이터베이스의 Work Item 및 Current Work Item 테이블로 이동되지만 SQL Server Analysis Services 큐브로는 이동되지 않습니다.제한이 없는 텍스트 필드에 대해 이 형식을 사용하면 보고서에 이러한 필드를 사용해도 큐브가 과도하게 커지지 않습니다.
Dimension	Dimension 형식은 Integer, Double, String 또는 DateTime 필드에만 사용합니다. 이 필드의 데이터는 보고서 필터링에 사용될 수 있도록 Work Item 차원의 한 특성으로 관계형 웨어하우스 데이터베이스와 Analysis Services 큐브에 저장됩니다.이 형식은 유효한 값 목록이 있는 필드에 사용합니다.dimension의 예로는 Work Item Type과 State가 있습니다.
Measure	Measure 형식은 Integer 및 Double 필드에만 사용합니다.측정값은 보고서의 숫자 값입니다. Analysis Services 큐브가 처리되는 동안 Measure로 설정된 필드에서 데이터가 미리 계산됩니다.예를 들어 Work Item 및 Current Work Item 측정값 그룹에는 Original Estimate, Remaining Hours 및 Completed Hours 필드에 대한 누적 데이터가 들어 있습니다.측정값 그룹에 대한 자세한 내용은 Team System의 Analysis Services 큐브에 제공된 측정값 그룹 및 큐브 뷰을 참조하십시오. Measure를 지정할 때 쿼리에서 참조하는 각 측정값의 합계를 반환하는 formula 특성에 대한 sum을 지정해야 합니다.
None	보고서에 필드를 포함하지 않으려면 None을 지정합니다.이 값이 기본 할당 값입니다.

맨 위로 이동

보고 기능을 지정하는 방법을 보여주는 예제

Detail 예제

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Dimension 예제

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Measure 예제

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

인덱싱된 필드

witadmin indexfield 명령을 사용하여 작업 항목 필드에 대한 인덱싱을 사용하거나 사용하지 않도록 설정할 수 있습니다.필드에 대한 인덱싱을 사용하도록 설정하면 해당 필드를 지정하는 쿼리가 있는 작업 항목의 찾기 성능을 향상시킬 수 있습니다.여러 작업 항목 쿼리에서 사용하는 사용자 지정 필드를 추가하는 경우 해당 필드에 대한 인덱싱을 사용할 수 있도록 설정할 수도 있습니다.자세한 내용은 작업 항목 필드 관리[witadmin]을 참조하십시오.

맨 위로 이동

FIELD(정의) 자식 요소

작업 항목 필드에 대해 지정할 수 있는 여러 가지 선택적 자식 요소가 있습니다. 예를 들면 다음과 같습니다.

• 도움말 텍스트.작업 항목 폼(HELPTEXT)의 필드에 표시되는 도구 설명 또는 도움말 정보를 정의합니다.

• 필드 제한.필드를 필수 필드, 읽기 전용 필드, 빈 필드, 고정 필드 또는 특정 패턴과 일치하는 필드(REQUIRED, READONLY, EMPTY, FROZEN, MATCH)로 지정합니다.

• 필드 값 자동 채우기.필드의 값(DEFAULT, COPY, SERVERDEFAULT)을 지정합니다.

• 필드 목록.허용된 값, 제안된 값 및 허용되지 않는 값을 지정합니다.(ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• 필드 조건.다른 필드가 변경되거나 변경되지 않을 때, 다른 필드에 특정 값이 있거나 없을 때 필드에 하나 이상의 규칙을 적용하거나, 다른 조건(WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS)을 적용합니다.

자세한 내용은 모든 FIELD XML 요소 참조을 참조하십시오.

맨 위로 이동

시스템 필드 및 미리 정의된 필드

시스템에서 정의한 모든 필드에는 System으로 시작하는 이름(예: System.AreaPath, System.AssignedTo)이 있으며 계속해서 이 패턴으로 이름이 지정됩니다.

TFS 제공은 기본 프로세스 템플릿에 정의 된 미리 정의 된 필드 Microsoft.vsts로 시작 하 고 자세한 용도에 따라 달라 집니다.일정을 계획하고 Microsoft Project, Team Foundation Build 및 Team Foundation과의 통합을 위해 공통적으로 사용되는 미리 정의된 필드의 예는 다음과 같습니다.

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

모든 시스템 및 TFS에서 제공 하는 기본 프로세스 템플릿에 대해 정의 되며 미리 정의 된 필드에 대한 개요를 참조 하십시오. Visual Studio ALM에 대한 작업 항목 필드 참조.필드 이름 지정에 대한 자세한 내용은 작업 항목 추적 개체의 명명 규칙을 참조하십시오.

맨 위로 이동

숨김 및 변경할 수 없는 특성 및 작업 항목 필드 탐색기

작업 항목 필드를 변경할 수 있습니다 특성은 변경할 수 없는 및 사실상 숨겨진 특성 각 필드에 대한 여러 가지가 있습니다.작업 항목 필드 탐색기 도구를 사용 하 여 이러한 필드의 할당을 찾을 수 있습니다.프로세스 편집기 강력한 도구인 작업 항목 필드 탐색기 액세스 합니다.

작업 항목 필드 탐색기

[!참고]

프로세스 편집기 강력한 도구인 Team Foundation Server 프로세스 템플릿 사용자 지정에 대한 그래픽 사용자 인터페이스를 제공 합니다.이 도구를 사용 하면 가져온 작업 항목 형식 내보내기, 프로세스 템플릿의 내용을 수정 하 고 팀 프로젝트 컬렉션에 대해 정의 된 필드 집합을 탐색할 수 있습니다.에 대한 자세한 내용은 Microsoft 웹 사이트에서 다음 페이지를 참조 하십시오: Team Foundation Server Power Tool.

참고 항목

참조

작업 항목 필드 관리[witadmin]

개념

작업 항목 추적 및 팀 프로젝트 사용자 지정

보고를 지원하도록 작업 항목 필드 추가 및 수정

모든 FIELD XML 요소 참조

기타 리소스

작업 항목 필드 정의