Partager via

Référence de tous les éléments XML WORKFLOW

  • Article

Vous pouvez utiliser les informations de cette rubrique comme une référence rapide à tous les éléments et aux principaux attributs qui contrôlent le flux de travail d'un type d'élément de travail. Vous spécifiez ces éléments dans le conteneur d'éléments WORKFLOW, qui correspond à la seconde section principale de la définition d'un type d'élément de travail. Vous utilisez les éléments enfants STATES et TRANSITIONS pour définir les différents états qu'un utilisateur peut spécifier pour un type d'élément de travail, ainsi que les transitions autorisées entre les états. Pour plus d'informations sur la définition de ces éléments, consultez Modifier le flux de travail pour un type d'élément de travail.

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

Exemple d'élément WORKFLOW

L'exemple suivant illustre la structure globale de l'élément WORKFLOW. Vous spécifiez dans un conteneur STATES tous les états auxquels un utilisateur peut assigner en premier un type d'élément de travail. Ensuite, vous spécifiez toutes les transitions d'état autorisées. Chaque état correspond à un élément STATE, et chaque transition correspond à un élément TRANSITION. Dans chacun des éléments de conteneur STATES et TRANSITIONS, vous pouvez définir les états et les transitions dans l'ordre de votre choix.

Pour chaque transition, vous spécifiez un ensemble de raisons relatives à la modification de l'état de l'élément de travail, y compris une raison par défaut. Pour chaque état, transition ou raison, vous pouvez assigner des valeurs ou placer des conditions sur les valeurs d'un ou plusieurs champs en utilisant l'élément FIELD (Flux de travail). De plus, au cours d'une transition, vous pouvez déclencher l'exécution d'une action en spécifiant l'élément 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>

Structure de la syntaxe

Le tableau suivant décrit les éléments qui vous permettent de spécifier les états qu'un membre de l'équipe peut assigner à un élément de travail d'un type particulier. Dans la section WORKFLOW de la définition, vous commencez par définir des états, puis vous spécifiez des transitions. Pour plus d'informations, consultez Modifier le flux de travail pour un type d'élément de travail.

Élément

Description et syntaxe

Obligatoire ?

ACTION

Définit une chaîne de caractères correspondant à l'action à exécuter lorsque le système de suivi des éléments de travail appelle la méthode WorkItem.GetNextState pour obtenir l'état post-action de l'élément de travail.

<ACTION value="NameOfAction" />

Pour plus d'informations, consultez Automatiser les assignations des champs par état, transition ou raison

Facultatif

ACTIONS

Définit une collection d'éléments ACTION.

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

Facultatif

DEFAULTREASON

Définit la raison la plus courante pour laquelle un membre de l'équipe remplace un état donné d'un élément de travail par un autre état spécifique.

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

Obligatoire

FIELD

Spécifie un champ pour un type d'élément de travail, ainsi que les règles et conditions qui s'appliquent à ce champ quand un membre de l'équipe modifie l'état d'un élément de travail de ce type. En outre, cet élément indique la raison de la modification.

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

Pour plus d'informations, consultez Élément FIELD (Workflow).

Facultatif

FIELDS

Spécifie une collection d'éléments FIELD.

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

Facultatif

REASON

Définit une autre explication pour indiquer la raison pour laquelle un membre de l'équipe a modifié l'état d'un élément de travail.

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

Facultatif

REASONS

Collection composée d'un élément DEFAULTREASON et d'un élément REASON, qui expliquent la raison pour laquelle un membre de l'équipe a modifié l'état d'un élément de travail.

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

STATE

Définit un état valide pour le type d'élément de travail. Cet élément peut contenir un élément FIELDS qui fait référence aux règles et conditions qui s'appliquent à un champ spécifique quand un membre de l'équipe modifie l'état d'un élément de travail de ce type.

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

Obligatoire

STATES

Spécifie une collection d'éléments STATE qui définissent les états valides qu'un utilisateur peut assigner à un élément de travail de ce type.

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

Obligatoire

TRANSITION

Spécifie une progression ou une régression valide d'un état à un autre pour un type particulier d'éléments de travail.

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

Pour plus d'informations, consultez Élément TRANSITION.

Obligatoire

TRANSITIONS

Spécifie une collection d'éléments TRANSITION.

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

Obligatoire

WORKFLOW

Spécifie la collection d'éléments conteneurs STATES et TRANSITIONS qui définissent ensemble le flux de travail pour le type d'élément de travail.

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

Obligatoire

Voir aussi

Référence

Élément FIELD (Workflow)

Concepts

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