Paramétrage > Workflow > Règles d'affectation utilisateur 

Une règle d'affectation est associée à une règle de Workflow. Elle permet de définir les utilisateurs destinataires par l'intermédiaire d'un tableau de valeurs nommé [L]USER, avec des indices allant de 1 à une valeur maximale définie par le code activité AWR.

Ces destinataires sont donnés sous la forme de codes utilisateurs, saisis dans un écran destiné à la personne chargée de définir les circuits de signature, par la fonction de saisie de valeurs de règles. Chaque liste de destinataires est déterminée par des critères dépendant du contexte. L'utilisateur chargé de définir les circuits de signature pourra alors saisir les combinaisons de valeurs de critère et leur affecter les destinataires correspondants.

Cette fonction de paramétrage permet de créer et de mettre à jour les règles d'affectation, en définissant le nombre maximum de signataires que renvoie une règle, et les critères dont la combinaison définit les signataires.

A l'exécution de la règle d'affectation :

  • Les critères sont calculés par simple évaluation, ou par agrégation sur un ensemble de lignes par un opérateur tel que la somme, la moyenne, le minimum, le maximum... Chacun des critères ainsi calculé est comparé (via un opérateur librement définissable) aux valeurs saisies dans la règle.
  • Le résultat de l'évaluation des critères est stocké dans un tableau de variables nommé VALEXP, l'indice variant de 1 au nombre de colonnes de critères. Ceci permet leur exploitation dans la suite de la règle de Workflow. Il est intéressant de noter que certains critères, dont la valeur est intéressante pour la suite du processus de Workflow, peuvent ne pas déterminer les destinataires (on leur associera l'opérateur Indifférent).
  • En fonction de la combinaison obtenue, le tableau [L]USER est transmis et peut être utilisé par la règle de Workflow.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

Un seul onglet est nécessaire pour gérer les règles d'affectation.

Ecran de saisie

Présentation

On y trouve d'une part le nombre maximum de destinataires qui pourront être saisis, et d'autre part la liste des critères et les règles associées qui permettront de définir les destinataires concernés. Il est à noter que le droit d'exécution attaché au code d'accès affecté à la règle contrôle le droit de saisir des valeurs pour cette règle.

 

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

Ce code identifie de façon unique les fiches créées.

Une règle d'affectation peut être définie pour des sociétés particulières (et dans ce cas, on  créera une fiche indiquant le code société pour chaque société concernée). Mais il peut aussi être défini pour toutes les autres sociétés (ce code est alors vide).

  • Intitulé (champ INTIT)

Permet de définir un intitulé associé à chaque fiche.

Caractéristiques

Ce code d'accès permet d'interdire l'accès à la fiche courante pour certains utilisateurs.

Si le champ est alimenté, seuls les utilisateurs qui ont des droits de lecture sur ce code d'accès peuvent visualiser l'enregistrement ; et seuls les utilisateurs avec des droits d'écriture peuvent le modifier.

Ce champ obligatoire permet de définir le modèle de données dont les tables sont accessibles lors de l'évaluation de la règle d'affectation. Ce modèle est obligatoirement le même que celui associé à la règle de Workflow qui utilise la règle d'affectation.

Ce champ ne peut être saisi que quand le modèle de données contient des tables de lignes associées à un en-tête. Si on saisit alors une des tables lignes, c'est cette table qui sera parcourue pour déterminer les destinataires du Workflow. Un Workflow utilisant la règle d'affectation correspondante sera forcément de type Ligne.

  • Abréviation ligne (champ ABRLIG)

 

  • Nb de signataires (champ NBRUSR)

Ce champ définit le nombre maximum d'utilisateurs que renvoie la règle dans le tableau USER. L'écran généré par la validation de la règle contiendra, outre les colonnes de critères, auutant de colonnes Utilisateurque de valeurs renvoyées. Ce nombre peut être compris entre 1 et une valeur maximale définie par le code activité AWR.

Tableau

La table saisie ici est celle parcourue pour l'évaluation du critère de la ligne. Si cette table est liée avec un lien de type (1,N) avec la table ligne de la règle (ou avec la table principale du modèle en l'absence de table ligne), un opérateur de synthèse sera saisi pour définir comment on agrège les N valeurs contenues dans les lignes.

  • Abréviation (champ ABRFLD)

 

  • Opérateur synthèse (champ SYNFLD)

Ce champ est saisi lorsque le champ utilisé comme critère se trouve dans une table liée avec un lien (1,N) à la table principale du modèle.

Dans ce cas, la valeur obtenue pour le critère correspond à l'agrégation d'un ensemble de lignes, et l'opérateur saisi ici permet de préciser comment le calcul est effectué.

Les opérateurs d'agrégation Somme et Moyennene peuvent être utilisés que si le critère est numérique. Les opérateurs Minimum et Maximum peuvent être utilisés dans tous les cas.

  • Critère (champ EXPFLD)

Cette expression est évaluée lors de l'exploitation des règles d'affectation, et la valeur résultante (éventuellement agrégée sur plusieurs lignes selon l'opérateur qui suit) est comparée à la liste des valeurs saisie dans la règle, pour déterminer quelle est la ligne à utiliser (et donc quels utilisateurs doivent être retournés par la règle).

  • Opérateur (champ OPEFLD)

L'opérateur saisi ici sert à comparer la valeur du critère avec les champs saisis dans les valeurs de règle. Outre les opérateurs d'égalité et d'inégalité classiques, on retrouve l'opérateur Comme, qui permet de saisir des valeurs caractères avec des jokers, et l'opérateur Indifférent, qui signifie que la valeur n'est pas utilisée comme critère d'affectation des utilisateurs, mais transmise à la règle de Workflow appelante pour être utilisée par ailleurs.

  • Intitulé (champ INTFLD)

Cette expression permet de donner un titre à la colonne de saisie du critère correspondant de la règle d'exploitation. Elle est donc évaluée au moment de la saisie des valeurs de règle.

Si ce champ est vide, et si le critère est un champ extrait d'une des tables de la base, le titre repris est automatiquement celui du dictionnaire (il est repris dans la langue de connexion de l'utilisateur).

