Outils pour utilisateurs
Ceci est une ancienne révision du document !
Table des matières
DOCUMENTATION
TUTORIAUX
REFERENCES
Liste des status d'une tâche :
| Status | Définition |
|---|---|
| NEW | Nouvelle pochette |
| EVALUATE | Pochette à évaluer |
| EXECTASK | |
| PENDING | |
| TOCHECK |
Tâches
| Désignation | Description | Script | Exemple | |
|---|---|---|---|---|
| MAJ de champ | Affecte une nouvelle valeur à un champ. Cette valeur peut être fixe(écrite “en dur”) ou dynamique (issue d'un autre champ ou d'un paramètre d'une étape précédente) | @TABLE_CHAMP=<valeur|@parametre|@TABLE_CHAMP2> | @FACTURE_VALIDE=@validefact | |
| Attente | La tâche se met en attente (rien n'est effectuée) | nothing ou rien ou chaine vide | Utile pour bloquer le workflow à une étape en attente de réalisation d'une condition particulière | |
| Fin | Indique que la tâche doit mettre fin au workflow (maj WFBAG_STATUS=CLOSED). | end ou fin | ||
| Attacher des fichiers | Attache les 10 premiers documents issus d'une table en indiquant la valeur d'un de ses champs | attach:<table,champ,requete_id,valeur_du_champ> | ||
| Notification par mail | Envoi un email aux adresses spécifiées (séparées par une virgule ou un point virgule). Le mail contient un lien vers ezged et redirige vers la tâche. | email:<adresse_email1[(,|;)adresse_email2 …]> | email:florian@ezdev.fr,arnaud@ezdev.fr | |
| Envoi des fichiers par mail | Envoi des documents de la pochette par email | ermailf:florian@ezdev.fr,arnaud@ezdev.fr | emailf:<adresse_email1[(,|;)adresse_email2 …]> | |
| Envoi dans la bannette | Envoi des documents de la pochette par bannette | bannette:<id_expediteur>,<groupe ou utilisateur, …> | bannette:1,Commerciaux,fabrice (Envoi au groupe des commerciaux + utilisateur fabrice) | |
| Incrémenter un entier | Ajoute à la valeur du champ @CHAMP la valeur entière valeurX | incr:@CHAMP:<valeurX> | incr:@FACTURE_COMPTEUR:1 | |
| Executer script python | script::<script python> | Exécute le script python indiqué (chemin absolu ou relatif au répertoire des scripts). | SCRIPT::monscript.py |
MAJ de champ
La mise-à-jour de champ ne peut se faire que sur un champ présent sur la table principale de la requête à partir de laquelle le ou les documents sont rentrés dans le workflow.
Via texte fixe
Par texte fixe on entend du texte que vous saisissez “en dur” et qui ne provient ni d'un autre champ, ni d'un paramètre de tâche.
Un exemple de mise-à-jour de champ avec un texte libre
@FACTURE_STATUS = "Validation compta"
Via un champ
On peut mettre à jour un champ en lui affectant la valeur d'un autre champ. Les deux champs (celui à mettre à jour et celui duquel on récupère la valeur) doivent se trouver sur la même table. Et cette table DOIT être la table principale de la requête.
@FACTURE_LIB=@FACTURE_Fournisseur
La mise-à-jour d'un champ dans un autre va trouver son utilité si on l'a combine avec un texte fixe.
@FACTURE_LIB="Facture de " + @FACTURE_Fournisseur
script::
Les paramètres suivants (dans cet ordre) sont envoyés au script python qui est exécuté:
- instance : Le nom de l'instance (par défaut instance)
- jobqueueid : Le numéro du travail de type “Serveur de Workflow”.
- secusrid : L'ID de l'utilisateur auquel appartient le travail.
- WFBAG_ID : L'ID de la pochette de workflow.
- WTASK_ID : L'ID de la tâche qui est exécutée.
email:: et emailf::
L'adresse de l'expéditeur sera l'email de l'utilisateur ezged d'identifiant 1 (i.e admin dans la configuration de base).
Conditions
| Script | Description | Exemple |
|---|---|---|
| EVAL::<expression booléenne> | Evalue l'expression booléenne qui suit EVAL:: | EVAL::5>4 |
| SCRIPT::<script python> | Exécute le script python indiqué (chemin absolu ou relatif au répertoire des scripts). | SCRIPT::monscript.py |
| FLAGF::<parametre workflow> | ||
| FLAGT::<parametre workflow> | ||
| <expression python> | Evalue l'expression python en procédant à certaines substitutions de variables |
script::
Les paramètres suivants (dans cet ordre) sont envoyés au script python qui est exécuté:
- instance : Le nom de l'instance (par défaut instance)
- jobqueueid : Le numéro du travail de type “Serveur de Workflow”.
- secusrid : L'ID de l'utilisateur auquel appartient le travail.
- WFBAG_ID : L'ID de la pochette de workflow.
- WFCOND_ID : L'ID de la condition qui est évaluée.
Expression python
L'expression python sera ici une expression booléenne puisque l'objectif pour une condition est de retourner Vrai ou Faux (0 ou 1)
Notons qu'avant d'être évaluée l'expression python va éventuellement subir quelques substitutions.
Voici les variables qui peuvent être substituées :
@UN_CHAMP_DE_TABLE sera substitué par la valeur du champ.
@un_param_workflow sera substité par la valeur du paramètre workflow correspondant.
Si le champ est à NULL dans la base de donnée, python va récupérer la chaîne de caractère None Ainsi donc si vous souhaitez tester si le champ FACTFOUR_NUM est à NULL voici la condition à saisir:
@FACTFOUR_NUM == 'None'
