通过

All WORKFLOW XML 元素引用

  • 项目

本主题中提供的信息可用作有关控制工作项类型工作流的所有元素和主要特性的快速参考。可以在 WORKFLOW 元素容器（工作项类型定义的第二个主要部分）中指定这些元素。使用 STATES 和 TRANSITIONS 子元素定义用户可以为工作项类型选择的不同状态，以及允许执行哪种状态转换。有关如何定义这些元素的更多信息，请参见设计工作流。

主题内容

  • WORKFLOW 示例

  • WORKFLOW 元素的语法结构

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 元素的语法结构

通过使用下表中描述的元素，可以指定团队成员可为特定类型的工作项设置的状态。在定义的 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（工作流）元素

概念

设计工作流

其他资源

定义和自定义工作项工作流