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, que es la segunda y última sección principal de la definición de un tipo de elemento de trabajo. Los elementos secundarios STATES y TRANSITIONS se usan para definir los diferentes estados que un usuario puede especificar para un tipo de elemento y establecer qué transiciones se permiten entre estados. Para obtener más información sobre cómo definir estos elementos, vea el tema Cambiar el flujo de trabajo de un tipo de elemento de trabajo.

Para modificar el flujo de trabajo, modifique la definición de un tipo de elemento de trabajo. Vea Modificar o agregar un tipo de elemento de trabajo (WIT) personalizado.

Ejemplo de WORKFLOW

En el siguiente ejemplo se muestra la estructura general del elemento WORKFLOW. Especifique todos los estados a los que un usuario puede asignar primero un tipo de elemento de trabajo dentro de un contenedor STATES. A continuación, especifique todas las transiciones de un estado a otro que se permiten. Cada estado se corresponde con un elemento STATE y cada transición se corresponde con un elemento TRANSITION. Dentro de cada elemento contenedor STATES y TRANSITIONS, puede definir los estados y las transiciones en el orden que desee.

Para cada transición, especifique un conjunto de motivos para cambiar el estado del elemento de trabajo, incluido un motivo predeterminado. Puede asignar valores para cada estado, transición o motivo, y puede definir condiciones en los valores de uno o más campos mediante el elemento FIELD (flujo de trabajo). Además, puede especificar el elemento ACTION para desencadenar una acción que se producirá durante una transición.

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

Estructura de sintaxis

Mediante los elementos que se describen en la tabla siguiente, puede especificar en qué estados un miembro del equipo puede establecer un elemento de trabajo de un tipo determinado. En la sección WORKFLOW de la definición, defina primero estados y, a continuación, defina las transiciones. Para obtener más información, vea Cambiar el flujo de trabajo de un tipo de elemento 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 de seguimiento de elementos de trabajo llame al método WorkItem.GetNextState para obtener el estado posterior a la acción del elemento de trabajo.

<ACTION value="NameOfAction" />

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

Opcional

ACTIONS

Define una colección de elementos ACTION.

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

Opcional

DEFAULTREASON

Define el motivo más común por el que un miembro del equipo cambia un elemento de trabajo de un determinado estado a otro.

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

Requerido

FIELD

Especifica un campo para un tipo de elemento de trabajo, especifica 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 especifica un motivo para el 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 Referencia de elementos FIELD (flujo de trabajo).

Opcional

FIELDS

Especifica una colección de elementos de FIELD.

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

Opcional

REASON

Define una explicación adicional de por qué un miembro del equipo ha cambiado el estado de un elemento de trabajo.

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

Opcional

REASONS

Colección de un elemento DEFAULTREASON y elementos REASON opcionales que explican por qué un miembro del equipo ha cambiado 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 específico cuando un miembro del equipo cambie el estado de un elemento de trabajo de ese tipo.

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

Requerido

STATES

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

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

Requerido

TRANSITION

Especifica una progresión o regresión válidas de un estado a otro de los elementos de trabajo de un tipo determinado.

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

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

Requerido

TRANSITIONS

Especifica una colección de elementos de TRANSITION.

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

Requerido

WORKFLOW

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

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

Requerido

Vea también

Referencia

Referencia de elementos FIELD (flujo de trabajo)

Conceptos

Cambiar el flujo de trabajo de un tipo de elemento de trabajo