Outils pour utilisateurs
Table des matières
Présentation > Workflow
Introduction au Workflow
Le workflow est la zone permettant de créer des ensembles de tâches pour manipuler des documents (et éventuellement des informations) au sein de EzGED. Il est possible de créer ainsi des processus avec lesquels les utilisateurs peuvent intéragir.
Liens rapides :
Pour se faire, le workflow contient des scénarios qui sont un ensemble de tâches organisées dans des étapes.
Vous pouvez ajouter dans un scénario, autant d'étapes que nécessaires. Et dans ces étapes, vous pouvez ajouter autant de tâches automatiques que nécessaires.
Paramètres et propriétés d'un scénario de workflow
Chaque scénario peut contenir au moins une étape, et, doit être associé à au moins une requête.
Etapes
Un scénario peut être composé d'autant d'étapes que nécessaire.
Pour fonctionner, un scénario doit contenir une étape de départ, pensez donc à cocher la case de la première étape.
Chaque étape peut être composées d'autant de tâches que nécessaire, exécutées suivant leur rang attribué (colonne de droite).
MAIS
Chaque étape peut contenir une unique tâche d'Intervention humaine.
Requêtes associées
Un scénario peut être relié à plusieurs requêtes.
Les requêtes associées au scénario sont celles depuis laquelle un utilisateur peut envoer le document dans le scénario.
Requêtes associées : requête affichée par défaut
Lorsque l'utilisateur interagira avec une des étapes du scénario, un formulaire se présentera à lui. La requête affichée par défaut est celle dont les champs peuvent constituer ce formulaire.
Champs à afficher
Il s'agit des champs qui vont constituer le formulaire.
Lorsque l'utilisateur interagira avec une des étapes du scénario, un formulaire se présentera à lui. La requête affichée par défaut est celle dont les champs peuvent constituer ce formulaire.
Donc s'il y a une tâche d'intervention humaine, pensez à cocher la case “Requête d'affichage par défaut” pour afficher les champs de cette requête dans la grille des Requêtes associées au-dessus.
Tâches dans une étape
Il existe deux types de tâches :
- Automatique : autant de tâches automatiques que vous avez besoin
- Intervention Humaine : une au maximum par étape
Chaque étape peut être composées d'autant de tâches que nécessaire, exécutées suivant leur rang attribué (colonne de droite), donc exécutées dans l'ordre des rangs.
Remarque : Chaque étape peut contenir une unique tâche d'Intervention humaine.
Remarque : si l'étape contient une tâche automatique de fin, les tâches suivantes seront ignorées et l'étape se finalisera.
Liste des tâches automatiques disponibles
| Désignation | Description | Script résultat | Commentaire |
|---|---|---|---|
| Mise à jour 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émentation | Ajoute à la valeur du champ @CHAMP la valeur entière valeurX | incr:@CHAMP:<valeurX> | incr:@FACTURE_COMPTEUR:1 |
| Script externe Python | script::<script python> | Exécute le script python indiqué (chemin absolu ou relatif au répertoire des scripts). | SCRIPT::monscript.py |
Liste des Conditions
Les conditions sont évaluées dans l'ordre dans lequel elles apparaissent. La première condition qui est satisfaite (vraie) déclenche le passage à l'étape suivante associée. Donc les conditions qui suivent ne seront pas évaluées.
Ajouter une condition
- Description
- condition : la condition de validité fonctionne comme un test (un if) en programmation
- prochaine étape : pour choisir l'étape suivante une fois la condition valide
Assistant de construction de condition
Dans cet assistant :
- Zone de texte (zone en haut) ou va apparaitre votre condition
- Liste des champs de la requête : (tous les champs des requêtes associées à l'étape), si aucune requête est associé au scénario, vous ne verrez aucun champ
- Liste des opérateurs disponibles
- Liste des Liste des paramètres disponibles : si vous les avez créé, les paramètres de l'étape d'intervention humaine apparaissent ici. si l'étape contient une étape d'intervention humaine, pour les créer, il suffit d'aller dans les détails de l'étape d'intervention humaine
Exemples de conditions :
- @FLDX == “valeur constante” ; dans le cas d'un champs comparé à une valeur constante
- @FLDX == @valeur; cas d'un champs comparé à une valeur dynamique (paramètre de type Liste)
- @valid == 1; (ou 0) dans le cas d'une case à cocher (paramètre de type booléen)
- @unchamps >= 456 AND @unautrechamps != “cette valeur”
Tâche : Intervention humaine
Propriétés
- Paramètres : Voir la partie suivante
- Acteurs : interface de gestion des droits ; les acteurs dans la liste de droite ont droit d'interagir avec cette étape dans l'interface utilisateur > Workflow
Paramètres
C'est les champs qui vont apparaitre à l'utilisateur qui décide d'agir sur un document présent dans cette étape depuis l'interface user.
Deux grandes catégories :
- Paramètre ; donc numérique, booléen, …
- Paramètre de type liste ; qui permet de proposer une liste de choix à l'utilisateur, choix récupérés depuis une table
Dans l'interface admin des params :
- Description : libellé du champs qui apparait à l'utilisateur
- alias : l'acteur interagit d'une façon ou d'une autre avec le champs, une fois le formulaire soumis, la réponse donnée par l'acteur sur ce champs est placée dans l'alias. Cette variable peut être utilisée dans La Liste des conditions au niveau de l'étape
