Cegid XRP Ultimate  |  
I3   Actualisé le 06/10/2022
Fondations
GTICX - Contexte de mise à jour d'un indicateur

   Le contexte est une notion nécessaire pour les indicateurs dont le mode de calcul est "Mise à jour via un traitement".
Le paramétrage du traitement (critères de soumission, définition de ruptures particulières) est lié à la définition de l'indicateur.

   Les traitements batchs (traitements ou éditions), mettant à jour les valeurs de l'indicateur, utilisent, pour leur lancement, la mécanique de génération de travaux (gtumnu.exe).
Le travail ainsi généré est pris en charge par les automates classiques des files de travaux, avec un numéro identifiable dans CJOB.

   Cette transaction indique quel traitement et quel contexte sont utilisés par un indicateur.

Données

   Contexte
   Le nom du contexte est arbitraire et afin d'éviter les conflits, suivre ces règles de codification :
- un contexte standard commence par Q_. S'il est défini par le Pôle Solutions de Cegid, il commence par QS1_, QS2_, etc. ;
- un contexte spécifique à un client utilisateur de Cegid XRP Ultimate, mais défini par Cegid, commence par X_ ;
- un contexte défini par un client utilisateur de Cegid XRP Ultimate lui-même, commence par Y_.

   Le contexte est lié au paramétrage du lancement d'un job.
Il ne peut être lié qu'à un seul traitement, mais un traitement peut être lié à plusieurs contextes.
Un indicateur ne peut être lié qu'à un seul couple contexte-traitement, mais un couple peut être lié à plusieurs indicateurs. Les valeurs de plusieurs indicateurs peuvent être mises à jour lors d'un même lancement.

   Le fichier de paramétrage contenant les valeurs des paramètres de soumission liés au contexte doit se trouver sur le serveur de traitements dans le répertoire :
- $IAC_HOME/exp/gti/src/ind pour les contextes Cegid ;
- $IAC_HOME/qindic/ pour les contextes clients.

   La norme de codification du fichier de paramétrage est : TRAITEMENT_CONTEXTE.ind
Exemple : OCEPIE_Q_OCEPIE_57.ind

   Les valeurs de ce fichier sont prioritaires sur les valeurs du paramétrage par défaut. Pour les critères ne se trouvant pas dans ce fichier, le paramétrage par défaut personnel continue à s'appliquer.

   La syntaxe de ce fichier est similaire à celle du fichier de paramétrage de gtumnu.exe.

   Exemple pour le contexte : Q_OCEPIE_57
[OCEPIE]
DATECPTD=<DATED>$DEBMOIS;-1M
DATECPTF=<DATEF>$DEBMOIS;-1J
TOTALETS=O
EDTTRT=N
DETPIECE=N
NUMOETIED=.
NUMOETIEF=ZZZZZZZZZZ
NUMOECPTD=411
NUMOECPTF=413ZZZZZZZ
TOTAL1=<PTR>PIEATE;107
TOTAL2=<PTR>PIEATE;89
SPISLD=N
SPISLR=N
SPISLF=N

   Syntaxe particulière pour les paramètres de tris et de ruptures (GPTRV)
Pour gérer le libellé de ces paramètres en plusieurs langues, on écrit le mot-clé <PTR> suivi du nom du paramètre de tri, puis de ";" et enfin du sous-numéro du paramètre.
Lors de l'exécution du traitement avec ce contexte, la valeur du paramètre dans la langue de l'utilisateur sera utilisée.
Exemple pour le traitement OCEPIE avec le "critère de totalisation tiers", on écrit : TOTAL1=<PTR>PIEATE;107

   Syntaxe particulière pour les sélections de dates
Le traitement de mise à jour d'un indicateur peut, par exemple, être lancé tous les mois en sélectionnant les données du mois précédent.
Si dans le fichier de paramétrage, on spécifie ces dates telles quelles, on ne peut plus lancer le traitement sur une période antérieure, par exemple pour initialiser les valeurs de l'indicateur sur des années précédentes.
Dans le traitement d'initialisation des valeurs (TTINDC), une fourchette de dates permet de spécifier la fourchette de sélection pour l'initialisation, ensuite les mots-clés <DATED> et <DATEF> permettent dans le fichier de reconnaître les critères de traitement qui correspondent à ces fourchettes.
Exemple pour les dates de sélection du traitement OCEPIE :
DATECPTD=<DATED>$DEBMOIS;-1M
DATECPTF=<DATEF>$DEBMOIS;-1J

   Syntaxe particulière pour la suppression des données suivant la sélection de dates
Par défaut, lors d'un n-ième lancement sur une même période, le traitement ne supprime pas les données existantes, il met à jour les valeurs déjà présentes.
Si la donnée n'est plus ramenée, son ancienne valeur sera conservée.
Dans certains cas, il peut être nécessaire de supprimer des données correspondant à une fourchette de dates liée aux paramètres du traitement.
Dans le fichier de paramétrage, cela se traduit par la syntaxe :
<DATESUPD>=DATECPTD
<DATESUPF>=DATECPTF

   Traitement

   Indicateur

   Paramètres standard

Transactions associées

   GTDEC - Définition du découpage de l'édition

   GTINMC - Mise à jour des valeurs des indicateurs / contexte

   GTPST - Paramètres de synchronisation pour un traitement