Paramétrage > Exploitation > Statistiques > Paramètres 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 dans un fichier de cumuls. Ce fichier contient des enregistrements sous la forme suivante :

Code MAJ

Société

Site

Date

Critère 1

Critère 2

Critère 3

...

Montants
(1 à 5 ou 10)

Le code MAJ est un code caractéristique utilisé par les états et programmes d'interrogation. Il est possible de créer autant de codes que nécessaire (chacun correspondant à un type d'informations statistiques).

Les codes société et site permettent d'avoir si nécessaire des statistiques détaillées (ce n'est pas obligatoire, et si ce niveau de détail n'est pas souhaité, les zones correspondantes restent vides dans la constitution de la base).

La zone date est renseignée avec le premier jour de la période correspondant à la date de l'événement déclenchant (selon le cas, ce sera le premier jour de la semaine, de la quinzaine, du mois, du trimestre...).

Les zones critères sont définies librement en utilisant les champs des tables en ligne (ou avec des parties de ces champs, par exemple les deux premiers caractères du code postal). Ceci permet d'avoir des statistiques avec des axes d'analyse plus ou moins détaillés. Dans les versions à partir de la 140, on peut avoir de 1 à 8 critères (en version 130, on était limité à 4).

Les zones montants contiennent les cumuls des montants que l'on souhaite analyser en statistiques.

Le paramétrage se fait par cette fonction, en créant des fiches déclenchant la constitution de la base statistique. Une fiche au moins est créée par code MAJ utilisé. Chaque fiche est identifié par un code unique, qui se confond très souvent avec le code MAJ, sauf lorsqu'on veut que deux (ou plus) fiches mettent à jour le même code MAJ (dans ce cas, les codes seront différents).

Il est en outre possible de définir, pour les paramètres statistiques de ce type, si des prévisions doivent pouvoir être saisies (ou calculées à partir du réel) en regard des cumuls statistiques.

La consultation des statistiques peut se faire sur 1 à 10 expressions calculées à partir des montants cumulés sur la période d'interrogation, sur la période précédente, ainsi que sur les budgets saisis. Si par exemple on ne souhaite voir dans l'écran que les valeurs moyennes d'un cumul, on aura pris soin de cumuler l'expression désirée sur une première colonne d'agrégation, de compter le nombre d'agrégations faites en cumulant 1 sur une autre des colonnes d'agrégation, et de présenter dans l'écran d'interrogation la rapport de ces deux colonnes. Pour consulter les statistiques, on entrera dans la fonction de consultation en indiquant le code MAJ à consulter. On pourra alors zoomer sur les différents niveau de détail induits par les critères successifs. Les zooms finaux se feront sur le détail des mouvements agrégés (s'ils sont encore en ligne).

Une consultation contextuelle des statistiques est possible depuis la fonction Fichier / Statistiques qui peut être paramétrée sur chaque objet (il y a une case à cocher qui le définit). Lorsque cette fonction est utilisée, une liste de codes statistiques accessibles apparaît, et le zoom se fait alors au niveau le plus fin possible compte tenu du contexte appelant. Par exemple, dans le cadre d'une gestion commerciale, si une statistique a été définie par département (les 2 premiers caractères de l'adresse par défaut associée au tiers), puis par famille statistique client, puis par client, puis par article, un appel aux statistiques depuis une fiche client autoriserait l'accès à cette statistique et se positionnerait automatiquement sur le niveau de détail du client (puisque le contexte permet de donner une valeur par défaut au département, à la famille client, et au code client). On verrait donc directement apparaître le cumul des statistiques du client par famille article.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

Présentation

En tête de fiche, on retrouve un code (identifiant unique pour le paramétrage) et un intitulé.

 

Champs

Les champs suivants sont présents dans cet onglet :

Identifie le code statistique courant. A un code statistique sont rattachés un ensemble de cumuls basés sur un à huit critères croisés.

  • Intitulé (champ INTIT)

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

  • Intitulé court (champ INTSHO)

Cet intitulé, qui permet de donner une désignation à la fiche, est utilisé dans certains écrans ou états lorsqu'il n'y a pas assez de place pour visualiser l'intitulélong.

 

Onglet Général

Présentation

