FIELD(정의) 요소 참조
FIELD(정의) 요소를 사용하여 작업 항목 필드를 정의하고 필드에 적용할 규칙 및 조건을 지정합니다. 필드에 할당하는 특성에 따라 해당 데이터 형식과 보고서에 포함할 수 있는지 여부가 결정됩니다.
참고
상태 변경 또는 워크플로 전환 중에 필드에 대한 규칙과 조건을 지정하는 데 사용하는 FIELD(워크플로) 요소에 대한 자세한 내용은 FIELD(워크플로) 요소를 참조하십시오.
스키마 계층 구조
FIELD
<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에 대해 같은 값이 할당되어야 합니다.값이 다른 경우 데이터 웨어하우스를 처리할 때 데이터 충돌이 발생할 수 있습니다.자세한 내용은 데이터 웨어하우스에서 발생하는 스키마 충돌 해결을 참조하십시오. 다음 표에서는 이 특성에 유효한 값을 보여 줍니다.
|
||||||||||||||||||||
syncnamechanges |
선택 사항입니다. Active Directory 또는 작업 그룹이 변경될 때 작업 항목 필드를 사용하여 업데이트할 이름을 저장할지 여부를 지정합니다. 이 옵션은 type="String"인 경우에만 유효합니다. 특성 형식은 xs:boolean입니다. 데이터 필드에 동기화를 사용하려면 true를 지정하고, 데이터 필드에 동기화를 사용하지 않으려면 false를 지정합니다. |
||||||||||||||||||||
reportable |
선택 사항입니다. 필드의 데이터를 보고서에 포함할 수 있는지 여부를 지정합니다. 기본값 None이 포함된 필드는 관계형 데이터 웨어하우스로 내보내지거나 SQL Server Analysis Services 큐브에 대해 처리되지 않습니다. 보고 가능한 필드에 대한 자세한 내용은 보고를 지원하도록 작업 항목 필드 추가 또는 수정을 참조하십시오. 참고 reportingrefname의 값이 동일한 다른 프로젝트 컬렉션의 필드는 reportable에 대해 같은 값이 할당되어야 합니다.값이 다른 경우 데이터 웨어하우스를 처리할 때 데이터 충돌이 발생할 수 있습니다.자세한 내용은 데이터 웨어하우스에서 발생하는 스키마 충돌 해결을 참조하십시오. 다음 표에서는 이 특성에 유효한 값을 보여 줍니다.
|
||||||||||||||||||||
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 |
자식 요소
요소 |
설명 |
|---|---|
선택 사항입니다. 필드에 대해 허용 값 목록을 정의합니다. 작업 항목 폼과 쿼리 작성기의 필드 목록에서 선택 가능한 값만 허용됩니다. 이러한 값 중 하나를 선택해야 합니다. |
|
선택 사항입니다. 기존 값을 허용하도록 필드를 정의합니다. 이 요소는 유효하지 않더라도 이미 있는 필드 값을 사용할 수 있도록 허용합니다. 새 필드 값은 모두 유효해야 합니다. |
|
선택 사항입니다. 필드를 비워 둘 수 없는 필드로 정의합니다. 이 요소는 현재 필드 값을 유지하며 지우거나 비워 둘 수 없습니다. |
|
선택 사항입니다. 현재 필드에 복사할 값이 들어 있는 다른 필드를 지정합니다. |
|
선택 사항입니다. 필드의 기본값을 정의합니다. |
|
선택 사항입니다. 필드를 비어 있는 필드로 정의합니다. |
|
선택 사항입니다. 필드를 고정 필드로 정의합니다. 고정 필드는 변경 내용을 커밋한 후 비어 있지 않은 값으로 변경할 수 없습니다. 그러나 수동으로 필드를 지우고 작업 항목을 저장한 후 다른 값을 지정할 수 있습니다. |
|
선택 사항입니다. 필드의 도구 설명에 표시되는 텍스트를 정의합니다. |
|
선택 사항입니다. 필드 값과 일치해야 하는 필드 패턴을 정의합니다. |
|
선택 사항입니다. 해당 값이 현재 필드의 값과 일치할 수 없는 다른 필드를 지정합니다. |
|
선택 사항입니다. 필드에 사용할 수 없는 값 목록을 정의합니다. |
|
선택 사항입니다. 필드를 읽기 전용 필드로 정의합니다. |
|
선택 사항입니다. 필드를 필수 필드로 정의합니다. |
|
선택 사항입니다. 필드 값을 제공할 서버 구성 요소를 지정합니다. |
|
선택 사항입니다. 필드에 제안되는 값 목록을 정의합니다. 작업 항목 폼과 쿼리 작성기의 필드 목록에서 선택 가능한 값이 제안됩니다. 목록의 값뿐 아니라 다른 값도 입력할 수 있습니다. |
|
선택 사항입니다. 허용 값 목록이 시스템의 유효한 사용자로만 구성되도록 지정합니다. |
|
선택 사항입니다. 다른 필드에 특정 값이 있는 경우 현재 필드에 적용할 하나 이상의 규칙을 지정합니다. |
|
선택 사항입니다. 특정 필드의 값이 변경될 경우 현재 필드에 하나 이상의 규칙을 적용합니다. |
|
선택 사항입니다. 다른 필드에 특정 값이 없을 경우 현재 필드에 하나 이상의 규칙을 적용합니다. |
|
선택 사항입니다. 특정 필드의 값이 변경되지 않은 경우 현재 필드에 하나 이상의 규칙을 적용합니다. |
부모 요소
요소 |
설명 |
|---|---|
필수 요소. 작업 항목 형식 필드 정의를 포함합니다. |
설명
FIELD(정의)는 FIELDS(정의)의 필수 자식 요소입니다.
TFS 프로세스 템플릿에 대해 정의되는 모든 시스템 필드 및 미리 정의된 필드의 개요는 Visual Studio ALM의 작업 항목 필드 참조을 참조하십시오.
System. 접두사로 시작하는 사용자 지정 필드를 정의할 수 없습니다. Microsoft. 접두사를 사용하여 필드를 정의할 수 있습니다. 그러나 Team Foundation Server 기능을 방해할 수 있기 때문에 이 방법은 사용하지 않는 것이 좋습니다.
필드 이름과 참조 이름에 대한 추가 요구 사항 및 제한 사항은작업 항목 추적 개체의 명명 규칙을 참조하십시오.
필드의 이름은 바꿀 수 있지만 필드의 참조 이름은 바꿀 수 없습니다. witadmin 명령줄 도구를 사용하여 필드를 나열하고 여러 필드 특성을 변경할 수 있습니다. 작업 항목 필드 관리[witadmin]를 참조하세요.
같은 팀 프로젝트 컬렉션에 1,024개 이하의 작업 항목 필드를 정의할 수 있으며 모든 팀 프로젝트 컬렉션에서 1,024개 이하의 필드를 보고 가능으로 설정할 수 있습니다.
프로젝트 컬렉션에 대해 정의된 모든 팀 프로젝트의 모든 WIT(작업 항목 형식) 내에 있는 필드는 모두 팀 프로젝트 컬렉션에 대해 정의됩니다. 따라서 하나의 WIT에 정의된 필드에 할당한 특성은 컬렉션의 모든 팀 프로젝트에 대한 모든 WIT에서 일치해야 합니다. 또한 모든 컬렉션의 모든 보고 가능 필드가 데이터 웨어하우스 데이터베이스로 내보내집니다.
보고 목적으로 필드에 레이블을 지정하는 방법에 대한 자세한 내용은 보고를 지원하도록 작업 항목 필드 추가 또는 수정을 참조하십시오.
다른 WIT에 기존 필드를 추가하는 경우 보고 특성을 현재 필드 정의와 동일하게 명시적으로 설정하거나 보고 특성이 기본적으로 이러한 값으로 설정되도록 허용해야 합니다.
여러 WIT의 동일한 필드 또는 여러 팀 프로젝트의 동일한 WIT에 서로 다른 보고 특성이 할당된 경우 스키마 충돌이 발생할 수 있습니다. 이러한 충돌을 해결하려면 데이터 웨어하우스에서 발생하는 스키마 충돌 해결을 참조하세요.
필드를 사용하여 쿼리, 보고서 및 작업 항목 추적을 지원하는 방법을 이해하려면 쿼리, 보고서 및 워크플로를 지원하도록 필드 수정 또는 추가를 참조하세요.
자식 요소를 사용하여 FIELD에 대한 조건 또는 제약 조건을 적용하는 방법에 대한 개요는 작업 항목 필드에 규칙 적용을 참조하세요.
예제
<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>
참고 항목
참조
개념
Visual Studio ALM의 작업 항목 필드 참조