Ce champ définit le type de données associé à la saisie du critère. Lorsqu'un champ extrait d'une des tables de la base est choisi comme critère, son type est proposé par défaut.

  • Longueur (champ LNGFLD)

Lorsque la valeur à saisir dans l'écran des critères est de type chaine de caractères, on peut préciser la longueur maximale du champ.

  • No menu local (champ LIBFLD)

Lorsque la valeur à saisir dans l'écran des critères est de type Menu local, on peut préciser le numéro de menu local à utiliser.

  • Paramètre (champ PARFLD)

Lorsque le champ associé au critère est contrôlé par une table ayant une clé en plusieurs parties (par exemple, les tables diverses, les textes traduisibles), on saisit ici le composant de clé complémentaire pour établir le lien avec la table.

  • Lien (champ LNKFLD)

Quand la valeur à saisir dans l'écran des critères est contrôlée par une autre table, on peut choisir d'afficher un intitulé associé à valeur saisie : les choix possibles sont Non(pas d'affichage), Long(affichage de l'intitulé long), Court(affichage de l'intitulé court).

  • Valeur par défaut (champ DEFFLD)

Si elle existe, cette expression est évaluée lors de la saisie des règles d'affectation pour permettre de donner une valeur par défaut au champ .

 

Boutons spécifiques

Ce bouton permet de générer le traitement automatique associé à la gestion de la règle d'affectation. Une validation est automatiquement réalisée à la création ou à la modification d'une règle. Ce bouton n'est donc utile que lorsqu'une règle a été transférée depuis un autre dossier par copie. Dans ce cas, une revalidation manuelle est nécessaire.

Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

Bloc numéro 1

  • champ OBJET

 

  • champ CLES

 

Bloc numéro 2

  • Depuis le dossier (champ DOSORG)

Indiquez le dossier à partir duquel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

  • Tous dossiers (champ TOUDOS)

Cette option permet de copier la fiche vers tous les dossiers définis dans le dictionnaire (table ADOSSIER de la solution courante).

  • Vers le dossier (champ DOSDES)

Indiquez le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

Ce bouton permet de recopier la règle d'affectation vers un autre dossier.

Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

Bloc numéro 1

Définit le code règle utilisé pour affecter les utilisateurs. C'est ce code qui est référencé dans la règle de Workflow.

Une règle d'affectation peut être définie pour des sociétés particulières (et dans ce cas, on  créera une fiche indiquant le code société pour chaque société concernée). Mais il peut aussi être défini pour toutes les autres sociétés (ce code est alors vide).

  • Intitulé (champ INTIT)

Permet de définir un intitulé associé à chaque fiche.

  • Formule/utilisateur (champ FLGFOR)

Ce champ permet de saisir des formules sur les champs "Utilisateur"'.
Cette formule sera évaluée au moment de l'exécution du workflow.
Toutefois, si la valeur du champ est inférieure ou égal à 5, on considère qu'il s'agit d'un code utilisateur "en dur" et ce champ ne sera pas évalué.

Tableau Utilisateur par défaut

  • Code utilisateur (champ AUSDEF)

 

  • Nom (champ AUSNAM)

Le nom du destinataire est affiché en regard de son code.

Tableau Valeurs

  • No de ligne (champ NUMLIG)

 

  • champ VAL0

On saisit ici les valeurs de critères utilisées pour trouver les destinataires de la règle.

  • Intitulé (champ LNK0)

Si le critère est contrôlé par une table, et si le paramétrage de la règle d'affectation l'a prévu, l'intitulé long ou court de la fiche liée est affiché.

  • champ VAL1

On saisit ici les valeurs de critères utilisées pour trouver les destinataires de la règle.

  • Intitulé (champ LNK1)

Si le critère est contrôlé par une table, et si le paramétrage de la règle d'affectation l'a prévu, l'intitulé long ou court de la fiche liée est affiché.

  • champ VAL2

 

  • Intitulé (champ LNK2)

 

  • champ VAL3

 

  • Intitulé (champ LNK3)

 

  • champ VAL4

 

  • Intitulé (champ LNK4)

 

  • champ VAL5

 

  • Intitulé (champ LNK5)

 

  • champ VAL6

 

  • Intitulé (champ LNK6)

 

  • champ VAL7

 

  • Intitulé (champ LNK7)

 

  • champ VAL8

 

  • Intitulé (champ LNK8)

 

  • champ VAL9

 

  • Intitulé (champ LNK9)

 

  • champ USR0

On saisit ici les destinataires correspondant à la combinaison de critères de la ligne.

  • champ USR1

 

  • champ USR2

 

  • champ USR3

 

  • champ USR4

 

  • champ USR5

 

  • champ USR6

 

  • champ USR7

 

  • champ USR8

 

  • champ USR9

 

Ce bouton permet d'entrer dans la fonction de saisie des valeurs de règles. La règle courante est proposée par défaut.

Messages d'erreur

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

XXX : Cette table ne peut pas être rattachée sous la table YYY

La table saisie au niveau d'une ligne de règle n'est pas liée à la table de base de la règle par un lien (1,1) ou (1,N). Le rattachement est donc impossible.

Table non référencée

La table saisie comme table ligne n'est pas présente dans le modèles de données auquel la règle est rattachée.

Valeur trop grande (maximum NN)

NN destinataires peuvent être définis au maximum dans une règle d'affectation (NNdépend du code activité AWR).

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre