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, est 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.

Voir plus de détails sur les Tâches dans une étape

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 envoie le document.

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 consitituer 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 (partie Requêtes associées).

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, si elle est remplie, le passage à la prochaine étape correspondante est enclenché
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

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.

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