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 方法以获取工作项的操作后状态时要执行的操作。
有关更多信息,请参见基于状态、转换或原因自动进行字段赋值。 |
可选 |
ACTIONS |
定义 ACTION 元素的集合。
|
可选 |
DEFAULTREASON |
定义团队成员将工作项从一种特定状态更改为另一种特定状态的最常见原因。
|
必需 |
FIELD |
为某个类型的工作项指定一个字段,以及在团队成员更改该类型的工作项状态时将应用于该字段的规则和条件,并指定更改原因。
有关更多信息,请参见 FIELD(工作流)元素。 |
可选 |
FIELDS |
指定 FIELD 元素的集合。
|
可选 |
REASON |
定义团队成员更改工作项状态的原因的其他相关说明。
|
可选 |
REASONS |
一个包含 DEFAULTREASON 和可选 REASON 元素的集合,这些元素说明团队成员更改工作项状态的原因。
|
|
STATE |
定义工作项类型的有效状态。 此元素可包含一个 FIELDS 元素,该元素会引用在团队成员更改该类型的工作项的状态时将应用于特定字段的规则和条件。
|
必需 |
STATES |
指定一个 STATE 元素的集合,这些元素定义用户可为此类型的工作项分配的有效状态。
|
必需 |
TRANSITION |
为特定类型的工作项指定从一种状态到另一种状态的有效进度或回归。
有关更多信息,请参见 TRANSITION 元素。 |
必需 |
TRANSITIONS |
指定 TRANSITION 元素的集合。
|
必需 |
WORKFLOW |
指定包含 STATES 和 TRANSITIONS 容器元素的集合,这两个元素共同定义工作项类型的工作流。
|
必需 |
返回页首