이 항목을 사용하여 FIELD 요소의 구문 또는 해당 하위 요소 중 하나의 구문을 조회할 수 있습니다.
이러한 요소는 FIELD(정의) 요소 컨테이너에서 지정합니다. FIELD(정의) 요소 내에서 FIELDS(정의) 요소를 지정하여 WIT(작업 항목 형식)에 대한 필드를 추가합니다. 이러한 요소를 WIT 정의 내에서 지정하거나 전역 워크플로의 일부로 지정할 수 있습니다.
하위 요소를 추가하여 필드의 동작을 지정하거나, 기본값을 정의하거나, 값의 선택 목록을 정의할 수 있습니다. 필드 규칙 요소를 조합하여 사용할 수 있습니다. 대부분의 규칙에 대해 하나 이상의 사용자 또는 그룹에 적용되거나 하나 이상의 사용자 또는 그룹에 대해 무시되도록 범위를 지정할 수 있습니다.
다음 구문을 사용하여 작업 항목 형식의 데이터 필드를 정의할 수 있습니다. 이 예제에서는 FIELD(정의) 요소의 형식과 모든 선택적 자식 요소의 형식을 보여 줍니다. 자세한 내용은 FIELD(정의) 요소 참조를 참조하세요.
<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="avg" > <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>
하위 요소를 사용하여 필드에 입력할 수 있는 데이터에 대한 여러 가지 제한을 설정할 수 있습니다. 선택 목록(드롭다운 메뉴)의 값을 지정하거나, 기본값을 설정하거나, 항목을 지우거나, 변경을 제한할 수 있습니다. 다음 표에는 각 하위 요소의 구문 구조가 나와 있습니다.
이러한 요소를 사용하는 방법은 작업 항목 필드에 규칙 적용을 참조하세요. 제한 사항은 대부분의 규칙을 시스템 필드에 적용하는 데 존재합니다.모든 하위 요소는 선택 사항입니다.
|
요소 |
설명 및 구문 |
||
|---|---|---|---|
|
ALLOWEDVALUES |
작업 항목 폼 및 쿼리 편집기에서 사용자가 필드 목록에 지정할 수 있는 값 목록을 정의합니다. 사용자는 나열된 값 중 하나를 지정해야 합니다. <ALLOWEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups"> <GLOBALLIST name="globalListName"> <LISTITEM value="Name" /> . . . </GLOBALLIST> </ALLOWEDVALUES> 자세한 내용은 선택 목록 정의을 참조하세요. |
||
|
ALLOWEXISTINGVALUE |
해당 값이 선택 목록에 더 이상 없는 경우에도 필드에서 기존 값을 유지할 수 있도록 지정합니다. 모든 새 필드 값이 목록에 있어야 합니다. <ALLOWEXISTINGVALUE /> 자세한 내용은 선택 목록 정의을 참조하세요. |
||
|
CANNOTLOSEVALUE |
하나의 값이 지정된 후 사용자가 모든 값의 필드를 지울 수 없도록 지정합니다. 필드에 값이 포함된 후 해당 필드는 항상 NULL이 아닌 값을 포함해야 합니다. <CANNOTLOSEVALUE for="userGroupName" not="userGroupName" /> 자세한 내용은 필드 규칙 적용을 참조하세요. |
||
|
COPY |
사용자가 작업 항목을 만들거나 수정할 때 지정된 값을 필드에 복사합니다. <COPY for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="valueToCopy" field="fieldReferenceName" /> 자세한 내용은 기본값 정의 또는 필드에 값 복사를 참조하세요. |
||
|
DEFAULT |
사용자가 작업 항목을 만들거나 수정할 때 비어 있는 필드의 값을 지정합니다. 필드에 이미 값이 있는 경우 기본 규칙은 무시됩니다. <DEFAULT for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="value to copy" field="field reference name" /> 자세한 내용은 기본값 정의 또는 필드에 값 복사를 참조하세요. |
||
|
EMPTY |
값이 포함된 필드를 지웁니다. EMPTY 규칙은 필드를 읽기 전용으로 설정하므로 이 규칙을 READONLY 규칙과 함께 사용해서는 안 됩니다. 사용자가 작업 항목을 저장하면 필드 값이 지워지며, 어떤 값도 지정할 수 없게 됩니다. 이 규칙은 주로 상태를 전환하는 동안 항목이 전환되는 상태에 적용되는 필드를 지우는 데 사용됩니다. <EMPTY for="userGroupName" not=" userGroupName" /> 자세한 내용은 필드 규칙 적용을 참조하세요. |
||
|
FROZEN |
변경 내용이 커밋된 후 필드를 비어 있지 않은 값으로 변경할 수 없도록 지정합니다. 사용자가 해당 필드의 값이 있는 작업 항목을 저장하는 즉시 해당 값은 더 이상 수정할 수 없게 됩니다. <FROZEN for="userGroupName" not="userGroupName" /> 자세한 내용은 필드 규칙 적용을 참조하세요. |
||
|
HELPTEXT |
사용자가 작업 항목 폼에서 필드를 가리키면 표시되는 텍스트를 정의합니다. tooltipText: 1~255자의 텍스트 문자열입니다. <HELPTEXT>tooltipText </HELPTEXT> 자세한 내용은 필드 규칙 적용을 참조하세요. |
||
|
MATCH |
String 형식 필드의 값이 일치해야 하는 패턴을 정의합니다. <MATCH pattern="patternValue" for="userGroupName" not="userGroupName" /> 자세한 내용은 문자열 필드에 패턴 일치 적용를 참조하세요. |
||
|
NOTSAMEAS |
지정된 다른 필드가 할당된 값과 동일한 값이 필드에 할당되지 않도록 지정합니다. field 특성 값은 필드의 유효한 참조 이름이어야 합니다. <NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" /> 자세한 내용은 필드 규칙 적용을 참조하세요. |
||
|
PROHIBITEDVALUES |
필드에 포함할 수 없는 값 목록을 정의합니다. 사용자는 필드에 금지된 값이 포함된 경우 작업 항목을 저장할 수 없습니다. <PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups"> <GLOBALLIST name="globalListName"> <LISTITEM value="Name" /> . . . </GLOBALLIST> </PROHIBITEDVALUES> 자세한 내용은 선택 목록 정의을 참조하세요. |
||
|
READONLY |
필드가 할당된 값을 수정할 수 없도록 지정합니다. <READONLY for="userGroupName" not="userGroupName" />
자세한 내용은 필드 규칙 적용을 참조하세요. |
||
|
REQUIRED |
사용자가 필드 값을 지정해야 하도록 지정합니다. 필수 필드는 비워 둘 수 없습니다. 사용자는 모든 필수 필드에 값을 할당할 때까지 작업 항목을 저장할 수 없습니다. <REQUIRED for="userGroupName" not="userGroupName" /> 자세한 내용은 필드 규칙 적용을 참조하세요. |
||
|
SERVERDEFAULT |
사용자가 작업 항목을 저장할 때 지정된 서버 값을 필드에 복사합니다. 이러한 필드는 일반적으로 폼에 읽기 전용으로 표시됩니다. <SERVERDEFAULT for="userGroupName" not="userGroupName" from="clock | currentuser" /> 자세한 내용은 기본값 정의 또는 필드에 값 복사를 참조하세요. |
||
|
SUGGESTEDVALUES |
작업 항목 폼 및 쿼리 편집기에서 사용자가 필드 목록에 지정할 수 있는 제안된 값 목록을 정의합니다. 사용자는 제안된 값이 아닌 다른 값을 지정할 수 있습니다. <SUGGESTEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups"> <GLOBALLIST name="globalListName"> <LISTITEM value="Name" /> . . . </GLOBALLIST> </SUGGESTEDVALUES> 자세한 내용은 선택 목록 정의을 참조하세요. |
||
|
VALIDUSER |
지정한 그룹에 속한 사용자가 작업 항목을 수정하지 못하도록 제한합니다. 기본 그룹은 Team Foundation Valid Users 그룹입니다. 모든 특성은 선택 사항입니다. 모든 특성은 1~255자의 텍스트 문자열로 구성되어야 합니다. 토큰을 사용하여 그룹을 지정할 수 있습니다. < VALIDUSER group="groupName" for="userName" not="userName" /> 자세한 내용은 필드 규칙 적용을 참조하세요. |
||
|
WHEN |
다른 필드에 특정 값이 있는 경우 현재 필드에 적용할 하나 이상의 규칙을 지정합니다. 부모 FIELD 요소가 현재 필드를 정의합니다.
<WHEN field="fieldReferenceName" value="value">
<ALLOWEDVALUES> . . . </ALLOWEDVALUES>
<ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
<CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
<COPY> . . . </COPY>
<DEFAULT> . . . </DEFAULT>
<EMPTY> . . . </EMPTY>
<FROZEN> . . . </FROZEN>
<MATCH> . . . </MATCH>
<NOTSAMEAS> . . . </NOTSAMEAS>
<PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
<READONLY> . . . </READONLY>
<REQUIRED> . . . </REQUIRED>
<SERVERDEFAULT> . . . </SERVERDEFAULT>
<SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
<VALIDUSER> . . . </VALIDUSER>
</WHEN>
자세한 내용은 조건부 기준 값 및 규칙 할당을 참조하세요. |
||
|
WHENNOT |
다른 필드에 특정 값이 없는 경우 현재 필드에 적용할 하나 이상의 규칙을 지정합니다. 부모 FIELD 요소가 현재 필드를 정의합니다.
<WHENNOT field="fieldReferenceName" value="value">
<ALLOWEDVALUES> . . . </ALLOWEDVALUES>
<ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
<CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
<COPY> . . . </COPY>
<DEFAULT> . . . </DEFAULT>
<EMPTY> . . . </EMPTY>
<FROZEN> . . . </FROZEN>
<MATCH> . . . </MATCH>
<NOTSAMEAS> . . . </NOTSAMEAS>
<PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
<READONLY> . . . </READONLY>
<REQUIRED> . . . </REQUIRED>
<SERVERDEFAULT> . . . </SERVERDEFAULT>
<SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
<VALIDUSER> . . . </VALIDUSER>
</WHENNOT>
자세한 내용은 조건부 기준 값 및 규칙 할당을 참조하세요. |
||
|
WHENCHANGED |
작업 항목을 수정하는 동안 다른 필드가 변경된 경우 현재 필드에 적용할 하나 이상의 규칙을 지정합니다. 부모 FIELD 요소가 현재 필드를 정의합니다.
<WHENCHANGED field="fieldReferenceName" >
<ALLOWEDVALUES> . . . </ALLOWEDVALUES>
<ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
<CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
<COPY> . . . </COPY>
<DEFAULT> . . . </DEFAULT>
<EMPTY> . . . </EMPTY>
<FROZEN> . . . </FROZEN>
<MATCH> . . . </MATCH>
<NOTSAMEAS> . . . </NOTSAMEAS>
<PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
<READONLY> . . . </READONLY>
<REQUIRED> . . . </REQUIRED>
<SERVERDEFAULT> . . . </SERVERDEFAULT>
<SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
<VALIDUSER> . . . </VALIDUSER>
</WHENCHANGED>
자세한 내용은 조건부 기준 값 및 규칙 할당을 참조하세요. |
||
|
WHENNOTCHANGED |
작업 항목을 수정하는 동안 다른 필드가 변경되지 않은 경우 현재 필드에 적용할 하나 이상의 규칙을 지정합니다. 부모 요소가 현재 필드를 정의합니다.
<WHENNOTCHANGED field="fieldReferenceName">
<ALLOWEDVALUES> . . . </ALLOWEDVALUES>
<ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
<CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
<COPY> . . . </COPY>
<DEFAULT> . . . </DEFAULT>
<EMPTY> . . . </EMPTY>
<FROZEN> . . . </FROZEN>
<MATCH> . . . </MATCH>
<NOTSAMEAS> . . . </NOTSAMEAS>
<PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
<READONLY> . . . </READONLY>
<REQUIRED> . . . </REQUIRED>
<SERVERDEFAULT> . . . </SERVERDEFAULT>
<SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
<VALIDUSER> . . . </VALIDUSER>
</WHENNOTCHANGED>
자세한 내용은 조건부 기준 값 및 규칙 할당을 참조하세요. |
참고GLOBALLIST 및 LISTITEM 요소를 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 하위 요소로 지정합니다. 이러한 요소를 사용하여 표시되는 값 목록을 열거할 수 있습니다. 사용자는 선택 목록 또는 드롭다운 메뉴에서 값을 선택합니다. 자세한 내용은 전역 목록 정의를 참조하세요.
|
요소 |
설명 |
|---|---|
|
GLOBALIST |
팀 프로젝트 컬렉션에 대해 저장되며 컬렉션의 모든 팀 프로젝트에서 사용할 수 있는 LISTITEM 요소 집합을 정의합니다.
<GLOBALLIST name="globalListName">
<LISTITEM> . . . </LISTITEM>
</GLOBALLIST>
globalListName: 1~255자 사이의 텍스트 문자열입니다. GLOBALLIST는 GLOBALLISTS 요소의 필수 자식 요소이자 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES요소의 선택적 자식 요소입니다. 작업 항목 정의, 전역 목록 정의 또는 전역 워크플로 내에서 전역 목록을 정의할 수 있습니다. |
|
LISTITEM |
유효한 목록 값을 정의합니다. <LISTITEM value="listName" /> LISTITEM은 GLOBALLIST 요소의 필수 자식 요소이자 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 선택적 자식 요소입니다. |
FIELD 또는 for 특성을 포함하여 그룹 또는 사용자 집합에 적용되거나 적용되지 않도록 대부분의 not 규칙을 정규화할 수 있습니다. 자세한 내용은 필드 규칙 적용을 참조하세요.
|
attribute |
구문 |
설명 |
|---|---|---|
|
expanditems |
expanditems="true | false" |
선택 사항입니다. 목록에 하위 그룹을 포함하도록 LISTITEM 요소가 식별하는 그룹을 확장해야 하는지 여부를 지정합니다. 이 특성의 기본값은 true입니다. |
|
filteritems |
filteritems="excludegroups" |
선택 사항입니다. 그룹 이름은 포함되지 않고 그룹의 멤버만 목록에 포함되도록 지정합니다. 이 특성에는 excludegroups 값만 허용됩니다. |
|
for |
for="userGroupName" |
선택 사항입니다. Team Foundation에서 규칙이 적용되는 사용자 또는 그룹의 이름을 지정합니다. 유효한 값은 1~255자의 텍스트 문자열로 구성됩니다. |
|
not |
not="userGroupName" |
선택 사항입니다. Team Foundation에서 규칙이 적용되지 않는 사용자 또는 그룹의 이름을 지정합니다. 유효한 값은 1~255자의 텍스트 문자열로 구성됩니다. |
|
from |
from="value | field | clock | currentuser" |
"value" 또는 "field"를 지정한 경우 각각 value 또는 field 특성도 포함해야 합니다. |
|
field |
field="fieldReferenceName" |
선택 사항입니다. field 특성에 대해 from가 지정된 경우 필드에 값을 복사할 필드의 이름을 지정합니다. |
|
pattern |
pattern="patternValue" |
패턴 값: ^[^\\]*$ 예를 들어 pattern="xxxxx.nn.nn"은 임의의 영문자 5개, 마침표, 숫자 2개, 마침표, 추가 숫자 2개와 차례로 일치합니다. |
|
value |
value="valueToCopy" |
선택 사항입니다. value 특성에 대해 from가 지정된 경우 필드에 복사할 값을 지정합니다. |
