다음을 통해 공유

모든 WORKFLOW XML 요소 참조

  • 아티클

이 항목의 정보를 작업 항목 형식의 워크플로를 제어하는 모든 요소와 주요 특성에 대한 빠른 참조로 사용할 수 있습니다. 작업 항목 형식 정의의 두 번째 주요 섹션인 WORKFLOW 요소 컨테이너에서 이러한 요소를 지정합니다. STATES 및 TRANSITIONS 자식 요소를 사용하여 사용자가 작업 항목 형식에 대해 지정할 수 있는 여러 상태와 상태 간에 허용되는 전환을 정의합니다. 이러한 요소를 정의하는 방법에 대한 자세한 내용은 작업 항목 형식의 워크플로 변경을 참조하세요.

워크플로를 수정하려면 작업 항목 형식의 정의를 수정합니다. 사용자 지정 작업 항목 형식 수정 또는 추가(WIT)을 참조하세요.

WORKFLOW 예제

다음 예제에서는 WORKFLOW 요소의 전체 구조를 보여 줍니다. STATES 컨테이너 내에서 사용자가 작업 항목 형식을 처음 할당할 수 있는 모든 상태를 지정합니다. 그런 다음 상태 간에 허용되는 모든 전환을 지정합니다. 각 상태는 STATE 요소에 해당하며 각 전환은 TRANSITION 요소에 해당합니다. 각 STATES 및 TRANSITIONS 컨테이너 요소 내에서 상태와 전환을 원하는 순서로 정의할 수 있습니다.

각 전환에 대해 기본 이유를 포함하여 작업 항목 상태를 변경하는 이유 집합을 지정합니다. 각 상태, 전환, 이유에 대해 값을 할당할 수 있으며 FIELD(워크플로) 요소를 사용하여 필드 하나 이상의 값에 조건을 적용할 수 있습니다. 또한 ACTION 요소를 지정하여 전환 중에 수행할 작업을 트리거할 수 있습니다.

<WORKFLOW>
<STATES>
  <STATE value="Active">
    <FIELDS> . . . </FIELDS>
  </STATE>
  <STATE value="Resolved">
    <FIELDS> . . . </FIELDS>
  </STATE>
  <STATE value="Closed" />
</STATES>
<TRANSITIONS>
  <TRANSITION from="" to="Active">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
    <FIELDS> . . . </FIELDS>
  </TRANSITION>
  <TRANSITION from="Active" to="Resolved">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
    <ACTIONS > . . . </ACTIONS >
</TRANSITION>
<TRANSITION from="Resolved" to="Closed">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
    <ACTIONS > . . . </ACTIONS >
</TRANSITION>
<TRANSITION from="Resolved" to="Active">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
<TRANSITION from="Active" to="Closed ">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
<TRANSITION from="Closed" to="Active">
    <REASONS> . . . </REASONS>
    <FIELDS> . . . </FIELDS>
</TRANSITION>
</TRANSITIONS>
</WORKFLOW>

구문 구조

다음 표에서 설명하는 요소를 사용하여 팀 멤버가 특정 형식의 작업 항목을 어떤 상태로 설정할 수 있는지 지정할 수 있습니다. 정의의 WORKFLOW 섹션에서 상태를 먼저 정의한 다음 전환을 정의합니다. 자세한 내용은 작업 항목 형식의 워크플로 변경을 참조하십시오.

요소

설명 및 구문

필수 여부

ACTION

작업 항목 추적을 위한 시스템이 WorkItem.GetNextState 메서드를 호출하여 작업 항목의 작업 후 상태를 가져올 때 수행할 작업에 해당하는 텍스트 문자열을 정의합니다.

<ACTION value="NameOfAction" />

자세한 내용은 상태, 전환 또는 이유를 기반으로 필드 할당 자동화을 참조하세요.

선택적

ACTIONS

ACTION 요소의 컬렉션을 정의합니다.

<ACTIONS>
   <ACTION>. . . </ACTION>
</ACTIONS>

선택적

DEFAULTREASON

팀 멤버가 작업 항목의 상태를 변경하는 가장 일반적인 이유를 정의합니다.

<DEFAULTREASON value="ValueOfDefaultReason">
   <FIELDS>. . . </FIELDS>
</DEFAULTREASON>

필수

FIELD

작업 항목 형식의 필드와, 팀 멤버가 해당 형식의 작업 항목 상태를 변경하고 변경 이유를 지정할 때 해당 필드에 적용할 규칙과 조건을 지정합니다.

<FIELD refname="FieldReferenceName">
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
<FIELD>

자세한 내용은 FIELD(워크플로) 요소을 참조하십시오.

선택적

FIELDS

FIELD 요소의 컬렉션을 지정합니다.

<FIELDS>
   <FIELD . . . </FIELD>
</FIELDS>

선택적

REASON

팀 멤버가 작업 항목 상태를 변경한 이유에 대한 추가 설명을 정의합니다.

<REASON value="NameOfReason">
   <FIELDS>. . . </FIELDS>
</REASON>

선택적

REASONS

팀 멤버가 작업 항목 상태를 변경한 이유를 설명하는 DEFAULTREASON 하나와 선택적 REASON 요소의 컬렉션입니다.

<REASONS>
   <DEFAULTREASON>. . . </DEFAULTREASON>
   <REASON>. . . </REASON>
</REASONS>

STATE

작업 항목 형식의 유효한 상태를 정의합니다. 이 요소는 팀 멤버가 특정 형식의 작업 항목 상태를 변경할 때 특정 필드에 적용할 규칙과 조건을 참조하는 FIELDS 요소를 포함할 수 있습니다.

<STATE value="NameOfState">
  <FIELDS>. . . </FIELDS>
</STATE>

필수

STATES

사용자가 특정 형식의 작업 항목에 할당할 수 있는 유효한 상태를 정의하는 STATE 요소 컬렉션을 지정합니다.

<STATES>
   <STATE>. . . </STATE>
</STATES>

필수

TRANSITION

특정 형식의 작업 항목에 대한 상태 간의 유효한 진행 또는 회귀를 지정합니다.

<TRANSITION from="NameOfStartingState" 
   to="NameOfEndingState" 
   for="UserOrGroupName"
   not="UserOrGroupName">
   <ACTIONS>. . . </ACTIONS>
   <REASONS>. . . </REASONS>
   <FIELDS>. . . </FIELDS>
</TRANSITION>

자세한 내용은 TRANSITION 요소를 참조하세요.

필수

TRANSITIONS

TRANSITION 요소의 컬렉션을 지정합니다.

<TRANSITIONS>
    <TRANSITION>. . . </TRANSITION>
</TRANSITIONS>

필수

WORKFLOW

작업 항목 형식의 워크플로를 정의하는 STATES 및 TRANSITIONS 컨테이너 요소의 컬렉션을 지정합니다.

<WORKFLOW>
   <STATES>. . . </STATES>
   <TRANSITIONS>. . . </TRANSITIONS>
</WORKFLOW>

필수

참고 항목

참조

FIELD(워크플로) 요소

개념

작업 항목 형식의 워크플로 변경