다음을 통해 공유


FIELD(정의) 요소

업데이트: 2011년 1월

FIELD(정의) 요소를 사용하여 작업 항목 필드를 정의하고 필드에 적용할 규칙 및 조건을 지정합니다. 필드에 할당하는 특성은 작업 항목 폼에 나타나는 모양과 보고서에 포함할 수 있는지 여부를 결정합니다. 팀 프로젝트 컬렉션에 대한 필드 할당 집합을 관리합니다. 따라서 한 가지 형식의 작업 항목에 정의된 필드에 할당하는 특성은 컬렉션에 있는 모든 팀 프로젝트에 대한 모든 형식의 작업 항목 간에 일치해야 합니다. 또한 모든 컬렉션의 모든 보고 가능 필드가 데이터 웨어하우스 데이터베이스로 내보내집니다.

참고

상태 변경 또는 워크플로 전환 중에 필드에 대한 규칙과 조건을 지정하는 데 사용하는 FIELD(워크플로) 요소에 대한 자세한 내용은 FIELD(워크플로) 요소를 참조하십시오.

witadmin 명령 도구를 사용하여 컬렉션에 대한 기존 필드를 만드는 특성 할당을 변경할 수 있습니다. 자세한 내용은 작업 항목 필드 관리 [witadmin]을 참조하십시오.

스키마 계층 구조

WITD

   WORKITEMTYPE

      FIELDS

            FIELD

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" >
   <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>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성

설명

name

필수적 요소로서, 작업 항목 쿼리의 드롭다운 메뉴에 표시되는 필드의 이름입니다. 이름은 팀 프로젝트 내에 정의된 모든 필드 간에 고유해야 합니다. 또한 이름은 작업 항목 형식의 필드 옆에 나타나는 레이블과 다를 수 있습니다. 자세한 내용은 Control XML 요소 참조을 참조하십시오.

특성 형식은 typelib:FieldName입니다. 최소 길이: 1, 최대 길이: 128

패턴 값: ^[^\. \[\]]+$

패턴 값 예: Assigned To

refname

필수적 요소로서, 팀 프로젝트 컬렉션에 정의된 다른 모든 필드에서 한 필드를 구분하는 고유한 레이블입니다.

친화적인 이름 및 참조 이름에 대한 추가 요구 사항 및 제한 사항은작업 항목 추적 개체의 명명 규칙를 참조하십시오.

특성 형식은 typelib:ReferenceFieldName입니다. 최소 길이: 1, 최대 길이: 70

패턴 값: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

패턴 값 예: Company.IssueType

type

필수적 요소로서, 필드가 허용하는 데이터 형식을 지정합니다.

참고참고
reportingrefname 이 동일한 다른 프로젝트 컬렉션의 필드는 type에 대해 같은 값을 할당해야 합니다.값이 다른 경우 데이터 웨어하우스를 처리할 때 데이터 충돌이 발생할 수 있습니다.자세한 내용은 데이터 웨어하우스에서 발생하는 스키마 충돌 해결을 참조하십시오.

다음 표에서는 이 특성에 유효한 값을 보여 줍니다.

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

syncnamechanges

선택적 요소로서, Active Directory 또는 작업 그룹이 변경될 때 작업 항목 필드를 사용하여 업데이트할 이름을 저장할지 여부를 지정합니다. 이 옵션은 type="String"일 때만 유효합니다. 특성 형식은 xs:boolean입니다.

데이터 필드에 대한 동기화를 사용하도록 true를 지정하고 데이터 필드에 대한 동기화를 사용하지 않도록 false를 지정합니다.

reportable

선택적 요소로서, 필드의 데이터를 보고서에 포함할 것인지 지정합니다. None의 기본값이 있는 필드는 관계형 데이터 웨어하우스로 내보내거나 SQL Server Analysis Services 큐브를 처리하지도 않습니다. 보고 가능한 필드에 대한 자세한 내용은 보고를 지원하도록 작업 항목 필드 추가 및 수정를 참조하십시오.

참고참고
reportingrefname 에 대한 값이 동일한 다른 프로젝트 컬렉션의 필드는 reportable에 대해 같은 값을 할당해야 합니다.값이 다른 경우 데이터 웨어하우스를 처리할 때 데이터 충돌이 발생할 수 있습니다.자세한 내용은 데이터 웨어하우스에서 발생하는 스키마 충돌 해결을 참조하십시오.

다음 표에서는 이 특성에 유효한 값을 보여 줍니다.

