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

Afficher tout Masquer tout

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

Codes activité

Les codes activités suivants (classés par type) peuvent avoir une influence sur le comportement de la fonction :

Codes activités dépendants

Ces codes ne sont jamais saisis en gestion de dossier, car leur valeur est calculée :

  AUDIT (Audit).

Fonctionnel

  ABI :  Business Intelligence

  ASD :  SData

  LEG :  Gestion multi-législations

Dimensionnement

  STA :  Nb de montants statistiques

  STT :  Nb de critères statistiques

Habilitations

Cette fonction est de type objet. Les opérations de création, modification, et suppression de fiche peuvent être activées ou désactivées pour un utilisateur donné. Des filtres par rôles peuvent également être mis en place sur cette fonction.

Autres pré-requis

Le code activité STT permet de définir le nombre de critères statistiques utilisables pour les statistiques. Sa valeur minimale, est de 4, mais on peut l'étendre jusqu'à 8.

Les événements déclencheurs sont prédéfinis dans le progiciel. En effet, la logique interne du progiciel prévoit l'appel automatique d'une fonction de mise à jour utilisant les codes déclenchants, afin de tenir des statistiques en temps réel.

Il n'est donc possible de créer de nouveaux événements déclencheurs utilisables en temps réel que si un programme spécifique les met à jour.

Outre les mises à jour en temps réel, une fonction de calcul en temps différé permet de faire des mises à jour soit incrémentales, soit de type récupération. De nouveaux événements déclenchants peuvent être librement définis pour gérer des statistiques de ce type.

Par ailleurs, il est possible de modifier les caractéristiques d'un événement déclencheur standard (par exemple, ajouter des tables liées qui doivent être parcourues ou encore donner des conditions différentes de déclenchement).

Gestion de l'écran

En-tête

Présentation

Permet d'identifier le code déclencheur.

Fermer

 

Champs

Les champs suivants sont présents dans cet onglet :

 

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

  • Intitulé (champ INTIT)

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

Fermer

 

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.

Fermer

 

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

  • Intitulé court (champ INTSHO)

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

  • Module (champ MODULE)

Module d'appartenance du paramétrage.

Un code activité permet :

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

Ainsi, si le code activité est non actif, l'élément marqué ne sera pas utilisable, et le code associé (s'il y en a) ne sera pas généré ni activable.

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.

Bloc numéro 3

  • 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

Fermer

 

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.

Fermer

 

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, on utilise 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.

  • Expression de lien (champ EXPLNK)

Ce champ est défini comme une ou plusieurs expressions calculées 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, on peut ne donner que les premiers éléments de la clé.

Dans les expressions, on peut 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.

Fermer

 

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)

Ce champ permet de définir 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)

Ce champ permet de définir le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

Fermer

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

Présentation

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.

Fermer

 

Champs

Les champs suivants sont présents dans cet onglet :

Sélections

  • Toutes langues existantes (champ ALLLAN)

Si cette case est cochée, toutes les langues sont prises en compte pour l'opération.

Si la case n'est pas cochée, on prendra, selon les cas :

  • la langue par défaut de l'utilisateur, si aucun code langue n'est saisi.
  • la langue saisie par ailleurs sinon.

Permet de définir la langue de génération (quand la case permettant de générer dans toutes les langues n'est pas cochée).

  • Tous types (champ ALLTYP)

Si cette case est cochée, tous les types de documentation sont pris en compte pour la génération. Il est à noter que, dans ce cas, on limite la génération aux documentations standard (seules les documentations de code inférieur à X sont prises en compte).

Permet de définir le type de documentation à prendre en compte dans le traitement (quand on n'a pas coché la case pour les prendre tous en compte).

  • Codes documentations (champ FUNDEB)

Permet de donner une borne sur les codes à prendre en compte pour la génération de documentation.

  • champ FUNFIN

 

Génération ADOCUMENT

  • Génération ADOCUMENT (champ GENDOC)

Ce radio-bouton permet créer/mettre à jour le squelette de la documentation (hiérarchie des paragraphes) à partir des éléments techniques trouvés dans le dictionnaire des données. On peut choisir de reprendre uniquement les documentations existantes ou créer de nouvelles documentations si besoin.

Les liens de documentation sont également pris en compte. Les paragraphes susceptibles d'être créés sont définis dans l'annexe technique correspondante.

Génération document final

  • champ GENFIN

Ce radio-bouton permet de générer la documentation finale à partir du contenu des paragraphes de documentation. Cette documentation est créée dans différents sous-répertoires du répertoire défini par le paramètre utilisateur DIRDOC.

Il faut utiliser la génération "Selon code activité" pour obtenir la génération des documentations des fonctions ayant des codes activités >= "X"
La génération "Complète" ne traite que les codes activités standards.

  • Uniquement les documentations validées (champ HLPVLD)

Permet de générer le document final uniquement pour les documentations validées.

  • Aides sur champs liées aux documentations (champ HLPLNKFLD)

Si cette case est cochée, on traite spécifiquement les aides sur champs relatives aux documentations sur fonction ou objet traitées par ailleurs. Pour savoir quelles sont les aides sur champ à traiter, on explore les écrans associés aux paragraphes de documentation correspondants.

  • Autres aides sur champs (champ HLPFLD)

Si cette case est cochée, on crée la documentation finale à partir du contenu des paragraphes de documentation. Cette documentation est créée dans le sous-répertoire FLD du répertoire défini par le paramètre utilisateur DIRDOC.

  • Codes aides sur champs (champ HLPDEB)

Permet de donner une borne sur les codes à prendre en compte pour la génération de documentation.

  • champ HLPFIN

 

  • Répertoire de génération (champ REPERT)

 

Fermer

 

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

Les tables suivantes sont mises en oeuvre par la fonction :

Table

Intitulé Table

AINDEX [ANX]

Index spécifiques

ATABIND [ATI]

Dictionnaire des index

ATABLE [ATB]

Dictionnaire des tables

ATABZON [ATZ]

Dictionnaire des champs

ATEXTRA [AXX]

Textes à traduire

ATYPE [ATY]

Types de données

PARSTA1 [PS1]

Déclencheurs statistiques