Cet onglet définit les informations principales de l'agrégat statistique (événement déclencheur, périodicité, niveau de définition...).

 

Champs

Les champs suivants sont présents dans cet onglet :

Accessibilité

  • Actif (champ ENAFLG)

Sélectionnez cette case à cocher pour activer la fiche courante.

Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :

  • les autres enregistrements, comme les documents et paramètres,
  • les traitements en masse.

Les habilitations sur une fonction donnée peuvent interdire la création d'une fiche active. Dans ce cas, la case est désactivée par défaut. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature.

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é.

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.

Dans le cas des statistiques, le droit à la consultation contrôle également la consultation des données statistiques résultant du paramétrage.

  • 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.

Périodicité

  • Script (champ PERPRG)

Lorsque l'on désire établir des cumuls sur une périodicité non prédéfinie par le progiciel, on peut définir ici le nom d'un traitement dont les sous-programmes suivants devront être définis :

  • # Ce sous-programme permet de recaler une date (définie par DAT1)
    # pour qu'elle corresponde à une fin de période.
    # Le résultat est DAT2.
    # LIBCLE correspond au libellé de la période sous forme alphanumérique.

    Subprog BORNES(DAT1,DAT2,LIBCLE)
    Value    Date    DAT1
    Variable Date    DAT2
    Variable Char    LIBCLE
  • # Ce sous-programme recadre une date (définie par DA1) pour qu'elle corresponde à un début de période.
    Subprog CADRE(DAT1)
    Variable Date DAT1
  • # Ce sous-programme renvoie dans DAT2 la fin de la période définie par DAT1
    Subprog DATFIN(DAT1,DAT2)
    Value Date DAT1
    Variable Date DAT2
  • # Ce sous-programme renvoie le nombre de périodes (signé) séparant deux dates
    Subprog DECAL(DAT1,DAT2,DECAL)
    Value Date DAT1
    Value Date DAT2
    Variable Integer DECAL
  • # Ce sous-programme ajoute un nombre de périodes (signé) à une date de fin
    Subprog RECAL(DAT1,DAT2,DECAL)
    Value Date DAT1
    Variable Date DAT2
    Value Integer DECAL

Un exemple de tels sous-programmes peut être consulté en regardant le traitement SUBSTADEC, qui définit les sous-programmes correspondant à la gestion par décade.

  • Périodicité (champ PERTYP)

Périodicité pour laquelle on désire effectuer la statistique. Un menu local permet de définir différentes périodicités (journalière, hebdomadaire, par quinzaine, mensuelle...)

Les enregistrements de cumul créés par l'agrégation statistique sont datées du premier jour de la période.

Gestion

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

Il doit être défini dans la table des événements déclencheurs.

  • Validité début (champ VLYSTR)

Les dates de début et de fin devalidité définies sur certaines fiches permettent de limiter lavalidité d'une fiche entre deux dates.

  • Validité fin (champ VLYEND)

 

  • Code mise à jour (champ UPDCOD)

Ce code est par défaut le code de la statistique/ Mais il peut être différent, notamment si on désire constituer un seul agrégat à partir de plusieurs événements déclencheurs différents (ce qui impose plusieurs codes statistiques). Dans ce cas, le code de mise à jour sera commun à tous les codes statistiques.

  • Temps conservation (champ TIM)

Temps de pérennité de la statistique exprimé en nombre de mois. Ce temps est utilisé par la gestion des épurations, dès lors que l'on décide d'épurer les données statistiques.

Les données statistiques étant en général assez fortement agrégées, elles prennent une place limitée, et il est souvent intéressant de garder ces statistiques pendant une assez longue durée.

  • Date mise à jour (champ LSTDAT)

Cette date affichée permet de connaître la dernière date à laquelle un cumul a été réalisé par recalcul de la statistique.

Consultation

Permet de définir le code écran utilisé par défaut pour la consultation de statistique correspondante.

Ce code écran, de type STA, est défini dans la fonction de paramétrage des écrans de consultation.

En l'absence de valeur, l'écran STD est utilisé.

Ce champ permet de donner accès à une fiche depuis le niveau le plus bas de la consultation statistique, en définissant le code de l'objet correspondant. La clé de cette fiche doit être en ligne à ce niveau. Habituellement, il s'agit du code objet attaché à la table dont on cumule des valeurs dans la statistique.

