TRANSITION (élément XML)

Article
11/18/2015

L'élément TRANSITION permet de spécifier une progression ou une régression valide entre deux états pour un type d'élément de travail. L'élément TRANSITION est un élément enfant obligatoire de l'élément TRANSITIONS.

Pour modifier le flux de travail, vous modifiez la définition d'un type d'élément de travail. Consultez Modifier ou ajouter un type d'élément de travail personnalisé (WIT).

Hiérarchie de schéma

TRANSITION

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
from	Obligatoire. Nom de l'état de départ de la transition de l'élément de travail.
to	Obligatoire. Nom de l'état cible de la transition de l'élément de travail.
for	attribut Transition ; Facultatif. Nom d'un utilisateur ou d'un groupe autorisé à effectuer la transition.
not	attribut Transition ; Facultatif. Nom d'un utilisateur ou d'un groupe qui n'est pas autorisé à effectuer la transition.

Éléments enfants

Élément	Description
ACTIONS	Facultatif. Définit une collection d'éléments ACTION qui définissent chacun une chaîne d'action pouvant être utilisée lors de l'appel de la méthode WorkItem.GetNextState pour obtenir l'état post-action de l'élément de travail.
REASONS	Obligatoire. Collection d'éléments DEFAULTREASON et REASON définissant des raisons valides pour lesquelles l'élément de travail peut effectuer la transition.
FIELDS (Flux de travail)	Facultatif. Collection d'éléments FIELD (flux de travail) qui référencent les définitions de champ définies pour le type d'élément de travail.

Éléments parents

Élément	Description
TRANSITIONS	Obligatoire. Collection d'éléments TRANSITION définissant les transitions d'état valides pour le type d'élément de travail.

Notes

TRANSITION est un élément enfant obligatoire de TRANSITIONS.

Vous devez définir une seule transition pour déplacer l'élément de travail de l'état Aucun (from="") à un état nommé tel Actif. Cette transition identifie l'état par défaut d'un nouvel élément de travail.

minOccurs="1"

maxOccurs="unbounded"

Toutes les transitions valides entre deux états doivent être spécifiées. Si aucune transition n'est spécifiée, par défaut, aucune transition n'est autorisée.

En outre, vous pouvez éventuellement utiliser les attributs for et not dans l'élément de transition du flux de travail pour préciser les personnes qui peuvent et ne peuvent pas effectuer une transition. Dans ce cas, denies a la priorité sur allows. Si aucun de ces attributs n'est spécifié, n'importe qui peut modifier l'élément de travail.

De nombreux groupes sont pris en charge uniquement en créant un groupe parent et en spécifiant ce dernier dans l'élément TRANSITION. Pour plus d'informations sur les attributs for et not, voir Appliquer une règle à un champ d'élément de travail.

Exemple

Dans l'exemple suivant, les raisons sont définies pour la transition de l'état de flux de travail Actif à l'état Résolu.

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

Dans la règle suivante, la capacité à effectuer la transition d'un élément de travail de l'état Résolu à l'état Terminé est réservée à tous les testeurs de projets, à l'exception des nouveaux testeurs qui viennent de rejoindre l'équipe.

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

Voir aussi

Concepts

Modifier le flux de travail pour un type d'élément de travail

Partager via