Paramétrage > Exploitation > Statistiques > Déclencheurs statistiques 

Un outil très général de paramétrage de statistiques est proposé dans le progiciel. Cet outil permet de créer une base statistique dont les caractéristiques sont les suivantes :

  • Liste d'événements déclencheurs gérés par le progiciel et permettant de lancer la mise à jour de la base statistique.
  • Définition de codes statistiques permettant de cumuler des montants chiffrés, s'appuyant sur un événement déclenchant et des critères (de 1 à 8 critères banalisés au maximum, plus la société et le site).
  • Génération pour chaque code d'enregistrements de cumuls selon les combinaisons des critères définis.

Ces enregistrements de cumuls peuvent alors être utilisés par des états ou des interrogations accessibles directement depuis une fiche de base, pour obtenir des tableaux statistiques.

Le paramétrage des événements déclencheurs permet de préciser, pour chaque événement susceptible d'être appelé par le progiciel, les données en ligne et les critères de sélection correspondants.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

Présentation

Permet d'identifier le code déclencheur.

 

Champs

Les champs suivants sont présents dans cet onglet :

 

Le déclencheur statistique permet d'identifier l'élément quidéclenche la statistique.

  • Intitulé (champ INTIT)

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

 

Onglet Général

Présentation

On définit dans le premier onglet les informations générales liées au déclencheur statistique : la table principale sur laquelle est gérée l'agrégation, et des zones permettant de déterminer l'enregistrement de cumul à mouvementer.

Ces zones sont importantes, dans la mesure où la table STAT qui contient les données est structurée par société, site, et date (selon la périodicité), et que le sous-programme de cumul doit savoir dans quelles zones de la table déclenchante on trouve les valeurs à utiliser.

 

Champs

Les champs suivants sont présents dans cet onglet :

Caractéristiques

  • Intitulé court (champ INTSHO)

Intitulé court sur 10 caractères alphanumériques.

  • Module (champ MODULE)

Sélectionnez un module pour le paramétrage.

Ce champ vous permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier.

Un code activité vous permet de :

  • rendre optionnel un élément du dictionnaire si la valeur associée au code activité est nulle,
  • signer les éléments spécifiques dès lors qu'ils sont marqués par un code commençant par X, Y ou Z,
  • dimensionner un nombre de lignes maximum lorsque le code activité marque des éléments d'un tableau,

Si le code activité est désactivé :

  • l'élément marqué n'est pas utilisable,
  • le code associé n'est pas généré ou activé.

Bloc numéro 2

Définit la table principale à partir de laquelle on définit les champs qui vont servir à déclencher la mise à jour des statistiques. Cette table doit être en ligne au moment de l'appel avec un enregistrement courant caractéristique des données à cumuler.

Options

  • Zone date (champ DATFLD)

Définit le champ de la table de déclenchement où se trouve la date à laquelle est rattaché l'enregistrement. Cette date permet de déterminer dans quelle période la valeur statistique relative à l'enregistrement sera cumulée, compte tenu de la périodicité de calcul choisie.

  • Zone société (champ CPYFLD)

Définit le champ de la table de déclenchement où se trouve le code de la société auquel est rattaché l'enregistrement. Si ce champ, ou si le champ site sont renseignés, les statistiques s'appuyant sur ce code pourront être déclinées par société.

  • Zone site (champ FCYFLD)

Définit le champ de la table de déclenchement où se trouve le code du site auquel est rattaché l'enregistrement. Si ce champ est renseigné, les statistiques s'appuyant sur ce code pourront être déclinées par site.

Bloc numéro 4

 

Onglet Avancé

Présentation

Le second onglet permet de compléter la description du contexte de déclenchement, lorsque celui-ci est plus complexe, notamment :

  • en décrivant, dans un premier tableau, des jointures permettant de provoquer la lecture d'autres tables liées durant le processus de cumul. L'ordre de saisie des tables dans le tableau est important, puisque une table peut être liée en cascade à la table principale et à toutes les tables qui la précèdent.
  • en donnant des conditions logiques qui doivent être réalisées pour que le cumul soit fait.
  • en définissant des variables (via des formules de calcul) utilisables directement en définition de statistiques.

 

Champs

Les champs suivants sont présents dans cet onglet :

Tableau numéro 1

  • No (champ NUMLIG3)

 

