다음을 통해 공유


WHEN 요소(작업 항목 형식 정의 스키마)

업데이트: 2007년 11월

현재 필드에 하나 이상의 규칙을 적용하는 조건을 지정합니다. 규칙은 다른 필드에 특정 값이 있는 경우 현재 필드에 적용됩니다. 부모 요소가 현재 필드를 정의합니다.

<xs:element name="WHEN" type="FieldValueCondition"/>

특성 및 요소

다음 단원에서는 WHEN 요소의 특성 및 해당 요소를 정의하는 자식 요소에 대해 설명합니다. 또한 WHEN 요소 적용 방법을 정의하는 부모 요소에 대해서도 설명합니다. 자식 요소를 적어도 하나는 정의해야 합니다.

특성

특성

설명

field

필수 특성입니다.

현재 필드에 적용할 이 요소의 규칙에 대해 지정된 값이 있어야 하는 필드를 식별합니다.

필드 참조 이름으로 이 특성을 지정합니다. 참조 이름에 대한 자세한 내용은 FIELD 요소(WORKITEMTYPE 요소)를 참조하십시오.

value

필수 특성입니다.

field 특성으로 식별되는 필드에 현재 필드에 적용할 이 요소의 규칙에 따라 포함되어야 하는 값을 지정합니다.

자식 요소

요소

설명

REQUIRED 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 현재 필드(WHEN 요소가 포함된 필드)에 값이 포함되도록 지정합니다.

READONLY 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 현재 필드가 읽기 전용 상태가 되도록 지정합니다.

EMPTY 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 현재 필드에 값이 포함되지 않도록 지정합니다.

FROZEN 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 현재 필드가 고정 상태가 되도록 지정합니다. 고정 필드는 변경 내용을 커밋한 후 빈 값으로 변경할 수 없습니다. 그러나 수동으로 필드를 지우고 작업 항목을 저장한 다음 다른 값을 지정할 수 있습니다.

CANNOTLOSEVALUE 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별된 필드 값이 변경되지 않은 경우 현재 필드에 값이 채워진 후 지우거나 비울 수 없도록 지정합니다.

NOTSAMEAS 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 현재 필드의 값이 세 번째 필드의 값과 일치할 수 없도록 지정합니다. NOTSAMEAS 요소에서 세 번째 필드를 지정합니다.

VALIDUSER 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 허용되는 값 목록이 시스템의 유효한 사용자로만 구성되도록 지정합니다.

ALLOWEXISTINGVALUE 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 이미 존재하는 현재 필드 값이 다른 규칙을 위반하더라도 허용되도록 지정합니다. 현재 필드의 값이 변경되면 이 요소가 적용되지 않습니다.

MATCH 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 경우 현재 필드의 값이 지정된 패턴과 일치하도록 지정합니다.

ALLOWEDVALUES 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 현재 필드가 지정된 값 목록에 있는 값으로 채워지도록 지정합니다. 작업 항목 폼과 쿼리 작성기의 필드 목록에서 선택 가능한 값만 허용됩니다. 이러한 값 중 하나를 선택해야 합니다.

SUGGESTEDVALUES 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 지정된 목록에 현재 필드의 제안 값이 포함되도록 지정합니다. 제안 값은 작업 항목 폼과 쿼리 작성기의 필드 목록에서 선택 가능한 값입니다. 목록의 값뿐만 아니라 다른 값도 입력할 수 있습니다.

PROHIBITEDVALUES 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 현재 필드에 이 목록의 값이 포함될 수 없도록 지정합니다.

DEFAULT 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 이 요소가 현재 필드의 기본값을 지정하도록 지정합니다.

COPY 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 세 번째 필드의 값이 현재 필드에 자동으로 복사되도록 지정합니다. COPY 요소에서 세 번째 필드를 지정합니다.

SERVERDEFAULT 요소(작업 항목 형식 정의 스키마)

선택적 요소입니다.

field 특성으로 식별되는 필드에 지정된 값이 있는 경우 현재 필드에서 지정된 서버 구성 요소의 값을 사용하도록 지정합니다. 서버 구성 요소는 작업 항목이 업데이트되는 시간을 나타내는 clock과 작업 항목을 업데이트한 ID를 나타내는 currentuser입니다.

부모 요소

요소

설명

FIELD 요소(작업 항목 형식 정의 스키마)

필수 요소입니다.

작업 항목 필드 정의 및 해당 필드에 적용되는 규칙과 조건을 참조합니다. 참조는 해당 부모 요소인 FIELDS를 자식 요소로 갖고 있는 STATE, TRANSITION, DEFAULTREASON 또는 REASON 요소를 기반으로 합니다.

FIELD 요소(WORKITEMTYPE 요소)

필수 요소입니다.

작업 항목 필드를 정의하고 해당 필드에 적용되는 규칙과 조건을 지정합니다.

설명

WHEN은 FIELD(작업 항목 형식 정의 스키마) 및 FIELD(WORKITEMTYPE 요소)의 선택적 자식 요소입니다.

예제

<WHEN field="field reference name" value="value">
    <REQUIRED>…</REQUIRED>
    <READONLY>…</READONLY>
    <EMPTY>…</EMPTY>
    <FROZEN>…</FROZEN>
    <CANNOTLOSEVALUE>…</CANNOTLOSEVALUE>
    <NOTSAMEAS>…</NOTSAMEAS>
    <VALIDUSER>…</VALIDUSER>
    <ALLOWEXISTINGVALUE>…<ALLOWEXISTINGVALUE>
    <MATCH>…</MATCH>
    <ALLOWEDVALUES>…</ALLOWEDVALUES>
    <SUGGESTEDVALUES>…</SUGGESTEDVALUES>
    <PROHIBITEDVALUES>…</PROHIBITEDVALUES>
    <DEFAULT>…</DEFAULT>
    <COPY>…</COPY>
    <SERVERDEFAULT>…</SERVERDEFAULT>
</WHEN>

요소 정보

네임스페이스

https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef

스키마 이름

작업 항목 형식 정의

유효성 검사 파일

WorkItemTypeDefinition.xsd

요소 형식

FieldValueCondition 복합 형식(작업 항목 형식 정의 스키마)

비워 둘 수 있음

아니요

참고 항목

기타 리소스

작업 항목 형식 정의 스키마

필드 조건