Cegid XRP Ultimate  |  I3   Actualisé le 06/10/2022
Fondations
GTIND - Indicateurs

   Il s'agit de la transaction principale de définition des indicateurs, également accessible via le conteneur GKTIND.
Un indicateur représente un ensemble de données calculées pour une période définie. Ces données proviennent de Cegid XRP Ultimate ou d'une source externe.
A partir d'une représentation visuelle appelée restitution, un indicateur met en évidence une information de manière directe afin d'orienter des décisions, des choix, etc. Il sera possible d'évaluer une tendance, mettre en relief une évolution, d'établir une analyse précise en naviguant dans le détail des données voire de les comparer à des seuils prédéfinis.

   Exemple : indicateur représentant le chiffre d'affaires par mois d'une société. Suite au calcul, on aura la valeur 10M EUR pour Janvier, 12M EUR pour Février, 8M EUR pour Mars, etc.

   A noter que les valeurs d'un indicateur sont calculées à un instant donné, puis restituées, et ne sont pas une représentation en temps réel.

   Plus de détails sur la définition d'un indicateur : Les indicateurs et leur restitution.

Données

   Indicateur
   Identifiant universel non saisissable, attribué automatiquement.

   Des indicateurs standard standard sont proposés. Les utilisateurs pouvant en définir d'autres selon leurs besoins spécifiques.

   Règles de codification de l'identifiant universel :
- un indicateur standard commence par la lettre Q. S'il est défini par le Pôle Solutions, il commence par QS1, QS2, etc. ;
- un indicateur spécifique à un client utilisateur de Cegid XRP Ultimate, mais défini par Cegid, commence par la lettre X. Pour le définir, ouvrir la transaction GTIND ou GKTIND en étant connecté en tant que "client", sinon il commencera par la lettre Q ;
- un indicateur défini par un client utilisateur de Cegid XRP Ultimate lui-même, commence par la lettre Y.

   Les indicateurs standard ne sont pas modifiables par les clients utilisateurs du produit.

   Intitulé
   Les indicateurs standard sont multilingues.

   Mode de calcul
   Le calcul de l'indicateur peut s'effectuer selon plusieurs modes :
- requête ;
- mise à jour via l'interface ;
- mise à jour via un traitement ;
- entre indicateurs (valeurs stockées) ;
- entre indicateurs (valeurs non stockées).

   Pour plus de détails sur chaque mode, voir le paramètre CALGTIND.

   Application
   Application d'appartenance d'un indicateur standard.
Non gérée pour un indicateur défini par un client utilisateur de Cegid XRP Ultimate.

   Version
   La version est utilisée uniquement lors de la définition des indicateurs standard.
La version est facultative et non significative pour un indicateur défini par un client utilisateur de Cegid XRP Ultimate.

   Pour Cegid :
- Saisir "ENCOURS" lors du développement de l'indicateur.
Le fait de saisir "ENCOURS" permet de réserver l'indicateur et de le rendre modifiable.
- Une fois l'indicateur terminé, saisir le numéro de release dans laquelle il sera disponible incrémenté d'un sous-numéro si l'indicateur est modifié plusieurs fois lors d'une release : H2.01.01
Le fait d'incrémenter le sous-numéro dans une version permet de le visualiser dans la différence de base de données.

   Bibliothèque
   La bibliothèque (GTINB) est un critère de regroupement des indicateurs afin notamment d'isoler les indicateurs standard des autres.

   Choix de la bibliothèque :
