사용 가능한 필드 규칙

업데이트: 2007년 11월

필드 규칙은 필드의 동작과 제약 조건을 정의합니다. 이러한 필드 규칙은 <FIELD></FIELD> 블록 내에 나열되는 추가 요소입니다. 예를 들어 필수 필드의 경우 이 필드를 정의하는 XML은 다음과 같습니다.

<FIELD refname="System.Priority" name="Priority" type="String">
<HELPTTEXT>Enter the business priority of the bug</HELPTEXT>
<REQUIRED />
</FIELD>

사용 가능한 필드 규칙

다음 필드 규칙을 사용하여 필드의 동작을 변경할 수 있습니다.

<REQUIRED />

이 필드는 비워 둘 수 없습니다. 모든 필드 형식을 필수 요소로 표시할 수 있습니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 REQUIRED 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<READONLY />

이 필드는 수정할 수 없습니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 READONLY 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<EMPTY />

커밋하면 필드 값이 지워지고 사용자가 값을 입력할 수 없습니다. 이 규칙은 주로 전환 대상 상태에 적용되는 필드를 지우기 위해 상태 전환 중에 사용됩니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 EMPTY 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<FROZEN/>

커밋 후에 필드에 값이 입력된 후에는 값을 더 이상 수정할 수 없습니다. 그러나 <EMPTY/> 제약 조건을 사용하여 필드를 지울 수 있습니다. 사용자는 수동으로 필드를 지우고 작업 항목을 저장한 다음, 다시 로드할 때 다른 값을 지정할 수 있습니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 FROZEN 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<CANNOTLOSEVALUE/>

필드에 값을 가져온 후에는 필드를 지우거나 비울 수 없습니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 CANNOTLOSEVALUE 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<NOTSAMEAS field="MyCorp.Reviewer" />

필드 값이 다른 필드(이 예제의 경우 "MyCorp.Reviewer" 필드)의 값과 같을 수 없습니다. 필드 값은 올바른 필드 참조 이름이어야 합니다. 자세한 내용은 필드 참조 이름을 참조하십시오.

다음은 NOTSAMEAS 필드 규칙을 사용하는 예제입니다.

• 두 필드를 동시에 비워 둘 수 없습니다.

• "코드 검토자" 필드 값은 "담당자" 필드 값과 정확하게 일치할 수 없습니다.

형식이 비슷한 필드에 이 규칙을 사용합니다. 그러나 PlainText 또는 HTML 필드에는 이 규칙을 사용할 수 없습니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 NOTSAMEAS 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<VALIDUSER group="group" />

필드 값은 Team Foundation Valid Users 그룹에 속해 있는 유효한 사용자여야 합니다.

이 규칙은 사용자가 지정된 그룹의 직접 또는 간접 멤버여야 함을 지정할 수 있도록 선택적 group 특성을 지원합니다. 기본적으로 이 규칙은 Team Foundation Valid Users 그룹에 속해 있는 모든 사용자를 허용합니다. 자세한 내용은 사용자 및 그룹 참조에 토큰 사용을 참조하십시오. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 VALIDUSER 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

참고:
<REQUIRED/> 규칙을 지정하지 않으면 이 필드에 빈 값을 사용할 수 있습니다. 이 규칙은 String 필드 형식에 사용됩니다.

참고:
작업 항목 필드에서는 서로 다른 도메인의 사용자 ID가 구분되지 않습니다. 따라서 <VALIDUSER /> 규칙을 사용하는 필드에 값을 입력할 경우 "Example1\jaepak"와 "Example2\jaepak"는 같은 사용자로 간주됩니다. 그러나 Team Foundation Server의 다른 곳에서는 사용자 ID가 도메인별로 구분됩니다.

<ALLOWEXISTINGVALUE/>

현재 사용 여부에 관계없이 기존 값을 필드에 유지할 수 있도록 합니다. 편집할 때 사용자가 해당 필드에 대해 가장 최근에 사용된 값과 일치시키는 기본 동작을 대신 사용할 수도 있습니다. 이 요소를 사용하면 같은 블록의 요소만 수정할 수 있습니다. 이 요소에는 for 또는 not 특성을 사용할 수 없습니다. 자세한 내용은 ALLOWEXISTINGVALUE 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<ALLOWEDVALUES/>

사용자에게 목록으로 제공되는 열거형 값 목록입니다. 사용자는 이 목록의 값 중 하나를 선택해야 합니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 ALLOWEDVALUES 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<SUGGESTEDVALUES/>

사용자에게 목록으로 제공되는 열거형 값 목록입니다. 사용자는 이 목록의 값 중에서 아무 값이나 선택할 수 있습니다. 또한 제안된 값이 아닌 다른 값을 직접 입력할 수도 있습니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 SUGGESTEDVALUES 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<PROHIBITEDVALUES/>

사용이 금지된 값이 필드에 포함되어 있으면 사용자가 작업 항목을 저장할 수 없습니다. 금지된 값은 대개 이전에는 허용되었지만 더 이상 유효하지 않을 때 사용됩니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 PROHIBITEDVALUES 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<DEFAULT>

사용자가 새 작업 항목을 만들거나 작업 항목을 편집할 경우 <DEFAULT> 요소는 비어 있는 필드에 값을 입력합니다. 필드에 이미 값이 있는 경우에는 기본 규칙이 무시됩니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 DEFAULT 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

참고:
작업 항목을 변경할 경우 이 요소 규칙은 다른 필드에서 현재 값 또는 이전 값을 선택하는 것과 관련하여 불명확합니다.

<COPY>

사용자가 작업 항목을 새로 만들거나 변경할 경우 <COPY> 요소는 필드의 기존 값에 관계없이 필드에 값을 입력합니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 COPY 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

참고:
작업 항목을 변경할 경우 이 요소 규칙은 다른 필드에서 현재 값 또는 이전 값을 선택하는 것과 관련하여 불명확합니다.

<SERVERDEFAULT>

편집을 시작할 때 값을 입력하는 <DEFAULT> 및 <COPY> 규칙과 달리 <SERVERDEFAULT> 규칙은 작업 항목이 데이터베이스에 커밋되면 값을 입력합니다. 이는 저장할 때 발생하며 사용자가 값을 재정의할 수 없습니다. 이러한 필드는 폼에서 읽기 전용으로 나타납니다. 이 규칙은 "마지막으로 변경한 사람"과 "마지막으로 변경한 시간" 같은 필드에 사용되어 보안 감사 내역을 지원합니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 SERVERDEFAULT 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

<MATCH pattern="<pattern>"/>

문자열에만 기본 패턴 일치를 적용합니다. <pattern>을 일치 패턴으로 바꿔야 합니다. 올바른 값은 "A", "N", "X"이며 다른 값은 모두 리터럴로 간주됩니다. "A"는 영문자를 나타냅니다. "N"은 숫자를 나타냅니다. "X"는 영숫자를 나타냅니다. 이 패턴은 String 형식 필드에만 지원됩니다. 이 요소에는 for 및 not 특성을 사용할 수 있습니다. 자세한 내용은 MATCH 요소(작업 항목 형식 정의 스키마)를 참조하십시오.

패턴 일치 예제

다음 예제에서는 다양한 필드에 대해 패턴 일치가 제대로 사용된 경우와 그렇지 않은 경우를 보여 줍니다.

릴리스 번호

패턴: ANN.NN.NN

유효한 값	R01.03.04 또는 V05.08.99
유효하지 않은 값	1.3.4, V5.8.99 또는 v1.3

유연한 식별자

패턴: XXX-XXX

유효한 값	001-abc 또는 a00-b02
유효하지 않은 값	1-abc 또는 001.abc

우선 순위

패턴: PN

유효한 값	P1, P5 또는 P9
유효하지 않은 값	1 또는 P10

일치 태그는 대/소문자를 구분하지 않으므로 "PN"의 경우 P1과 p1이 같은 것으로 인식됩니다.

참고:
<MATCH> 요소를 여러 개 지정할 수 있습니다. 이러한 요소 중 하나라도 성공하면 필드에 올바른 값이 사용됩니다.

참고 항목

기타 리소스

필드 목록 정의