Définit une table qui sera mise en ligne lors du processus de cumul, dont l'enregistrement est déterminé par une valeur de clé de lien. Ceci permettra également de baser les critères de statistiques et les valeurs cumulées sur des champs de cette table.

  • Abréviation (champ ABRLNK)

Correspond à l'abréviation sous laquelle la table liée est ouverte.

Si ce champ n'est pas saisi, l'abrévation est l'abréviation par défaut de la table. Il peut être utile de saisir une abréviation pour ne pas rentrer en conflit avec le contexte appelant.

  • Clé de lien (champ CLELNK)

Définit le code de la clé de la table utilisée pour réaliser la lecture des lignes liées. Par défaut, la première clé de la table est utilisée.

Une fois ce champ alimenté, le tableau suivant Mapping clés - propriétés est alimenté suivant le code des différents segments de clé.

  • Expression de lien (champ EXPLNK)

Ce champ est défini comme une ou plusieurs expressions calculées et séparées par un point-virgule. Chaque expression est évaluée, et le résultat permet de connaître la valeur de la clé utilisée pour réaliser la jointure. Lorsque les jointures multiples sont autorisées, vous ne pouvez donner que les premiers segments de clé.

Dans les expressions, vous pouvez utiliser des constantes, et des champs issus des tables précédemment définies dans la liste des liens.

Tableau numéro 2

  • No (champ NUMLIG1)

 

  • Critères de déclenchement (champ CRI)

Permet de définir un critère sous forme d'une expression logique pouvant faire intervenir toutes les tables en ligne, des constantes et des fonctions.

Seules les lignes pour lesquelles l'évaluation des conditions renvoie un résultat non nul (ie. vrai) sont concernées par l'extraction de données.

Tableau numéro 3

  • No (champ NUMLIG2)

 

  • Variable (champ VARNAM)

Définit le nom d'une variable directement utilisable dans les cumuls statistiques basés sur l'événement déclencheur, pour éviter d'avoir à définir des expressions calculées basées sur les champs des tables en ligne.

  • Intitulé (champ VARINTIT)

Intitulé associé au code précédent

  • Expression (champ VARFOR)

Définit la formule de calcul correspondant à la variable.

Cette formule est une expression calculée pouvant faire intervenir des constantes, des opérateurs, des fonctions, et toutes les variables en ligne dans le contexte d'agrégation.

  • Devise (champ VARCUR)

Afin de permettre de créer des cumuls sur des montants exprimés en devise différentes convertis automatiquement, on peut saisir ici une constante ou un champ définissant un code devise. On saisira ensuite, dans la définition du cumul statistique, le code de la devise dans laquelle doit être gérée chaque cumul.

 

Liste des différents événements déclencheurs standard

Les événements déclencheurs standard sont documentés dans des documentations, organisées par module, et accessibles par le lien suivant.

Il est à noter que, dans le cas de documents complexes (de type en-tête et ligne), il peut exister deux événements déclencheurs, l'un appelé une fois par en-tête, l'autre appelé une fois par ligne. Selon le niveau de détail désiré pour l'agrégation, on choisira l'un ou l'autre.

Boutons spécifiques

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 définition de la fiche depuis ou vers un autre dossier.

Barre de menu

Documentation / Paragraphes

Cette fonction permet d'accéder à la gestion de la documentation, sur le premier paragraphe de la documentation (si elle existe) associé à la fiche courante.

Documentation / Liens

Cette fonction permet d'accéder à la gestion des liens. Elle permet de définir des liens entre la fiche courante et d'autres fiches (par exemple des liens entre fonctions et paramètres). Ces liens, purement documentaires, permettent d'alimenter la mécanique de génération des squelettes de documentation.

Documentation / Génération

Ce menu permet de lancer une génération de documentation. La génération peut se lancer également à partir du bouton [Génération] dans le bas de la fenêtre.

Trois types de génération peuvent être lancées, séparément ou simultanément :

  • la génération du squelette de documentation à partir du dictionnaire (tables ADOCUMENT, ADOCBLB, ADOCCLB).
  • la génération de la documentation à partir des tables précédentes.
  • la génération de la documentation sur champ.

Les bornes proposées par défaut tiennent compte de la fiche en cours, mais elles peuvent être modifiées au lancement.

Messages d'erreur

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

Champ inexistant

Le champ de lien proposé n'existe pas dans la table

Zone inexistante

La zone société, site, ou date saisie n'existe pas dans la table

Expression incorrecte  Erreur de syntaxe

L'expression calculée définissant la valeur de la variable n'est pas correcte.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre