다음을 통해 공유

모든 FIELD XML 요소 참조

  • 아티클

업데이트: 2011년 1월

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

참고

전역 워크플로를 정의하려면 먼저 응용 프로그램 계층 서버에서 해당 기능을 사용하도록 설정해야 합니다. 따라서 서버에서는 Team Foundation Server 2010 SP1(서비스 팩 1)과 같이 해당 기능을 지원하는 Visual Studio Team Foundation Server 버전을 실행하고 있어야 합니다. Microsoft 웹 사이트의 Service Pack 1 of Visual Studio Team Foundation Server 2010, Beta 페이지에서 서비스 팩을 다운로드할 수 있습니다. 자세한 내용은 전역 워크플로 사용자 지정을 참조하십시오.

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:  시스템 클록에서 DateTime 필드로 현재 날짜 및 시간을 복사합니다. 추가 특성은 필요하지 않습니다. 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가 지정되었을 때 필드에 복사할 값의 필드 이름을 지정합니다.

value

value="valueToCopy"

선택적 요소로서, from 특성에 대해 value가 지정되었을 때 필드에 복사할 값의 필드 이름을 지정합니다.

맨 위로 이동

참고 항목

개념

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

작업 항목 필드 사용

워크플로 디자인

변경 기록

날짜

변경 내용

이유

2011년 1월

모든 FIELD 자식 요소에 대한 구문을 제공하고 제거된 항목에 대한 링크를 제거하도록 수정되었습니다.

향상된 기능 관련 정보