TRANSITION (elemento XML)

Artículo
11/18/2015

Use el elemento TRANSITION para especificar una progresión o regresión válidas de un estado a otro para un tipo de elemento de trabajo. El elemento TRANSITION es un elemento secundario obligatorio del elemento TRANSITIONS.

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.

Jerarquía del esquema

TRANSITION

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
from	Requerido. Nombre del estado desde el que está pasando el elemento de trabajo.
to	Requerido. Nombre del estado desde al que está pasando el elemento de trabajo.
for	Atributo Transition. Opcional. Nombre de un usuario o grupo con permiso para realizar la transición.
not	Atributo Transition. Opcional. Nombre de un usuario o grupo sin permiso para realizar la transición.

Elementos secundarios

Elemento	Descripción
ACTIONS	Opcional. Define una colección de elementos ACTION que definen, cada uno, una cadena de acción que puede usarse al llamar al método WorkItem.GetNextState para obtener el estado posterior a la acción del elemento de trabajo.
REASONS	Requerido. Colección de elementos DEFAULTREASON y REASON que definen los motivos válidos por los que el elemento de trabajo puede completar la transición.
FIELDS (Flujo de trabajo)	Opcional. Colección de elementos FIELD (Flujo de trabajo) que hacen referencia a las definiciones de campo especificadas para el tipo de elemento de trabajo.

Elementos primarios

Elemento	Descripción
TRANSITIONS	Requerido. Colección de elementos TRANSITION que definen las transiciones de estado válidas para el tipo de elemento de trabajo.

Comentarios

TRANSITION es un elemento secundario obligatorio de TRANSITIONS.

Debe definir exactamente una transición para mover el elemento de trabajo de nada (from= "") a un estado con nombre, como Activo. Esta transición identifica el estado predeterminado de un nuevo elemento de trabajo.

minOccurs="1"

maxOccurs="unbounded"

Se deben especificar todas las transiciones válidas entre dos estados. Si no se especifica ninguna transición, entonces, de forma predeterminada, no se permitirá ninguna transición.

Además, puede usar si lo desea los atributos for y not en el elemento de transición del flujo de trabajo para delimitar quién puede y quién no puede realizar una transición. Al hacerlo, denies tiene prioridad sobre allows. Si no se especifica ninguno de estos atributos, cualquiera puede modificar el elemento de trabajo.

Solo se admiten varios grupos si se crea un grupo primario y se especifica ese grupo primario en el elemento TRANSITION. Para obtener más información sobre los atributos for y not, consulte Aplicar una regla a un campo de elemento de trabajo.

Ejemplo

En el ejemplo siguiente se definen los motivos para la transición desde el estado de flujo de trabajo Active a Resolved.

<TRANSITION from="Active" to="Resolved">
   . . .
   <REASONS>
      <DEFAULTREASON value="Fixed"/>
      <REASON value="Deferred"/>
      <REASON value="Duplicate"/>
      <REASON value="As Designed"/>
      <REASON value="Unable to Reproduce"/>
      <REASON value="Obsolete"/>
   </REASONS>
   . . .
</TRANSITION>

En la regla siguiente, la capacidad de realizar la transición de un elemento de trabajo desde el estado Resolved a Complete está restringida para todos los evaluadores del proyecto, excepto para los que se acaban de unir el equipo.

<TRANSITION from="Resolved" to="Complete" for="[project]\AllTesters" not="[project]\NewTesters">
</TRANSITION>

Vea también

Conceptos

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