다음을 통해 공유


모든 FIELD XML 요소 참조

이 항목을 사용하여 FIELD 요소의 구문 또는 해당 하위 요소 중 하나의 구문을 조회할 수 있습니다.

이러한 요소는 FIELD(정의) 요소 컨테이너에서 지정합니다. FIELDS(정의) 요소 내에서 FIELD(정의) 요소를 지정하여 WIT(작업 항목 형식)에 대한 필드를 추가합니다. 이러한 요소를 WIT 정의 내에서 지정하거나 전역 워크플로의 일부로 지정할 수 있습니다.

하위 요소를 추가하여 필드의 동작을 지정하거나, 기본값을 정의하거나, 값의 선택 목록을 정의할 수 있습니다. 필드 규칙 요소를 조합하여 사용할 수 있습니다. 대부분의 규칙에 대해 하나 이상의 사용자 또는 그룹에 적용되거나 하나 이상의 사용자 또는 그룹에 대해 무시되도록 범위를 지정할 수 있습니다.

FIELD(정의) 컨테이너 요소

다음 구문을 사용하여 작업 항목 형식의 데이터 필드를 정의할 수 있습니다. 이 예제에서는 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>

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" />

참고

EMPTY도 필드를 읽기 전용으로 설정하므로 이 요소를 EMPTY 요소와 함께 사용하지 마세요.이러한 요소를 함께 사용하면 결과가 일치하지 않게 됩니다.

자세한 내용은 필드 규칙 적용을 참조하세요.

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 하위 요소

GLOBALLISTLISTITEM 요소를 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 하위 요소로 지정합니다. 이러한 요소를 사용하여 표시되는 값 목록을 열거할 수 있습니다. 사용자는 선택 목록 또는 드롭다운 메뉴에서 값을 선택합니다. 자세한 내용은 전역 목록 정의을 참조하십시오.

요소

설명

GLOBALIST

팀 프로젝트 컬렉션에 대해 저장되며 컬렉션의 모든 팀 프로젝트에서 사용할 수 있는 LISTITEM 요소 집합을 정의합니다.

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST> 

globalListName: 1~255자 사이의 텍스트 문자열입니다.

GLOBALLISTGLOBALLISTS 요소의 필수 자식 요소이자 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 선택적 자식 요소입니다. 작업 항목 정의, 전역 목록 정의 또는 전역 워크플로 내에서 전역 목록을 정의할 수 있습니다.

LISTITEM

유효한 목록 값을 정의합니다.

<LISTITEM value="listName" />

LISTITEMGLOBALLIST 요소의 필수 자식 요소이자 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 선택적 자식 요소입니다.

FIELD 하위 요소에 의해 지정되는 특성

for 또는 not 특성을 포함하여 그룹 또는 사용자 집합에 적용되거나 적용되지 않도록 대부분의 FIELD 규칙을 정규화할 수 있습니다. 자세한 내용은 필드 규칙 적용을 참조하세요.

특성

구문

설명

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"

필수 요소. 값을 복사하거나 기본값을 지정할 값의 소스를 지정합니다. 유효한 값은 다음과 같습니다.

  • clock: 시스템 클록의 현재 날짜 및 시간을 DateTime 필드에 복사합니다. 추가 특성은 필요하지 않습니다. COPYDEFAULT 규칙의 경우, 로컬 컴퓨터 클록 시간에서 이 값을 가져옵니다. SERVERDEFAULT의 경우, 사용자가 작업 항목을 저장할 때 서버 클록에서 이 값을 가져옵니다.

  • currentuser: 현재 로그온된 사용자의 이름을 복사합니다. 현재 사용자의 약식 사용자 이름을 값으로 사용합니다. 추가 특성은 필요하지 않습니다. 문자열 필드에 사용됩니다.

  • field: 지정한 field 특성의 값을 복사합니다. field="abc" 특성이 필요합니다. 지정된 "from" 필드가 비어 있으면 기본적으로 아무 작업도 수행되지 않습니다. field 특성은 <COPY> 및 <DEFAULT> 규칙에만 사용됩니다.

  • value: 지정한 value 특성의 값을 복사합니다. 지정한 문자열 상수 값을 사용합니다. value="abc" 특성이 필요합니다. value는 <COPY> 및 <DEFAULT> 규칙에만 사용됩니다.

"value" 또는 "field"를 지정한 경우 각각 value 또는 field 특성도 포함해야 합니다.

field

field="fieldReferenceName"

선택 사항입니다. from 특성에 대해 field가 지정된 경우 필드에 값을 복사할 필드의 이름을 지정합니다.

pattern

pattern="patternValue"

필수 요소. 문자열에만 기본 패턴 일치를 적용합니다. patternValue는 1~255자로 구성된 문자열입니다. 이 문자열은 백슬래시 문자(\)를 포함할 수 없습니다. 문자열의 각 문자는 다음 6개 메타문자 중 하나가 아닌 경우 리터럴로 해석됩니다.

  • "A" 또는 "a"는 단일 영문자를 나타냅니다.

  • "N" 또는 "n"은 단일 숫자를 나타냅니다.

  • "X" 또는 "x"는 단일 영문자를 나타냅니다.

패턴 값: ^[^\\]*$

예를 들어 pattern="xxxxx.nn.nn"은 임의의 영문자 5개, 마침표, 숫자 2개, 마침표, 추가 숫자 2개와 차례로 일치합니다.

value

value="valueToCopy"

선택 사항입니다. from 특성에 대해 value가 지정된 경우 필드에 복사할 값을 지정합니다.

참고 항목

개념

작업 항목 필드 정의 및 수정

작업 항목 형식의 워크플로 변경