Assertions
Cette catégorie contient toutes actions qui consistent à vérifier l’état de la tâche et des données avant de continuer. Ces opérations sont non critiques, c.a.d que si elles échouent, le processus est annulé sans erreur. Chaque action possède u nmessage qui sera affiché à l’utilisateur, le but étant de lui faire comprendre pourquoi le processus ne continue pas. Ces actions sont généralement en amont des traitements.
Vérifier la valeur d'un datafield
L’action assert_datafield_has_value permet de vérifier qu’un datafield possède une valeur non nulle qui, si elle est précisée, doit correspondre exactement à la demande.
<action type="assert_datafield_has_value" datafieldId="CRMPRJ.ID_PK"><![CDATA[La clé de l'evenement n'est pas précisée]]></action>
Dans ce cas, le processus s’arrète avec le message fourni si le datafield CRMPRJ.ID_PK n’a pas de valeur
<action type="assert_datafield_has_value" datafieldId="CRMPRJ.ID_PK" value="15-00003"><![CDATA[La clé n'a pas la bonne valeur. Elle devrait être 15-00003]]></action>
Dans ce cas, le processus s’arrète avec le message fourni si le datafield CRMPRJ.ID_PK n’a pas la valeur 15-00003.
datafieldId : string
L’identifiant du datafield qui va être testé
value : string
La valeur attendue de ce datafield
message : text node
Le message à afficher à l’utilisateur si la vérification échoue
Aucun output particulier pour cette action
Vérifier le statut de la tâche
L’action assert_task_state permet de vérifier que la tâche est dans le bon mode de saisie. En effet, beaucoup de traitements n’ont pas le droit d’être lancés si la tâche est en train d’être modifiée, supprimée, etc…
<action type="assert_task_state" state="normal"><![CDATA[Veuillez valider les modifications de la page avant de continuer]]></action>
Le processus ne pourra pas continue dans ce cas si l’utilisateur est en train de créer, a fait une modification, ou est en train de supprimer une entrée. Ceci garantit dans ce cas que les données affichées sont bien en phase avec les données de la base.
state : string
L’état dans lequel la tâche doit être. Les valeurs possibles sont
- new L’utilisateur est en train de créer une entrée/page
- modify L’utilisateur est en train de modifier une entrée/page
- delete L’utilisateur est en train de supprimer une entrée/page
- normal L’utilisateur n’a pas touché aux données
- deletevirtual Dans le cas d’une saisie en grille. L’utilisateur supprime une ligne de données qui n’est pas encore mise en ligne.
message : text node
Le message à afficher à l’utilisateur si l’état de la tâche n’est pas celui précisé
Aucune variable du contexte n’est ajoutée ou modifiée lors de cette action