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

황제낙엽 2018.01.24 17:57 조회 수 : 251

sitelink1 https://msdn.microsoft.com/ko-kr/library/ms194953.aspx 
sitelink2  
sitelink3  

이 항목을 사용하여 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" />
참고참고

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 요소를 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"

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

  • 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가 지정된 경우 필드에 복사할 값을 지정합니다.

이 게시물을
목록
번호 제목 글쓴이 날짜 조회 수
76 [code review response] 코드 검토 응답을 실수한 경우 응답 제거 방법 file 황제낙엽 2020.02.03 260
75 TFS Requirements (required env spec) 황제낙엽 2020.01.31 267
74 WorkItem 의 System.History 필드 조회 불가 황제낙엽 2020.01.16 233
73 Sharepoint Server 황제낙엽 2020.01.13 260
72 TF401256: You do not have Write permissions for query Shared Queries. file 황제낙엽 2019.12.17 4389
71 다른 프로젝트의 WI를 조회하는 법 (Query across projects) file 황제낙엽 2019.12.02 360
70 Visual Studio Team Explorer Everywhere for Eclipse (Azure DevOps Services and TFS) file 황제낙엽 2019.12.02 525
69 TFS 와 Eclipse 연동 (Visual Studio TEE Plugin for Eclipse) file 황제낙엽 2019.12.02 452
68 외부 구성원에게 팀프로젝트의 특정 브랜치에만 권한 부여하는 방법 황제낙엽 2019.05.24 275
67 팀프로젝트에 Reader 권한의 계정 추가 방법 황제낙엽 2019.01.29 350
66 Adopting Team Explorer Everywhere (TFS-SDK 최신버전 다운로드 가능) file 황제낙엽 2018.12.08 336
65 Microsoft Volume Licensing Service Center 관리자 권한 관련 file 황제낙엽 2018.09.06 301
64 TFS 에서 Workspace 삭제 (TF.exe) 황제낙엽 2018.06.04 488
63 [WORKITEMTYPE] 다른 Field 의 value 값에 따라 동적으로 속성 변경하기 - <WHEN> 황제낙엽 2018.01.26 237
» [witadmin] 모든 FIELD XML Element (API References) 황제낙엽 2018.01.24 251
61 Process Template Editor for Team Foundation Server 2017 file 황제낙엽 2017.10.31 636
60 Power Tools for VisualStudio file 황제낙엽 2017.10.31 262
59 Visual Studio 2017 에서 TFS 에 접속시의 에러 (TF30063: You are not authorized to access) 황제낙엽 2017.09.26 741
58 [TFS SDK for Java] WorkItem 필드값 수정 예제 황제낙엽 2017.09.21 298
57 MSDN 라이선스 기술지원을 위한 Access ID 발급 방법 황제낙엽 2017.09.11 264
쓰기 태그