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 du 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 Conception du workflow.

Dans cette rubrique

  • Exemple d'élément WORKFLOW

  • Structure de la syntaxe des éléments WORKFLOW

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 qu'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 de 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>

Retour au début

Structure de la syntaxe des éléments WORKFLOW

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 Conception du workflow.

É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 Automatisation des 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 lorsqu'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 lorsqu'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 conteneur 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

Retour au début

Voir aussi

Référence

Élément FIELD (Workflow)

Concepts

Conception du workflow

Autres ressources

Définition et personnalisation du flux de travail des éléments de travail