work item type [witadmin] 모든 FIELD XML Element (API References)

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>

자세한 내용은 조건부 기준 값 및 규칙 할당을 참조하세요.

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 요소의 선택적 자식 요소입니다.

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 필드에 복사합니다. 추가 특성은 필요하지 않습니다. COPY 및 DEFAULT 규칙의 경우, 로컬 컴퓨터 클록 시간에서 이 값을 가져옵니다. SERVERDEFAULT의 경우, 사용자가 작업 항목을 저장할 때 서버 클록에서 이 값을 가져옵니다.

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

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

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

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

field

field="fieldReferenceName"

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

pattern

pattern="patternValue"

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

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

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

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

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

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

value

value="valueToCopy"

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