Moniteur Workflow
Le moniteur Workflow permet de présenter les événements en attente de signature par un utilisateur donné. Cette présentation, paramétrable par transaction, peut se faire sur un ou plusieurs onglets. A partir de chaque événement, on peut visualiser des informations relatives au contexte de déclenchement, aux messages envoyés, à l'historique des signatures. On peut également signer ou viser l'événement selon les cas.
Pré-requis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
La saisie dans le plan de travail se fait sur un nombre variable d'onglets, selon la transaction choisie. Sur chacun des onglets, on retrouve des informations qui peuvent être différentes, et paramétrées au cas par cas. De même, chacun des onglets peut faire apparaître tout ou partie des événements à traiter, la répartition se faisant selon des règles paramétrables. Enfin, une mise en valeur (par la couleur, par la taille de la police) et un tri des événements selon différents critères peut être réalisé au cas par cas.
En-tête
On saisit en tête de critères de filtrage globaux sur les événements à traiter, sachant que des filtres plus fins peuvent exister sur chaque onglet de la fonction.
Délégué exceptionnel (champ DELEXP) |
Lorsque cette case est cochée, l'utilisateur voit apparaître les notifications envoyées aux utilisateurs pour lesquels il possède une délégation exceptionnelle. Cette case ne peut être cochée que si l'utilisateur possède au moins une délégation de ce type. |
Destinataire (champ USER) |
Définit le code utilisateur destinataire des événements de Workflow en attente de signature que l'on désire voir. Il ne peut être saisi que dans deux cas :
Si ce champ ne peut pas être saisi, il est par défaut égal à la valeur courante de l'utilisateur. Si ce champ peut être saisi, mais qu'aucune valeur ne lui est donnée, les notifications suivantes peuvent être vues :
|
Date début (champ DATDEB) |
Si cette date est renseignée, seules les données dont la date de dernière modification ou la date de création est supérieure ou égale sont prises en compte dans le traitement. Il est à noter que, par défaut, la date proposée est la date du jour, diminuée d'un nombre de jours égal à la valeur du paramètre WRKDAY. |
Date fin (champ DATFIN) |
Si cette date est renseignée, seules les données dont la date de dernière modification ou la date de création est inférieure ou égale sont prises en compte dans le traitement. Par défaut, cette date est égale à la date du jour. |
Onglet Plan de travail
On retrouve dans chaque onglet de ce type (il peut y en avoir jusqu'à 8), les notifications de Workflow pour lesquelles une règle de signature ou de visa a été paramétrée.
L'ordre de tri par défaut des informations, et la mise en évidence (par un style) des ligne devant être mises en exergue sont paramétrables par onglet.
Bloc numéro 1
champ PAGFIR |
Boutons de navigation permettant de parcourir l'ensemble des lignes du plan de travail. |
champ PAGPRV |
champ PAGNXT |
champ PAGLST |
champ W |
champ PAGCUR |
champ SAICRI |
Bouton qui permet d'ouvrir un écran de saisie d'un critère de sélection des lignes sous la forme d'une expression logique. Ce critère est appliqué à tous les onglets en plus des critères spécifiques à chaque onglet. |
Chrono (champ CHRONO) |
Numéro chronologique attribué lorsqu'un Workflow est déclenché. Dans le cas d'un Workflow manuel, un numéro est attribué pour chaque enregistrement déclencheur. Dans tous les autres cas, un seul numéro chronologique est attribué par déclenchement. Ainsi, lorsqu'une notification est envoyée à plusieurs utilisateurs à partir d'un même événement, le numéro de chrono est le même. |
Destinataire (champ DEST) |
Définit le destinataire de la notification. Si un visa ou une signature est attendue, c'est normalement lui qui doit la faire. Ce destinataire n'est pas forcément le destinataire qui était défini dans la règle d'origine. En effet, si la règle prévoit une délégation au premier destinataire libre, et que le destinataire de départ a défini un délégué avec pouvoir pour les dates concernées, c'est le délégué qui est destinataire de la notification (ou son délégué si lui-même a délégué...). |
Email destinataire (champ EMAIL) |
Lorsqu'un message est envoyé par la règle à un destinataire, son adresse de messagerie apparaît dans ce champ. |
No de workflow (champ NUMGRP) |
Ce numéro de chrono est attribué pour chaque ligne traitée (il y en a donc plusieurs lorsqu'on a des Workflow de type en-tête/ligne avec des regroupements). |
Société (champ CPY) |
Lorsqu'un modèle de données est attaché à la règle, et que ce modèle définit une société courante en fonction du contexte (que ce soit directement ou par l'intermédiaire d'un site), on stocke dans l'événement la société correspondante. Cette société peut être utilisée (mais ce n'est pas obligatoire) pour définir la règle d'affectation qui déterminera les destinataires de la notification. |
Délégué (champ DELEGUE) |
Ce champ vaut Non si l'utilisateur est le premier destinataire de la notification. Il vaut Oui si l'utilisateur reçoit la notification en tant que délégué non remplaçant (options Tous ou Cascade), et que par ailleurs il a pouvoir de signer (s'il n'a pas de pouvoir de signer, la notification n'apparaît pas dans le plan de travail. Il faut noter que si ce champ vaut Oui, au moins une autre ligne portant le même numéro de chrono avec la valeur Non existe dans la table stockant les données du plan de travail (il peut y avoir d'autres lignes avec le même numéro de chrono et cet indicateur égal à Oui si plusieurs délégués avec pouvoir de signature existent). La première signature sur l'une des lignes concernées met automatiquement à jour l'ensemble des lignes portant le même numéro de chrono en les considérant comme signées. |
Envoi mail (champ ENVOI) |
Ce champ vaut Oui si un message a été envoyé lors de l'exécution de la règle. |
Emetteur (champ EMETTEUR) |
Définit l'émetteur de la notification, c'est-à-dire l'utilisateur dont l'action a déclenché le Workflow. Dans un Workflow de type Signature, l'émetteur est celui qui a signé la notification précédente. Dans un Workflow autre, l'émetteur est l'utilisateur dont l'action déclenche l'envoi de la notification. |
Email émetteur (champ MAIENV) |
Lorsqu'une ligne du planb de travail a été signée par le déclenchement d'un lien http depuis un message, ce champ stocke l'adresse de messagerie de l'utilisateur ayant signé de la sorte. |
Date émission (champ DATENV) |
Correspond à la date système (telle qu'elle est connue du serveur de traitement) au moment de l'exécution de l'événement de Workflow. |
Heure émission (champ TIMENV) |
Correspond à l'heure système (telle qu'elle est connue du serveur de traitement) au moment de l'exécution de l'événement de Workflow. |
Nature de workflow (champ NATURE) |
Correspond à la valeur du champ Nature de Workflow défini sur l'événement déclencheur. Ce peut être un critère commode pour trier les lignes, pour les filtrer, ou pour les dispatcher sur différents onglets du plan de travail. |
Texte suivi (champ TEXSUI) |
Contient le texte évalué à partir de la rubrique Texte suivi définie dans l'onglet Suivi de la règle; usuellement, on y paramètre un commentaire expliquant les circonstances du déclenchement de Workflow. |
Type événement (champ TYPEVT) |
Définit le type d'événement de la règle de Workflow à l'origine de la ligne de notification dans le plan de travail. |
Code événement (champ CODEVT) |
Correspond au code événement à l'origine du Workflow, c'est-à-dire au code :
|
Code workflow (champ CODWRK) |
Identifie la règle de Workflow dont l'exécution a envoyé la notification. |
Opération (champ OPERATION) |
Contient le code opération dans le contexte déclenchant :
|
Délai signature (champ DATMAXSIG) |
Ce champ contient la date à laquelle le Workflow devra avoir été signé. Il est égal à la date de déclenchement si aucun processus de signature n'a été mis en oeuvre, ou si aucune date limite n'a été définie. En effet, lorsque l'événement de Workflow suppose une signature :
Lorsqu'une relance de ce type est faite :
Si ces règles batch ne sont pas utilisées, et si aucune autre règle n'a été définie pour mouvementer ces champs, le nombre de relance reste égal à 0 et la date de relance reste vide, car aucun traitement standard du Workflow ne modifie cette valeur. |
Flag signature (champ FLGSIG) |
Ce champ définit le niveau de signature correspondant à la notification de la ligne. Les valeurs suivantes, définies par le menu local 2922 sont possibles :
|
Réponse (champ ACTSIG) |
Ce champ est vide tant que l'événement n'a pas été signé. S'il l'a été, on y trouve le code réponse qui a été saisi, tel qu'il est défini dans la table diverse numéro 54. |
Signataire (champ USRSIG) |
Lorsqu'une ligne du tableau des notifications a été signée, on voit apparaître ici le code de l'utilisateur qui a signé. Il ne s'agit pas forcément du destinataire d'origine, puisqu'un autre utilisateur peut avoir pouvoir pour signer. |
Email signataire (champ MAISIG) |
Lorsqu'un message incluant une demande de suivi par activation d'un lien http a été envoyé, ce champ permet de connaître l'adresse de messagerie du destinataire. |
Date signature (champ DATSIG) |
Si la notification de Workflow suppose un suivi (simple visa ou signature), ce champ permet de savoir à quelle date le suivi a été fait (il reste vide tant qu'il n'a pas été réalisé). |
Heure signature (champ TIMSIG) |
Si la notification de Workflow suppose un suivi (simple visa ou signature), ce champ permet de savoir à quelle heure le suivi a été fait (il reste vide tant qu'il n'a pas été réalisé). |
Motif réponse (champ REASON) |
Contient l'intitulé associé au code code motif saisi à la signature de la règle, lorsque cette saisie est possible au moment de la signature. Ceci suppose que l'on définisse une liste de motifs possibles par l'intermédiaire d'un numéro de table diverse sur la ligne de signature correspondante. |
Code motif (champ REACOD) |
Contient le code motif saisi à la signature de la règle, lorsque cette saisie est possible au moment de la signature. Ceci suppose que l'on définisse une liste de motifs possibles par l'intermédiaire d'un numéro de table diverse sur la ligne de signature correspondante. |
No motif (champ REANUM) |
Lorsqu'une saisie de code motif a été prévue à la signature de la règle, on trouve dans ce champ le numéro de table diverse qui définit les motifs possibles sur la ligne de signature correspondante. |
Clé déclenchante (champ CLEOBJ) |
Dans le cas d'un Workflow objet, on retrouve dans ce champ la clé de l'objet (c'est le champ Clé déclenchante d'origine). Dans le cas d'un Workflow de type signature, on retrouve dans ce champ le numéro chrono à l'origine de la signature. Dans tous les autres cas, cette zone n'est pas renseignée. |
Table déclenchante (champ IDENTREF) |
Ce champ technique contient le code de la table déclenchante et le code de la clé correspondante, exactement de la même façon que pour le champ Identifiant ligne. Par contre, en cas d'événement de type signature, il reste vide, c'est-à-dire qu'il n'est pas transmis depuis la notification d'origine. |
Identifiant retour (champ IDENTRET) |
Lorsqu'une icône de retour est associée au Workflow, ce champ contient le nom de la fonction sur laquelle le retour se fait. Si la fonction est de type objet, on retrouve ensuite, séparé par un "/" de la table, la clé correspondante (les segments de clés, pour une clé en plusieurs parties, étant séparés par "~"). |
Identifiant ligne (champ IDENTGRP) |
Ce champ technique contient, dans l'ordre, le nom de la table dans laquelle se trouve l'événement déclenchant d'origine, suivie de la clé courante liée au groupe qui a provoqué le déclenchement. Le séparateur entre table et clé est "/", le séparateur entre les segments de la clé (lorsqu'elle est composée de plusieurs champs) est "~". Le contenu est défini de la façon suivante :
|
Chrono origine (champ NUMORG) |
Ce numéro chrono est renseigné uniquement sur les notifications liées à un événement de type Signature; il permet de connaître le numéro chronologique de l'événement d'origine, celui dont la signature a déclenché la ligne courante. |
Destinataire origine (champ USRORG) |
Ce champ n'est renseigné que sur les lignes associées à un événement de type Signature. Il permet de connaître le destinataire du Workflow d'origine (celui qui a effectivement reçu la notification après application éventuelle des règles de délégation : ce n'est pas forcément celui qui a signé). |
Date relance (champ DATREL) |
Ce champ contient la date à laquelle la dernière relance de signature a été faite sur la notification. Il n'est pas renseigné si aucun processus de signature n'a été mis en oeuvre. En effet, lorsque l'événement de Workflow suppose une signature :
Lorsqu'une relance de ce type est faite :
Si ces règles batch ne sont pas utilisées, et si aucune autre règle n'a été définie pour mouvementer ces champs, le nombre de relance reste égal à 0 et la date de relance reste vide, car aucun traitement standard du Workflow ne modifie cette valeur. |
No relance (champ NBRREL) |
Ce champ contient le compte du nombre de relances de signatures faites sur l'événement Workflow. En effet, lorsque l'événement de Workflow suppose une signature :
Lorsqu'une relance de ce type est faite :
Si ces règles batch ne sont pas utilisées, et si aucune autre règle n'a été définie pour mouvementer ces champs, le nombre de relance reste égal à 0 et la date de relance reste vide, car aucun traitement standard du Workflow ne modifie cette valeur. |
Niveau de la signature (champ LEVSIG) |
Ce champ correspond au niveau de signature, lorsque des événements de signature s'enchaînent :
La variable LEVSIG correspondante est fréquemment utilisée dans les règles de Workflow lorsque la règle d'affectation de l'événement d'origine donne l'ensemble des signataires (1 à 9 maximum). Il suffit alors, dans l'événement d'origine comme dans les événements de signature qui s'enchaînent, de donner comme formule de destinataire USER(LEVSIG+1) pour avoir l'utilisateur numéro N dans la liste. Ceci permet notamment d'avoir des règles de signature récursives, exécutées tant qu'il reste des signataires. |
Icône de retour (champ CONTXT) |
Lorsqu'un Workflow envoie un message avec une icône de branchement, le contexte de connexion (dossier, serveur, service, fonction...) est défini sous forme d'un champ alphanumérique. Ce champ technique contient ce contexte. Les différents segments de ce champ sont séparés par le caractère "/". |
Retour bureau (champ CONTXTSYRA) |
Retour mobile (champ CONTXTMOBI) |
Clé déclenchante d'origine (champ CLEDEC) |
Identifie la clé à l'origine du circuit de Workflow. Cette clé, lorsqu'elle est composée de plusieurs parties, se présente comme une concaténation des parties de clés séparées par le caractère tilde (~). Les valeurs de clé dépendent du contexte :
|
Nbre de signataires (champ NBRUSR) |
Définit le nombre d'utilisateurs renvoyés par la règle d'affectation, lorsqu'il y en a une. S'il n'y en a pas, mais que la règle est de type Signature, on hérite du nombre de signataires défini dans la règle d'origine. Si aucun règle d'affectation n'existe, la valeur retournée est 0. |
Objet (champ ABROBJ) |
Lorsque le premier événement à l'origine d'un circuit de signature est un objet, ce champ identifie le code de l'objet. Dans les autres cas, il est vide. Il est ensuite transmis aux différents événements de signature qui pourraient s'enchaîner au premier. |
Premier destinataire (champ USRTOP) |
Définit le premier destinataire de l'événement de Workflow. En effet, un événement peut envoyer une notification à plusieurs séries de destinataires, chacun d'entre eux étant défini par une ligne dans le tableau des destinataires. Ce champ represente le destinataire évalué par la première ligne si l'option de délégation est Non, Tous, ou Cascade. Si l'option est Le premier libre, et si l'utilisateur n'est effectivement pas présent, et a donné délégation, on retrouve dans le champ l'utilisateur délégué. |
Contexte 1 (champ VALCTX1) |
Ce champ fait partie d'un ensemble de quinze champs génériques permettant de stocker des valeurs contextuelles évaluées au moment du déclenchement du Workflow à partir de formules saisies dans le tableau nommé Contexte de l'onglet Suivi du Workflow. Les valeur stockées dans ce tableau peuvent être utilisées :
|
Contexte 2 (champ VALCTX2) |
Contexte 3 (champ VALCTX3) |
Contexte 4 (champ VALCTX4) |
Contexte 5 (champ VALCTX5) |
Contexte 6 (champ VALCTX6) |
Contexte 7 (champ VALCTX7) |
Contexte 8 (champ VALCTX8) |
Contexte 9 (champ VALCTX9) |
Contexte 10 (champ VALCTX10) |
Contexte 11 (champ VALCTX11) |
Contexte 12 (champ VALCTX12) |
Contexte 13 (champ VALCTX13) |
Contexte 14 (champ VALCTX14) |
Contexte 15 (champ VALCTX15) |
Signataire 1 (champ USRSIG1) |
Permet de définir les signataires successifs, lorsqu'une règle d'affectation de destinataires renvoie N signataires pour la règle de Workflow. Cette information est notamment utilisée pour permettre de gérer correctement les annulations de signature. Sur les événements de type Signature pour lesquels aucune règle d'affectation n'est définie, on retrouve les signataires associés à la règle déclenchante. Ainsi, lorsque N signataires en cascade ont été définis dans la règle d'origine, et que toutes les règles de signature qui suivent n'ont pas de règle d'affectation, on peut connaître le circuit complet de signature à chaque niveau. Il est à noter que l'on voit apparaître ici les utilisateurs définis par la règle avant l'application éventuelle de règles de délégation. Ainsi, par exemple, si le premier destinataire de la règle de signature est absent, et qu'il est remplacé, on verra dans le champ Signataire 1 le signataire d'origine, alors que dans le champ Premier destinataire, on trouvera le remplaçant à qui la demande de signature a effectivement été envoyée. |
Signataire 2 (champ USRSIG2) |
Signataire 3 (champ USRSIG3) |
Signataire 4 (champ USRSIG4) |
Signataire 5 (champ USRSIG5) |
Signataire 6 (champ USRSIG6) |
Signataire 7 (champ USRSIG7) |
Signataire 8 (champ USRSIG8) |
Signataire 9 (champ USRSIG9) |
Opération déclenchante | ||||||||
Cette fonction permet de revenir en zoom sur la fonction et le contexte à l'origine du Workflow. Dans le cas d'un Workflow sur objet, on revient sur la fiche correspondante. |
||||||||
Opération déclenchante d'origine | ||||||||
Cette fonction est accessible lorsque l'événement à l'origine de la notification est de type Signature; dans ce cas, on remonte à l'événement d'origine (si besoin de façon récursive) pour retrouver la fonction et la fiche qui ont déclenché le début du processus. |
||||||||
Retour | ||||||||
Cette fonction permet de revenir sur la fonction et dans le contexte décrits par l'icône de retour du paramétrage de Workflow. Si rien n'a été défini de particulier, c'est l'opération d'origine qui est proposée. |
||||||||
Mails du groupe | ||||||||
Descriptions des champs
Tableau Destinataires
Tableau Copie
Objet
Message
Bloc numéro 5 Cette fonction permet de faire apparaître, dans une fenêtre de sélection, la liste des messages envoyés à tous les utilisateurs destinataires de la notification. On voit une ligne pour chaque ensemble de destinataires définis par une ligne dans le tableau de paramétrage des destinataires de Workflow. Si on double clique sur une des lignes, une fenêtre s'ouvre pour faire apparaître le détail du message envoyé et la liste des destinataires. |
||||||||
Historique mails | ||||||||
Descriptions des champs
Tableau Destinataires
Tableau Copie
Objet
Message
Bloc numéro 5 Cette fonction permet de faire apparaître, dans une fenêtre de sélection, la liste des messages envoyés aux utilisateurs successifs ayant signé la notification d'origine et les notifications suivantes (lorsque le processus de signature se fait à plusieurs niveaux). Les lignes apparaissent dans l'ordre chronologique inverse (les signatures les plus récentes d'abord). Si on double clique sur une des lignes, une fenêtre s'ouvre pour faire apparaître le détail du message envoyé et la liste des destinataires. |
||||||||
Signature | ||||||||
Cette fonction permet de déclencher le processus de signature de la ligne. Elle n'est disponible que si l'utilisateur a pouvoir de signature, et si la ligne n'est pas déjà signée. Une fenêtre s'ouvre alors pour proposer un choix de réponses possibles, en fonction du paramétrage. Un motif supplémentaire peut également être saisi selon le paramétrage, voire un texte libre (pour motiver un refus par exemple). |
||||||||
Visa | ||||||||
Cette fonction permet de viser la ligne. Cette fonction n'est disponible que si la ligne n'est pas visée. Aucune autre saisie n'est demandée, la ligne passant à l'état Visé à partir du moment où cette opération a été faite. |
||||||||
Annuler | ||||||||
Cette fonction permet d'annuler une signature accordée (en revenant à l'état antérieur de la demande). Elle n'est disponible que si les conditions suivantes sont toutes remplies :
Cette opération est différente d'une opération de rejet de la demande ou de refus, qui sera traitée de façon tout à fait classique par paramétrage standard. |