Value 용도
Detail DateTime, Double, 정수 또는 문자열 형식의 필드는 지정할 수 있습니다. 이 필드의 데이터는 관계형 웨어하우스 데이터베이스의 Work Item과 Current Work Item 테이블에는 저장되지만 Analysis Services 큐브에는 저장되지 않습니다.이 형식은 큐브가 너무 커지지 않으면서 보고서에서 사용할 수 있으므로 제한이 없는 텍스트 필드에 사용할 수 있습니다.
Dimension DateTime, Double, 정수 또는 문자열 형식의 필드는 지정할 수 있습니다. 이 필드의 데이터는 보고서 필터링에 사용될 수 있도록 Work Item 차원의 한 특성으로 관계형 웨어하우스 데이터베이스와 Analysis Services 큐브에 저장됩니다.이 형식은 유효한 값 목록이 있는 필드에 사용합니다.dimension의 예로는 Work Item Type과 State가 있습니다.
Measure measure 형식은 Integer 및 Double 필드에만 사용합니다.측정값은 보고서의 숫자 값입니다.Analysis Services 큐브가 처리되면 reportable 특성을 측정하려고 설정한 필드에서 데이터가 미리 계산됩니다.예를 들어 Work Item 및 Current Work Item 측정값 그룹에는 Original Estimate, Remaining Hours 및 Completed Hours 필드에 대한 누적 데이터가 들어 있습니다.측정을 지정하면 formula 특성을 지정해야 합니다.
None 보고서에 포함시킬 필드를 사용하고 싶지 않을 때 None을 지정합니다.이것이 기본 할당입니다.

formula

선택적 요소로서, measure 보고 가능 형식에 대한 집계 형식입니다. 유일한 유효 값은 집합에 대한 모든 값의 합계를 반환하는 sum입니다.

reportingname

선택적 요소로서, 보고서에 나타나는 이름을 지정합니다. 값을 지정하지 않으면 name 특성에 할당된 값이 사용됩니다.

참고참고
reportingrefname 이 동일한 다른 프로젝트 컬렉션의 필드는 reportingname에 대해 같은 값을 할당해야 합니다.값이 다른 경우 데이터 웨어하우스를 처리할 때 데이터 충돌이 발생할 수 있습니다.자세한 내용은 데이터 웨어하우스에서 발생하는 스키마 충돌 해결을 참조하십시오.

특성 형식은 typelib:FieldName입니다. 최소 길이: 1, 최대 길이: 128

패턴 값: ^[^\. \[\]]+$

패턴 값 예: Assigned To

reportingrefname

선택적 요소로서, 보고 가능 필드를 처리할 때 사용되는 참조 이름을 지정합니다. 값을 지정하지 않으면 refname 특성에 할당된 값이 사용됩니다.

이 특성을 사용하여 데이터 웨어하우스로 처리되는 필드를 병합하거나 분기할 수 있습니다. 참조 이름이 다르고 다른 프로젝트 컬렉션에서 정의되는 두 필드를 병합하려면 두 필드에 같은 reportingrefname을 할당합니다. 참조 이름이 같지만 서로 다른 프로젝트 컬렉션에 정의되어 있는 두 필드를 분기하려면 각 필드에 서로 다른 reportingrefname을 할당합니다.

가능하면 두 필드를 병합하여 웨어하우스의 필드 수를 최소화하고 보고 가능 필드 수를 최대 제한인 1024개 미만으로 유지해야 합니다. 병합된 필드를 사용하여 그룹 간 보고서를 생성할 수 있습니다.

특성 형식은 typelib:ReferenceFieldName입니다. 최소 길이: 1, 최대 길이: 70

패턴 값: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

패턴 값 예: Company.IssueType

자식 요소

요소

설명

ALLOWEDVALUES

선택적 요소로서, 필드에 사용할 수 있는 값의 목록을 정의합니다. 작업 항목 폼과 쿼리 작성기의 필드 목록에서 선택 가능한 값만 허용됩니다. 이러한 값 중 하나를 선택해야 합니다.

ALLOWEXISTINGVALUE

선택적 요소로서, 기존 값을 허용하도록 필드를 정의합니다. 이 요소는 유효하지 않더라도 이미 있는 필드 값을 사용하는 것을 허용합니다. 모든 새 필드 값은 유효해야 합니다.

CANNOTLOSEVALUE

선택적 요소로서, 필드를 비워 둘 수 없는 필드로 정의합니다. 이 요소는 현재 필드 값을 유지하며 삭제하거나 비울 수 없습니다.

COPY

선택적 요소로서, 현재 필드에 복사할 값이 들어 있는 다른 필드를 지정합니다.

DEFAULT

선택적 요소로서, 필드의 기본값을 정의합니다.

EMPTY

선택적 요소로서, 필드를 비어 있는 상태로 정의합니다.

FROZEN

선택적 요소로서, 필드를 고정 필드로 정의합니다. 고정 필드는 변경 내용을 커밋한 후 빈 값으로 변경할 수 없습니다. 그러나 수동으로 필드를 지우고 작업 항목을 저장한 다음 다른 값을 지정할 수 있습니다.

HELPTEXT

선택적 요소로서, 필드의 도구 설명에 표시되는 텍스트를 정의합니다.

MATCH

선택적 요소로서, 필드 값과 일치해야 할 필드 패턴을 정의합니다.

NOTSAMEAS

선택적 요소로서, 해당 값이 현재 필드의 값과 동일하지 않은 다른 필드를 지정합니다.

