TRANSITION (élément XML)
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 |
---|---|
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. |
|
Obligatoire. Collection d'éléments DEFAULTREASON et REASON définissant des raisons valides pour lesquelles l'élément de travail peut effectuer la transition. |
|
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 |
---|---|
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, consultez 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