Ce champ permet de saisir l'état Crystal Reports associé à la consultation de ce code statistiques (lancé via Fichier / Liste).

Un état générique nommé STAT existe, mais cet état présente toutes les colonnes de façon uniforme, alors qu'il est possible, en connaissant le contexte, de créer un état personnalisé par copie et modification de cet état. 

 

Caractéristiques

  • Niveau définition (champ UPDLEV)

Permet de définir le niveau organisationnel du cumul par période (un cumul global, par société, ou par site).

Le niveau de détail site ne peut être obtenu que si l'événement déclencheur définit un code site; le niveau de détail société peut être obtenu si un site ou une société sont définis dans l'événement déclencheur.

A la restitution, on pourra demander soit le détail le plus fin paramétré ici, soit un niveau agrégé (par société ou global si le cumul a été géré par site).

  • Type (champ TYP)

Permet de définir si le cumul dans les enregistrements statistiques est mis à jour en temps réel ou en batch.

Il est important de noter que seuls les événements déclenchants standards peuvent donner lieu à des agrégations en temps réel (à chaque fois qu'une mise à jour est faite, le cumul est réalisé). Sauf si un spécifique est réalisé, des statistiques basées sur des événements déclencheurs non standards pourront uniquement être mis à jour en batch.

Pour des raisons de performance, la mise en oeuvre de nombreux cumuls standards basés sur un événement déclencheur donné peut ralentir la transaction correspondante. Il est donc prudent de privilégier les statistiques en mode batch et de prévoir une tâche batch régulière chargée de les mettre à jour.

Bloc numéro 6

 

Onglet Champs

Présentation

Cet onglet permet de définir, dans deux tableaux successifs :

  • les critères de regroupement sur lesquels les cumuls statistiques sont gérés. A la restitution, il sera possible de voir les cumuls de statistiques aux différents niveaux d'agrégation sur ces valeurs de critères. Ces critères de regroupement sont des champs (ou des sous-chaînes issus de ces champs) extraits des tables en ligne.

    Si ces champs sont typés (liés à une autre table, par exemple), un intitulé associé sera également stocké dans l'enregistrement d'agrégation. Par exemple, si on utilise le code utilisateur (de type AUS), le nom de l'utilisateur sera stocké et pourra être restitué.
  • les expressions à cumuler, qui pourront être restituées soit directement, soit par le biais de formules (ratios, comparatifs, pourcentages) définis dans l'onglet Avancé.Ces expressions sont définis dans un tableau de 10 lignes maximum.

 

Champs

Les champs suivants sont présents dans cet onglet :

Tableau Champs

Définit la table dans laquelle se trouve le critère de regroupement de la ligne de statistique.

  • Abréviation (champ TBLABR)

Lorsque la table précédente est plusieurs fois en ligne dans l'événement déclencheur, on précisera ici l'abréviation utilisée dans ce cas particulier.

  • Champ (champ FLDNAM)

Définit le code du champ tel qu'il est connu dans la table.

  • Indice (champ FLDIND)

Quand le critère choisi est multi-occurrences, la valeur de ce champ permet de donner un indice (allant de 0 à N-1, si N est le nombre d'occurrences du champ).

  • Intitulé (champ FLDINTIT)

Définit l'intitulé du critère tel qu'il devra apparaître lors de l'interrogation de la statistique. Par défaut, l'intitulé du champ est repris dans le dictionnaire, ce qui permet d'afficher l'intitulé dans la langue de connexion de l'utilisateur.

Mais il est également possible de le modifier pour lui donner un intitulé différent, qu'il faut pouvoir définir dans différentes langues.

Sur des champs traduisibles tels que celui-ci, vous pouvez saisir un intitulé dans d'autres langues que la langue de connexion courante : cliquez sur Traductions en ligne, depuis l'icône Actions.
SEEREFERTTO Pour plus d'informations, reportez-vous à : Traduction en ligne d'intitulés.

  • Groupe (champ FLDGRP)

 

  • Position (champ FLDPOS)

Quand le champ critère est une chaîne de caractère, il est possible de définir l'agrégation sur une sous-chaîne de caractère en définissant la position du premier caractère retenu (1=début de chaîne) et la longueur.

Par exemple :

  • si on désire structurer le cumul sur les deux premiers chiffres d'un code postal de 5 caractères, on donnera la position 1 et la longueur 2;
  • si on souhaite structurer le cumul sur les trois derniers chiffres d'un code à 8 caractères, on donnera la position 6 et la longueur 3.
  • Longueur (champ FLDLON)

 

  • Type (champ FLDTYP)

Champ uniquement affiché qui indique le type de donnée (caractère, numérique, menu local, date..) correspondant au critère saisi sur la ligne.

Tableau Valeurs

  • Variable (champ VARNAM)

Définit l'intitulé proposé par défaut en regard du cumul statistique.

  • Intitulé (champ AMTDES)

Définit l'intitulé du cumul stocké dans l'enregistrement statistique.

  • Formules (champ AMTFOR)

Cette formule calculée, qui peut faire appel à toutes les variables et tables en ligne au moment de l'agrégation, est évaluée, et son résultat est cumulé dans l'agrégat statistique correspondant à la période et au niveau organisationnel d'agrégation défini.

  • Prévision (champ FRTFLG)

Si cet indicateur vaut Oui, il est possible de définir des prévisions pour le montant cumulé correspondant.

Ces prévisions pourront être saisies, calculées à partir du réel ou de prévisions d'une autre période, et ce à une maille d'agrégation librement définie à partir des critères définis pour la statistique.

A la restitution de la statistique, on pourra présenter à la fois les cumuls calculés, les prévisions correspondantes, et toute expression faisant intervenir les deux (ceci se paramétrant sur l'onglet Avancé de la statistique).

  • Conversion (champ CNV)

Cet indicateur permet de préciser si l'expression précédente est exprimée dans une devise, dont on pourra ensuite donner la devise par une expression calculée, ainsi que la devise commune dans laquelle elle doit être convertie.

La conversion se fait au taux historique défini à la date de référence de l'événement déclencheur, le type de cours utilisé pour la conversion étant défini par le paramètre CHGTYP (le premier type si rien n'est défini).

Ainsi, on peut obtenir des montants cumulés exprimés de façon homogène.

  • Devise origine (champ DEVORG)

Lorsque le montant statistique est exprimé en devise, ce champ permet de connaître le code de la devise de destination, afin de pouvoir convertir les montants dans une devise commune avant de les cumuler.

Il s'agit d'une expression calculée soit de type constante, soit faisant intervenir une variable commune comme par exemple GSYSCUR.

  • Devise destination (champ DEVDES)

Lorsque le montant statistique est exprimé en devise, ce champ permet de connaître le code de la devise d'origine, afin de pouvoir convertir les montants dans une devise commune avant de les cumuler. Il s'agit d'une expression calculée soit de type constante, soit faisant intervenir des champs en ligne au moment de l'agrégation.

 

Onglet Avancé

Présentation

Lorsque la restitution statistique ne se résume pas simplement à une présentation des cumuls réalisés sur l'onglet précédent, on vient ici remplir cet onglet avec les informations supplémentaires suivantes :

  • un tableau des colonnes à afficher. Par défaut, à la création d'une statistique, les intitulés des cumuls sont repris.
  • d'éventuels critères si l'on désire filtrer les données que l'on cumule par des expressions logiques qui devront être vérifiées pour que le cumul se fasse.

 

Champs

Les champs suivants sont présents dans cet onglet :

Tableau Colonnes

  • Intitulés (champ INTITFRM)

Ce champ définit l'intitulé de la colonne tel qu'il sera présenté lors de la consultation. Si l'on désire que la consultation puisse être faite dans d'autres langues que la langue de connexion originelle, il faudra traduire l'intitulé.

Sur des champs traduisibles tels que celui-ci, vous pouvez saisir un intitulé dans d'autres langues que la langue de connexion courante : cliquez sur Traductions en ligne, depuis l'icône Actions.
SEEREFERTTO Pour plus d'informations, reportez-vous à : Traduction en ligne d'intitulés.

  • Formules (champ AMTFRM)

On saisira ici la formule qui permet de calculer le montant de la colonne. Cette formule peut faire intervenir des constantes, des fonctions, et les variables suivantes (qui peuvent être sélectionnées via clic droit) :

  • C1, C2... Cn représentent les cumuls définis dans le tableau des valeurs de la statistique, exprimées sur la période courante.
  • CC1, CC2, ... CCn représentent les cumuls sur la période précédente.
  • P1, P2... Pn représentent les prévisions sur la période courante (si elles existent).
  • PP1, PP2... PPn représentent les prévisions sur la période précédente (si elles existent).

Lors de la consultation, on saisira la période de consultation de la statistique et également la période précédente si au moins une des formules fait apparaître des données relatives à la période précédente.

Des formules complexes, pouvant faire intervenir des opérateurs, des fonctions, et des variables, peuvent être utilisées : toute expression arithmétique est ici admise, et peut être paramétrée à l'aide de l'assistant de formules, par exemple :

  • C1/CC1 qui permet de calculer le ratio entre une colonne à une date donnée et sa valeur à la période précédente.
  • C1/(CC1+(CC1=0)) qui est identique à la précédente, mais si CC1 est nul, on divisera par 1 au lieu de 0...
  • max(P1,PP1)/1000 qui exprime le maximum entre la prévision de la période et la période précédente divisé par 1000
  • Type colonne (champ CUMFRM)

Ce type de colonne permet de définir des cumuls sur les montants affichés. Les valeurs possibles sont les suivantes :

  • Normal(on affiche le montant calculé)
  • Cumul progressif(la ligne N est égale à la ligne N-1 plus le résultat du calcul sur la ligne)
  • % du total(on affiche le ratio en pourcentage entre le montant de la ligne et le montant cumulé de toutes les lignes du tableau).
  • % cumulé (on affiche le ratio en pourcentage entre le montant cumulé des N premières lignes et le montant de toutes les lignes du tableau).

Attention, si le tableau ne présente pas la totalité des lignes (c'est le cas si le bouton Suite n'est pas grisé, sur le premier onglet), il ne s'agit pas d'un pourcentage par rapport au total général, mais uniquement par rapport aux lignes présentes dans le tableau : ceci se produit si le nombre de lignes paramétrées pour l'écran de consultation est inférieur au nombre de critères du niveau consulté).

Par exemple, si on a un tableau de consultation limité à 10 lignes, 20 critères CR01 à CR20, pour lesquels le montant cumulé est alternativement égal à 50 et 100, et 4 colonnes paramétrées C1 (Normal, Cumul progressif, % du total, % cumulé), on va voir apparaître sur le premier onglet les montants suivants :

Critères

C1 Normal

C1 Cumul Prog

C1 % du total

C1 % cumulé

CR01

50

50

6.67

6.67

CR02

100

150

13.33

20.00

CR03

50

200

6.67

26.67

CR04

100

300

13.33

40.00

CR05

50

350

6.67

46.67

CR06

100

450

13.33

60.00

CR07

50

500

6.67

66.67

CR08

100

600

13.33

80.00

CR09

50

650

6.67

86.67

CR10

100

750

13.33

100.00

  • Format (champ FMTFRM)

Permet de définir, sous forme décimale, le nombre de chiffres avant et après la virgule utilisés. Si ce champ n'est pas renseigné, on utilise la valeur du paramètre FMTSTA.

Conditions

  • Critères (champ CRI)

Définit des conditions logiques portant sur des constantes, des fonctions, et des champs en ligne lors du processus de cumul. Si les conditions ne sont pas réalisées, le cumul n'est pas fait (s'il y a plusieurs lignes, les critères sont liés par un et logique).

 

Boutons spécifiques

Ce bouton permet de générer les traitements automatiques liés au code statistique. Cette validation est normalement enchaînée à la modification ou à la création d'un code. Elle n'est donc nécessaire que si les traitements ont été supprimés, ou si le paramétrage a été créé par copie à partir d'un autre dossier (dans ce cas, la validation n'est pas faite automatiquement).
 

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.

Messages d'erreur

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

Pas de lien vers la table XXXX

On a voulu utiliser un critère extrait d'une table non référencée comme liée dans l'événement déclenchant.

Variable non définie

On a voulu utiliser dans le tableau des variables une variable non définie dans l'événement déclenchant.

Expression incorrecte

L'expression arithmétique saisie est syntaxiquement incorrecte (un complément d'information peut suivre ce message)

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre