작업 항목 필드 정의 및 수정

아티클
06/09/2015

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

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

팀 프로젝트를 만듭니다. 작업 항목 형식 또는 전역 워크플로에 대한 정의 내에서 정의된 모든 필드 및 선택한 프로세스 템플릿에 대해 정의된 모든 필드가 만들어집니다. 핵심 시스템 필드는 팀 프로젝트에 대해 정의된 모든 작업 항목 형식에 대해 자동으로 정의됩니다. 이러한 필드의 목록을 보려면 Visual Studio ALM의 작업 항목 필드 참조을 참조하십시오.
작업 항목 형식 정의를 가져옵니다. 작업 항목 형식에 대한 정의 내에 정의된 모든 새 필드가 컬렉션에 추가됩니다. 자세한 내용은 모든 WITD XML 요소 참조을 참조하십시오.
전역 워크플로 정의를 가져옵니다. 전역 워크플로 내에 정의된 모든 새 필드가 컬렉션에 추가됩니다. 여러 작업 항목 형식이 공유하는 작업 항목 필드 집합을 유지 관리하려는 경우 전역 워크플로를 정의합니다. 자세한 내용은 전역 워크플로 사용자 지정을 참조하십시오.
프로젝트 컬렉션을 PWA(Project Web App) 인스턴스에 매핑합니다. Project Server용 Team Foundation Server 확장을 설치한 후 Team Foundation의 여러 구성 요소를 매핑하여 통합을 구성합니다. 컬렉션을 매핑하면 Project Server 필드에서 여러 필드를 지원하는 전역 워크플로 정의를 가져옵니다. 자세한 내용은 데이터 동기화를 지원하기 위해 TFS에 추가된 Project Server 필드을 참조하십시오.

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

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

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

Reportable 특성

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

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 형식은 정수, 문자열 또는 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 필드에 대한 누적 데이터가 들어 있습니다. 측정값 그룹에 대한 자세한 내용은 Visual Studio의 Analysis Services 큐브에 제공된 측정값 그룹 및 큐브 뷰을 참조하십시오. Measure를 지정할 때 쿼리에서 참조하는 각 측정값의 합계를 반환하는 sum 특성에 대한 formula을 지정해야 합니다.
None	보고서에 필드를 포함하지 않으려면 None을 지정합니다. 이 값이 기본 할당 값입니다.

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

Detail 예제

Dimension 예제

Measure 예제

인덱싱된 필드

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 Tools 페이지를 참조하십시오.

참고 항목

다음을 통해 공유