다음을 통해 공유

모든 FIELD XML 요소 참조

  • 아티클

이 항목의 정보는 작업 항목 형식의 데이터 필드를 정의하는 모든 요소와 주요 특성에 대한 빠른 참조로 사용할 수 있습니다.이러한 요소는 FIELD(정의) 요소 컨테이너에서 지정합니다.FIELDS(정의) 요소 내에 FIELD(정의) 요소를 지정하여 작업 항목 형식에 대한 필드를 추가합니다.작업 항목 형식의 정의 내에 또는 전역 워크플로의 일부로 이러한 요소를 지정할 수 있습니다.이 항목에서 설명하는 자식 요소를 만들어서 필드 동작을 지정하거나, 기본값을 정의하거나, 값의 선택 목록을 정의할 수 있습니다.필드 규칙 요소를 서로 결합하여 사용할 수 있습니다.하나 이상의 사용자 또는 그룹에 적용하거나 하나 이상의 사용자 또는 그룹에 대해 무시하도록 대부분의 규칙 범위를 지정할 수 있습니다.

FIELD 요소의 모든 자식 요소는 선택 사항입니다.제외 하 고는 HELPTEXT 요소를 지정할 수 있는 모든 요소의 자식 요소로 FIELD (정의) FIELD (워크플로) 및 FIELD (전역 워크플로) 요소입니다.FIELD(정의) 요소를 사용하여 작업 항목 필드를 정의하고 필드에 적용할 규칙 및 조건을 지정합니다.FIELD(정의) 요소의 규칙을 지정하여 값을 정의하거나 한 상태에서 다른 상태로의 작업 항목 변환으로 필드에 규칙을 적용합니다.부모 FIELDS 요소가 자식 요소인 STATE, TRANSITION, DEFAULTREASON 또는 REASON 요소를 기준으로 필드 규칙을 지정할 수 있습니다.자세한 내용은 작업 항목 필드 사용 및 워크플로 디자인을 참조하십시오.

항목 내용

  • FIELD(정의) 컨테이너 요소

  • FIELD 자식 요소

  • GLOBALLIST 및 LISTITEM 자식 요소

  • FIELD 자식 요소로 지정되는 특성

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

문자열 형식의 값이 일치해야 하는 패턴을 정의합니다.

<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 자식 요소

다음 표에서는 GLOBALLIST 및 LISTITEM 요소에 대해 설명합니다.이러한 요소는 ALLOWEDVALUES, SUGGESTEDVALUES 및 PROHIBITEDVALUES 요소의 자식 요소로 지정합니다.이러한 요소를 사용하여 사용자가 지정할 수 있는 항목의 선택 목록이나 드롭다운 메뉴로 사용자에게 표시할 값 목록을 열거할 수 있습니다.자세한 내용은 사용자 목록, 선택 목록 및 전역 목록 정의을 참조하십시오.

요소

구문

설명

GLOBALIST

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

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

globalListName: 1~255자를 포함하는 텍스트 문자열입니다.

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

LISTITEM

 
<LISTITEM value="listName" />

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

LISTITEM은 GLOBALLIST 요소의 필수 자식 요소이며 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: 현재 날짜와 시간에서 시스템 시계 날짜/시간 필드에 복사합니다. 이때 다른 특성은 필요하지 않습니다.COPY 및 DEFAULT 규칙의 경우 이 값은 로컬 컴퓨터 클록 시간에서 가져옵니다.SERVERDEFAULT의 경우 사용자가 작업 항목을 저장할 때 서버 클록에서 값을 가져옵니다.

  • currentuser: 현재 로그온 한 사용자의 이름을 복사 합니다.현재 사용자의 약식 이름을 값으로 사용합니다.이때 다른 특성은 필요하지 않습니다.currentuser는 String 필드에 사용됩니다.

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

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

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

field

field="fieldReferenceName"

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

pattern

패턴 = "patternValue"

필수 요소.문자열에만 기본 패턴 일치를 적용합니다.patternValue 1-255 자 사이 구성 하는 문자열입니다.해당 문자열에는 백슬래시 문자 (\) 없어야 합니다.다음 여섯 가지 메타 문자 중 하나가 아닌 문자열의 각 문자는 리터럴로 해석 됩니다.

  • "A" 또는 "a" 나타내는 단일 알파벳 문자.

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

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

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

예를 들어, pattern="xxxxx.nn.nn" 5 개의 영숫자 문자를 다음에 마침표를 차례로 숫자 문자 두 개 다음에 마침표를 숫자 문자가 두 개 이상 일치 합니다.

value

value="valueToCopy"

선택 사항입니다.from 특성에 대해 value가 지정되었을 때 필드에 복사할 값의 필드 이름을 지정합니다.

맨 위로 이동

참고 항목

개념

사용자 목록, 선택 목록 및 전역 목록 정의

작업 항목 필드 사용

워크플로 디자인