기본값 정의 또는 필드에 값 복사
필드에 기본값을 지정하거나, 다른 필드 또는 시스템 정의 값에서 값을 복사할 수 있습니다. 필드 기본값은 필드 값이 자동으로 할당되는 방법을 제어하는 규칙입니다. COPY, DEFAULT 및 SERVERDEFAULT 요소 중 하나를 사용하여 필드 기본값을 할당할 수 있습니다. 이 요소를 FIELD(정의) 요소 또는 FIELD(워크플로) 요소의 자식 요소로 지정할 수 있습니다.
작업 항목 유형(WIT)에 대한 정의에 이 요소를 추가합니다. 자세한 내용은 사용자 지정 작업 항목 형식 수정 또는 추가(WIT)을 참조하세요.
COPY 및 DEFAULT 요소는 편집을 시작할 때 값을 채우지만 SERVERDEFAULT 규칙은 작업 항목이 데이터베이스에 커밋되었을 때 값을 채웁니다. 이 작업은 사용자가 변경 내용을 작업 항목에 저장하고 값을 재정의할 수 없을 때 발생합니다. 이러한 필드는 일반적으로 작업 항목 폼에서 읽기 전용으로 표시됩니다. SERVERDEFAULT 규칙은 보안 감사 내역을 지원하기 위해 "마지막으로 변경한 사람" 및 "마지막으로 변경한 시간"과 같은 필드에 사용됩니다.
구문
COPY, DEFAULT 및 SERVERDEFAULT 요소를 사용하여 한 필드에서 다른 필드로 값을 복사하고, 서버 값을 필드에 복사하거나 필드에 대해 정의되도록 기본값을 지정할 수 있습니다.
참고
작업 항목이 변경되는 중인 경우 COPY 또는 DEFAULT 요소 규칙은 소스 필드에서 현재 또는 이전 값을 선택할 수 있습니다.
다른 필드에서 복사할 값, 클록 값 또는 현재 사용자의 이름을 지정할 수 있습니다. from 특성에 대한 value 또는 field를 지정하는 경우 value 또는 field 특성을 지정해야 합니다. 사용자가 작업 항목을 변경하거나 만들 때 COPY 규칙은 필드에 이미 있는 값에 관계 없이 필드 값을 채웁니다.
<COPY for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="valueToCopy" field="fieldReferenceName/>DEFAULT 규칙을 사용하여 필드에 대한 기본값을 지정할 수 있습니다. 사용자가 작업 항목을 만들거나 편집할 때 DEFAULT 필드가 비어있는 경우 값을 채웁니다. 다른 필드에서 복사할 값, 서버 클록이 기록하는 날짜-시간 스탬프 또는 현재 사용자의 이름을 지정할 수 있습니다. 필드에 이미 값이 있는 경우 이 규칙은 무시됩니다.
<DEFAULT for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="defaultValue" field="fieldReferenceName" />작업 항목을 저장할 때 서버에서 필드로 복사할 값을 지정할 수 있습니다. 사용자가 작업 항목의 상태를 변경할 때 SERVERDEFAULT 규칙은 서버 구성 요소에서 파생되는 값에서 현재 필드로 복사될 값을 지정합니다. DEFAULT 및 COPY 요소는 사용자가 수정하기 위해 작업 항목을 열 때 값을 채우지만 SERVERDEFAULT 규칙은 작업 항목이 데이터베이스로 커밋될 때 값을 채웁니다. 이 작업은 사용자가 작업 항목을 저장할 때 발생합니다. 사용자는 값을 재정의할 수 없습니다. 이러한 필드는 일반적으로 폼에 읽기 전용으로 표시됩니다. SERVERDEFAULT 규칙은 보안 감사 내역을 지원하기 위해 "마지막으로 변경한 사람" 및 "마지막으로 변경한 시간"과 같은 필드에 사용됩니다.
<SERVERDEFAULT for="userGroupName" not="userGroupName" from="clock | currentuser" />
이러한 각 규칙 요소는 값의 소스를 식별하는 from="fromType" 특성을 지정합니다. fromType 값에 따라 특성이 추가로 필요할 수 있습니다. 다음 테이블은 COPY, DEFAULT 및 SERVERDEFAULT 규칙 요소가 참조하는 모든 특성을 설명합니다.
특성 |
설명 |
|---|---|
for |
선택 사항입니다. Team Foundation에서 규칙이 적용되는 사용자 또는 그룹의 이름을 지정합니다. 유효한 이름은 1~255자의 텍스트 문자열로 구성됩니다. 패턴 값: ^[^\\]+\\[^\\]+$ 패턴 값 예: Domain\UserID |
not |
선택 사항입니다. Team Foundation에서 규칙이 적용되지 않는 사용자 또는 그룹의 이름을 지정합니다. 유효한 이름은 1~255자의 텍스트 문자열로 구성됩니다. 패턴 값: ^[^\\]+\\[^\\]+$ 패턴 값 예: Domain\UserID |
from |
필수 요소. value 특성, field 특성, 시스템 클록 또는 현재 사용자에서 기본값을 복사할지 여부를 지정합니다. from 특성에 대한 value 또는 field를 지정하는 경우 각각 value 또는 field 특성을 지정해야 합니다. 다음 값을 지정할 수 있습니다.
|
value |
선택 사항입니다. from 특성에 대해 value가 지정된 경우 필드에 복사할 값을 지정합니다. 유효한 값은 1~255자의 텍스트 문자열로 구성됩니다. 복사할 값은 비워 둘 수 있습니다. |
field |
선택 사항입니다. from 특성에 대해 field가 지정된 경우 필드에 값을 복사할 필드의 이름을 지정합니다. from 특성의 값이 "field"이면 이 특성을 정의해야 합니다. 복사할 필드의 참조 이름입니다. 참조 이름은 FIELD(정의) 요소에 정의된 참조 이름과 일치해야 합니다. 자세한 내용은 FIELD(정의) 요소 참조을 참조하십시오. 패턴 값: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ 패턴 값 예: Company.Division.IssueType |
맨 위로 이동
기본값 정의
다음 예제에서는 우선 순위 필드에 대한 기본값으로 P3을 설정합니다.
<FIELD refname="MyCorp.Priority" name="Priority" type="String">
<HELPTEXT>Specify the severity of the problem</HELPTEXT>
<ALLOWEDVALUES>
<LISTITEM value="P1"/>
<LISTITEM value="P2"/>
<LISTITEM value="P3"/>
</ALLOWEDVALUES>
<DEFAULT from="value" value="P3"/>
</FIELD>
필드를 자동으로 지우기
다음 예제에서는 상태 필드가 지워져 있습니다.
<FIELD refname="MyCorp.Status" name="Status" type="String">
<COPY from="value" value="" />
</FIELD>
필드 값 저장
다음 예제에서는 가장 최근에 작업 항목을 변경한 사용자 이름이 저장되었습니다.
<FIELD refname="System.Last Changed By" name="Last Changed By" type="String">
<HELPTEXT>The name of the user who most recently modified this bug</HELPTEXT>
<VALIDUSER group="[Project]\MyProjectMembers" />
<SERVERDEFAULT from="currentuser" />
</FIELD>
클록을 기본값으로 지정
다음 예제에서는 필드 값이 현재 날짜를 사용하지만 사용자가 해당 값을 변경할 수 있습니다.
<FIELD refname="MyCorp.FoundOn" name="Found On" type="DateTime">
<HELPTEXT>Defines when a bug was found.</HELPTEXT>
<DEFAULT from="clock" />
</FIELD>
참고
"Won’t Fix"와 같이 아포스트로피가 있는 값의 경우, 다음 예제에 표시된 것과 같이 XML에서 큰따옴표를 사용해야 합니다.
<LISTITEM value="Won’t Fix"/>