PROHIBITEDVALUES

선택적 요소로서, 필드에 사용할 수 없는 값의 목록을 정의합니다.

READONLY

선택적 요소로서, 필드를 읽기 전용으로 정의합니다.

REQUIRED

선택적 요소로서, 필드를 필수 필드로 정의합니다.

SERVERDEFAULT

선택적 요소로서, 필드 값을 제공할 서버 구성 요소를 지정합니다.

SUGGESTEDVALUES

선택적 요소로서, 필드에 제안되는 값의 목록을 정의합니다. 제안 값은 작업 항목 폼과 쿼리 작성기의 필드 목록에서 선택 가능한 값입니다. 목록의 값뿐만 아니라 다른 값도 입력할 수 있습니다.

VALIDUSER

선택적 요소로서, 허용된 값의 목록이 시스템의 유효한 사용자로만 구성되도록 지정합니다.

WHEN

선택적 요소로서, 다른 필드에 특정 값이 있는 경우 현재 필드에 적용할 하나 이상의 규칙을 지정합니다.

WHENCHANGED

선택적 요소로서, 특정 필드의 값이 변경될 경우 현재 필드에 하나 이상의 규칙을 적용합니다.

WHENNOT

선택적 요소로서, 다른 필드에 특정 값이 없을 경우 현재 필드에 하나 이상의 규칙을 적용합니다.

WHENNOTCHANGED

선택적 요소로서, 특정 필드의 값이 변경되지 않은 경우 현재 필드에 하나 이상의 규칙을 적용합니다.

부모 요소

요소

설명

FIELDS

필수적 요소로서, 작업 항목 형식 필드 정의를 포함합니다.

설명

FIELD(정의)는 FIELDS(정의)의 필수 자식 요소입니다.

minOccurs="1"

같은 팀 프로젝트 컬렉션에 1,024개 미만의 작업 항목 필드를 정의할 수 있으며 모든 팀 프로젝트 컬렉션에서 1,024개 미만의 필드를 보고 가능으로 설정할 수 있습니다. 자세한 내용은 보고를 지원하도록 작업 항목 필드 추가 및 수정을 참조하십시오.

참고

기존 필드를 작업 항목의 다른 형식에 추가하면 보고 가능 특성의 현재 값이 사용됩니다.

필드 친화적인 이름 및 참조 이름에 대한 추가 요구 사항 및 제한 사항은작업 항목 추적 개체의 명명 규칙를 참조하십시오. 보고 목적으로 필드에 레이블을 사용하는 방법에 대한 자세한 내용은 보고를 지원하도록 작업 항목 필드 추가 및 수정을 참조하십시오.

System. 접두사로 시작하는 사용자 지정 필드를 정의할 수 없습니다. Microsoft. 접두사를 사용하여 필드를 정의할 수 있습니다. 그러나 이 방법은 Team Foundation Server 기능을 방해할 수 있기 때문에 이 방법은 사용하지 않는 것이 좋습니다.

필드 작업 항목 추적 개체의 개요는 작업 항목 필드 사용를 참조하십시오.

MSF(Microsoft Solutions Framework) for Agile Software Development v5.0 프로세스 템플릿에 대해 정의되는 모든 시스템 필드 및 미리 정의된 필드에 대한 개요는 MSF 프로세스 템플릿에 정의된 필드 및 시스템 필드 사용을 참조하십시오.

필드 참조 이름은 바꿀 수 없습니다. witadmin 명령줄 도구를 사용하여 필드를 나열하고 필드에 익숙한 이름을 변경하고 필드 특성을 변경할 수 있습니다. 자세한 내용은 작업 항목 필드 관리 [witadmin]을 참조하십시오.

팀 프로젝트 컬렉션을 통해 필드를 사용하는 방법에 대한 자세한 내용은 데이터 웨어하우스에서 발생하는 스키마 충돌 해결보고를 지원하도록 작업 항목 필드 추가 및 수정을 참조하십시오.

예제

<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
   <HELPTEXT>Type of work involved</HELPTEXT>
   <SUGGESTEDVALUES>
      <LISTITEM value="Development"/>
      <LISTITEM value="Testing"/>
      <LISTITEM value="Requirements"/>
      <LISTITEM value="Design"/>
      <LISTITEM value="Deployment"/>
      <LISTITEM value="Documentation"/>
   </SUGGESTEDVALUES>
</FIELD>

참고 항목

참조

작업 항목 필드 관리 [witadmin]

개념

작업 항목 추적 개체의 명명 규칙

MSF 프로세스 템플릿에 정의된 필드 및 시스템 필드 사용

프로젝트 추적 데이터, 폼, 워크플로 및 기타 개체 사용자 지정

작업 항목 필드 사용

기타 리소스

작업 항목 형식에 대한 XML 요소 정의의 인덱스

변경 기록

날짜

변경 내용

이유

2011년 1월

내용을 간소화하고 제거된 항목에 대한 링크가 제거되었습니다.

향상된 기능 관련 정보