Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
workflow [2017/01/12 10:34] florian |
workflow [2023/07/21 12:29] (Version actuelle) jeremy [Exécuté en tant que] |
||
---|---|---|---|
Ligne 6: | Ligne 6: | ||
====== REFERENCES ====== | ====== REFERENCES ====== | ||
+ | |||
+ | ===== Tâches ===== | ||
Liste des status d'une tâche : | Liste des status d'une tâche : | ||
Ligne 15: | Ligne 17: | ||
| TOCHECK | | | | 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 documents issus d'une table en indiquant la valeur d'un de ses champs (max 10 documents)| 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 | | ||
- | ^ Script ^ Description ^ Exemple ^ | + | ==== MAJ de champ ==== |
- | | SCRIPT::<script python> | Exécute le script python indiqué (chemin absolu ou relatif au répertoire des scripts). | SCRIPT::monscript.py | | + | 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. |
- | | nothing //ou// rien | La tâche n'effectue rien et passe à la suivante.| | | + | |
- | | end //ou// fin | Indique que la tâche doit mettre fin au workflow (maj WFBAG_STATUS=CLOSED) . | + | |
- | | attach::<table,champ,requete_id,valeur_du_champ> | Attache les 10 premiers documents issus d'une table en indiquant la valeur d'un de ses champs | | | + | |
- | | email:<adresse_email1[(,%%|%%;)adresse_email2 ...]> | 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:florian@ezdev.fr,arnaud@ezdev.fr | | + | |
- | | emailf:<adresse_email1[(,%%|%%;)adresse_email2 ...]> | Envoi des documents de la pochette par email | ermailf:florian@ezdev.fr,arnaud@ezdev.fr | | + | |
- | | bannette:<id_expediteur>,<groupe ou utilisateur, ...> | Envoi des documents de la pochette par bannette | bannette:1,Commerciaux,fabrice (Envoi au groupe des commerciaux + utilisateur fabrice)| | + | |
- | | incr:@CHAMP:<valeurX> | Ajoute à la valeur du champ @CHAMP la valeur entière //valeurX// | incr:@FACTURE_COMPTEUR:1 | | + | |
- | | <expression python> | Evalue l'expression python en procédant à certaines substitutions de variables | | | + | |
- | ==== SCRIPT:: ==== | + | On peut utiliser les macros suivantes : |
+ | * @now | ||
+ | * @userid | ||
+ | * @username | ||
+ | |||
+ | === 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 | ||
+ | |||
+ | === Via un paramètre === | ||
+ | Fonctionnement similaire à la mise-à-jour via un champ sauf que l'on référence un paramètre d'une tâche de workflow. | ||
+ | |||
+ | @FACTURE_VALIDE=@factvalid | ||
+ | |||
+ | Ici on met à jour le champ //FACTURE_VALIDE// avec la valeur du paramètre //factvalid// qui aura été précédemment (i.e lors d'une étape précédente) saisie par un utilisateur. | ||
+ | |||
+ | ==== script:: ==== | ||
Les paramètres suivants (dans cet ordre) sont envoyés au script python qui est exécuté: | Les paramètres suivants (dans cet ordre) sont envoyés au script python qui est exécuté: | ||
Ligne 37: | Ligne 66: | ||
- WTASK_ID : L'ID de la tâche qui est exécutée. | - WTASK_ID : L'ID de la tâche qui est exécutée. | ||
- | ==== Expression python ==== | + | ==== 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). | ||
- | Pour une tâche une expression python consistera en une affectation de valeur. | ||
===== Conditions ===== | ===== Conditions ===== | ||
Ligne 50: | Ligne 82: | ||
| <expression python> | Evalue l'expression python en procédant à certaines substitutions de variables | | | | <expression python> | Evalue l'expression python en procédant à certaines substitutions de variables | | | ||
- | ==== SCRIPT:: ==== | + | ==== script:: ==== |
Les paramètres suivants (dans cet ordre) sont envoyés au script python qui est exécuté: | Les paramètres suivants (dans cet ordre) sont envoyés au script python qui est exécuté: | ||
Ligne 71: | Ligne 103: | ||
Ainsi donc si vous souhaitez tester si le champ FACTFOUR_NUM est à NULL voici la condition à saisir: | Ainsi donc si vous souhaitez tester si le champ FACTFOUR_NUM est à NULL voici la condition à saisir: | ||
@FACTFOUR_NUM == 'None' | @FACTFOUR_NUM == 'None' | ||
+ | | ||
+ | Les champs qui peuvent être référencés sont: | ||
+ | * Les champs sélectionnés par la requête à partir de laquelle le ou les documents auront été ajouté à la pochette de workflow. | ||
+ | * Tout les champs de la table principale de la requête source. | ||
+ | |||
+ | ==== Exécuté en tant que ==== | ||
+ | Cette fonctionnalité permet d'exécuter une requête avec un identifiant utilisateur autre qu'admin. | ||
+ | |||
+ | Pour l'utiliser, il faut paramétrer un Valideur ID sur la tâche du workflow. | ||
+ | Paramètre de la tâche > cliquez sur le bouton + > cliquez sur Paramètre ID valideur. | ||
+ | |||
+ | {{:1.png?400|}} | ||
+ | |||
+ | Une fois le formulaire renseigné, retournez sur l'étape du scénario, dans la liste des conditions, renseignez une condition et dans la colonne "Exécuté en tant que" saisissez le nom de la variable qui représentera l'identifiant du valideur. | ||
+ | |||
+ | {{:2.png?400|}} | ||
+ |