- un indicateur standard appartient à la bibliothèque "INDSPRD" ou à la bibliothèque complémentaire de son application ("INDSAPP" où APP correspond à l'application) ;
- un indicateur spécifique à un client utilisateur de Cegid XRP Ultimate, mais défini par Cegid, appartient à la bibliothèque "INDSSPE". L'application spécifique du client doit être renseignée.
L'indicateur peut également être sur une bibliothèque "métier" faisant référence à un module ;
- un indicateur défini par un client utilisateur de Cegid XRP Ultimate lui-même, appartient à la bibliothèque "INDCUSTOM".

   Dernier calcul
   Date et heure de dernier calcul de l'indicateur.

   Périodicité
   Les champs "Date" et "Heure" représentent la périodicité de stockage des valeurs de l'indicateur.
La périodicité est utilisée lors du calcul des valeurs de l'indicateur, pour les regrouper selon une période donnée telle que le mois, le jour, l'année, etc.

   Date
   Les valeurs correspondent aux occurrences du paramètre PEDGTIND.

   Heure
   Les valeurs correspondent aux occurrences du paramètre PEHGTIND.

   Expressions de la période de recherche
   Pour les indicateurs dont le mode de calcul est une requête, les fourchettes de dates et heures représentent un filtre de temps à appliquer sur les dates et heures des données. Ces fourchettes sont utilisées lors du calcul de l'indicateur et peuvent être basées sur des symboles.
Si elles ne sont pas renseignées aucun filtre n'est appliqué.

   Confidentialité
   Cette case à cocher indique s'il faut gérer ou non la confidentialité pour cet indicateur.

   La confidentialité (GTINRC) s'appliquera lors de la restitution des données et non lors du calcul de celles-ci.

   Historiser valeurs
   Par défaut, les résultats des calculs sont historisés de façon à comparer l'évolution des chiffres. Le calcul des valeurs d'un indicateur insère dans l'historique une valeur nouvelle sur une période, sinon il la met à jour.
Si la case est cochée, chaque valeur précédemment calculée est conservée. Attention : cette méthode peut engendrer un volume de données important qui ne sera pas exploité graphiquement.

   Périodes sans valeur
   Cette option détermine, si lors de la restitution de l'indicateur, il faut afficher les périodes n'ayant pas de valeurs.
Par exemple, si une colonne n'a pas de lignes de données pour une période donnée et que cette case n'est pas cochée, alors cette période ne sera pas représentée dans la restitution.

   Type de la valeur
   Le type des valeurs calculées par un indicateur peut être numérique (un montant, une quantité, etc.), alphanumérique (une cotation) ou date.

   Les valeurs correspondent aux occurrences du paramètre TVIGTIND.

   Unité
   Unité dans laquelle sont stockées les valeurs de l'indicateur. L'unité n'a qu'une valeur indicative, elle correspond aux occurrences du paramètre UNIGTIND.

   Durée de vie
   Si elle est renseignée, elle permet de spécifier une durée de vie des valeurs calculées. Une fois le délai dépassé (en nombre de jours à partir de la date de calcul), les valeurs seront automatiquement supprimées de la base de données.

   Nombre de jours maximum pour mise à jour
   Pour les indicateurs dont le mode de calcul est une requête, permet de spécifier le nombre de jours durant lesquels le calcul des données de la période précédente pourra être effectué. Passé ce délai, un nouveau calcul n'est plus nécessaire.
Exemple avec 15 jours : si on calcule un chiffre d'affaires par mois, on considère qu'au 15 du mois N, on connaît le chiffre du mois N-1. Il ne sera donc plus recalculé à partir du 16.

   Identifiant
   Autre numéro unique identifiant un indicateur, attribué automatiquement. Visible uniquement en mode grille.

   Niveaux
   Définition des niveaux successifs de détail de l'indicateur numérotés de un à dix.
Ceux-ci permettront tout d'abord de stocker, puis de naviguer dans le détail des données de l'indicateur (mécanisme de "drill-down", parcours du niveau le plus général jusqu'au niveau le plus détaillé).
Pour chacun de ces niveaux, trois informations sont disponibles selon le mode de calcul de l'indicateur.

   Détails des colonnes

   Numéro
   Ce numéro permet d'identifier les colonnes contenant le détail des valeurs de l'indicateur. De plus, il représente les niveaux de drill-down dans la restitution.

   Colonne
   La colonne est définie uniquement pour le mode de calcul "Requête".
S'il s'agit d'une colonne d'une table, l'identifiant et l'intitulé seront renseignés automatiquement.

   Identifiant
   L'identifiant de la colonne permet de spécifier un nom unique pour le niveau de l'indicateur.

   Intitulé
   L'intitulé de la colonne définit le texte qui sera affiché dans le fil d'Ariane de la restitution.
Cet intitulé est multilingue pour les indicateurs standard.

   Paramètres standard

   Mise à jour entre indicateurs
   Dans le cas du mode de calcul "Entre indicateurs", la formule de calcul doit être définie ici.
Quatre opérateurs sont disponibles : l'addition, la soustraction, la multiplication et la division. Ainsi, on va pouvoir effectuer une opération intégrant des indicateurs et/ou des constantes.
Si un ordre de priorité des opérations doit être respecté, il faut ajouter des parenthèses dans les champs dédiés.

   Remarque : pour effectuer un calcul entre indicateurs, ils doivent comporter des caractéristiques communes (périodicité, niveaux de détail représentés par leurs identifiants).

   Exemple

   

   Mise à jour via requête
   Informations à ne renseigner que pour le mode de calcul "Requête".
Possibilité de vérifier la syntaxe et le fonctionnement de la requête en utilisant le bouton "Tester" de la barre de recherche simplifiée.

   SGBD
   Pour un même indicateur, la syntaxe de la requête peut différer suivant le SGBD.
Par exemple, les mêmes données techniques sont recherchées dans une table X sous Sybase et dans une table Y sous Oracle.

   Effacer
   L'icône efface la requête correspondant au SGBD sélectionné.

   Formule
   Formule de calcul à appliquer sur les données. Il est possible de faire une somme, une moyenne, d'obtenir le nombre, la valeur maximale ou encore la valeur minimale.
Pour un indicateur de type alphanumérique ou date, aucune formule n'est nécessaire.
Les valeurs correspondent aux occurrences du paramètre FMLGTIND.

   Colonne d'application
   La valeur de ce champ est rattachée à la formule et définit donc sur quelle colonne elle sera appliquée.
Il est possible de spécifier une expression SQL par exemple "coalesce".

   Colonnes de recherche

   Date
   Il s'agit de la colonne date sur laquelle s'applique le filtre de recherche sur les dates.
Elle est également utilisée pour regrouper les données selon la période de stockage prédéfinie.

   Heure
   Il s'agit de la colonne heure sur laquelle s'applique le filtre de recherche sur les heures.
Elle est également utilisée pour regrouper les données selon la période de stockage prédéfinie.

   From
   Ensemble des tables (et éventuels alias) de la requête SQL.

   Where
   Restrictions sur les données ramenées par la requête SQL.
Certaines restrictions sur les dates de recherche sont automatiquement calculées.

   Pour que la requête SQL fonctionne sur tous les SGBD, on utilise des symboles pour les fonctions SQL dont la syntaxe diffère d'un SGBD à l'autre. Ces symboles seront remplacés lors de d'exécution de la requête. Ils correspondent aux occurrences des paramètres SYMB_ISE, SYMB_MSQ, SYMB_ORA, SYMB_SYB et SYMB_UDB.

   Having
   Fonction de filtre de regroupement spécifiée dans une clause particulière commençant par le mot-clé "Having" (ajouté automatiquement à la requête), celle-ci se place après la clause "Group by".

   Select
   Affichage de la requête SQL complète.

   Substitution
   Afin de rendre un indicateur flexible à chaque besoin fonctionnel, une requête peut utiliser des conditions paramétrables.

   Plutôt que de coder directement dans la clause "Where" de la requête, "colonne = 'ZZ' avec une valeur fixe", on utilisera "colonne = ?".
La variable représentant le "?" équivaut à un symbole. Ce symbole (GTSER) est associé à une valeur pouvant être personnalisée par les utilisateurs.

   Exemple :
Syntaxe SQL : where etssvcdv = ? and clasvcdv in (?)
Substitution variable 1, équivaut à un symbole défini pour l'établissement.
Substitution variable 2, équivaut à un symbole défini pour la classe.
Dans GTSER, le symbole défini pour l'établissement a pour valeur IND ; valeur personnalisable.
Dans GTSER, le symbole défini pour la classe a pour valeur 'VENTE','ACHAT','AVOIR' (valeur personnalisable).
Syntaxe SQL exécutée : where etssvcdv = 'IND' and clasvcdv in ('VENTE','ACHAT','AVOIR').

   Variable
   Varie de 1 à n.
La variable numéro 1 correspond au premier "?" présent dans la requête SQL, la numéro 2 au second, etc.

   Symbole équivalent
   Les symboles sont définis dans la transaction GTSER.

   Filtres
   Le but est de pouvoir compléter la clause "Where" d'une requête associée à un indicateur standard.
L'utilisateur de l'indicateur peut définir des filtres supplémentaires qui s'ajouteront à ceux de la requête d'origine (personnalisation de la requête SQL en saisissant directement la syntaxe SQL).

   Pour que la requête SQL fonctionne sur tous les SGBD, on utilise des symboles pour les fonctions SQL dont la syntaxe diffère d'un SGBD à l'autre. Ces symboles seront remplacés lors de d'exécution de la requête. Ils correspondent aux occurrences des paramètres SYMB_ISE, SYMB_MSQ, SYMB_ORA, SYMB_SYB et SYMB_UDB.

Boutons poussoirs

   Tester
   Pour le mode de calcul "Requête", ce bouton (accessible au niveau de la barre de recherche simplifiée) permet de vérifier la syntaxe et le fonctionnement de la requête en indiquant le nombre de lignes de données ramenées.

   Aide
   Permet d'obtenir la documentation sur l'indicateur sélectionné.

Transactions associées
   GTINV - Valeurs de l'indicateur

   GTINM - Mise à jour des valeurs des indicateurs

   GTINRI - Requêtes des intitulés des valeurs de l'indicateur

   GTINRC - Requêtes de confidentialité des valeurs

   GTICX - Contexte de mise à jour d'un indicateur

   DTIND - Duplication d'un indicateur ou d'une restitution

   GTIDS - Liste des indicateurs de la restitution

Paramètres
   CALGTIND

   PEDGTIND

   PEHGTIND

   TVIGTIND

   UNIGTIND