Compartir a través de

Referencias de todos los elementos WORKFLOW de XML

  • Artículo

Puede usar la información que se proporciona en este tema como una referencia rápida de los elementos y los principales atributos que controlan el flujo de trabajo de un tipo de elemento de trabajo. Estos elementos se especifican en el contenedor de elemento WORKFLOW, la segunda sección principal de la definición de un tipo de elemento de trabajo. Los elementos secundarios TRANSITIONS y STATES se utilizan para definir los estados diferentes que un usuario puede especificar para un tipo de elemento de trabajo y qué transiciones se permiten entre estados. Para obtener más información acerca de cómo se definen estos elementos, vea Diseñar el flujo de trabajo.

En este tema

  • Ejemplo de WORKFLOW

  • Estructura de la sintaxis para los elementos de WORKFLOW

Ejemplo de WORKFLOW

En el siguiente ejemplo se muestra la estructura general del elemento WORKFLOW. Se especifican todos los estados que un usuario puede asignar primero a un tipo de elemento de trabajo en un contenedor STATES. Luego, se especifican todas las transiciones que se permiten de un estado a otro. Cada estado corresponde a un elemento STATE y cada transición corresponde a un elemento TRANSITION. Dentro de cada uno de los elementos contenedor TRANSITIONS y STATES, se pueden definir los estados y transiciones en la secuencia que se desee.

Para cada transición, se especifica un conjunto de razones para cambiar el estado del elemento de trabajo, incluida una razón predeterminada. Se pueden asignar valores para cada estado, transición o razón, y puede colocar las condiciones en los valores de más de un campo con el elemento FIELD (Workflow). Además, durante una transición, puede activar que se produzca una acción especificando el elemento 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>

Volver al principio

Estructura de la sintaxis para los elementos de WORKFLOW

Mediante los elementos que se describen en la siguiente tabla, puede especificar en qué estados puede establecer un miembro del equipo un elemento de trabajo de un tipo determinado. En la sección WORKFLOW de la definición, primero se definen los estados y, a continuación, las transiciones. Para obtener más información, vea Diseñar el flujo de trabajo.

Elemento

Descripción y sintaxis

¿Obligatorio?

ACTION

Define una cadena de texto que se corresponde con una acción que se realizará cuando el sistema para seguimiento de elementos de trabajo llame al método WorkItem.GetNextState con el fin de obtener el estado posterior a la acción del elemento de trabajo.

<ACTION value="NameOfAction" />

Para obtener más información, vea Automatizar las asignaciones de campo en función del estado, la transición o la razón

Opcional

ACTIONS

Define una colección de elementos ACTION.

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

Opcional

DEFAULTREASON

Define la causa más común por la que un miembro cambia un elemento de trabajo de un estado determinado a otro estado determinado.

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

Obligatorio

FIELD

Especifica un campo para un tipo de elemento de trabajo, y las reglas y condiciones que se aplicarán a ese campo cuando un miembro del equipo cambie el estado de un elemento de trabajo de ese tipo y especifique el motivo del cambio.

<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>

Para obtener más información, vea FIELD (Workflow) (elemento).

Opcional

FIELDS

Especifica una colección de elementos de FIELD.

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

Opcional

REASON

Define una explicación adicional sobre el motivo por el cual un miembro del equipo cambió el estado de un elemento de trabajo.

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

Opcional

REASONS

Colección de un elemento DEFAULTREASON y otros elementos REASON opcionales que explican los motivos por los que un miembro del equipo cambió el estado de un elemento de trabajo.

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

STATE

Define un estado válido para el tipo de elemento de trabajo. Este elemento puede contener un elemento FIELDS, que hace referencia a las reglas y condiciones que se aplicarán a un campo concreto cuando un miembro del equipo cambie el estado de un elemento de trabajo de ese tipo.

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

Obligatorio

STATES

Especifica una colección de elementos STATE que definen los estados válidos a los que un usuario puede asignar un elemento de trabajo de ese tipo.

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

Obligatorio

TRANSITION

Especifica una progresión o regresión válida de un estado a otro estado para elementos de trabajo de un tipo concreto.

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

Para obtener más información, vea TRANSITION (Elemento).

Obligatorio

TRANSITIONS

Especifica una colección de elementos de TRANSITION.

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

Obligatorio

WORKFLOW

Especifica la colección de elementos contenedores STATES y TRANSITIONS que en su conjunto definen el flujo de trabajo del tipo de elemento de trabajo.

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

Obligatorio

Volver al principio

Vea también

Referencia

FIELD (Workflow) (elemento)

Conceptos

Diseñar el flujo de trabajo

Otros recursos

Definir y personalizar el flujo de trabajo de los elementos de trabajo