Cegid XRP Ultimate  |  
I3   Actualisé le 06/10/2022
Fondations
GTEPS - Exceptions pour paramètres de synchronisation

   Cette gestion permet de gérer l'exception sur une information de synchronisation à passer entre deux transactions.

   Les paramètres de synchronisation étant définis à la transaction, cette gestion permet de définir des paramètres spécifiques entre deux mnémoniques. C'est le cas lorsqu'il faut passer un paramètre entre deux mnémoniques particuliers et non pour tous les mnémoniques des transactions appelée et appelante.

   Comme son nom l'indique, cette gestion permet de définir des exceptions. Elles doivent être très rares et n'apparaître que quand il n'est pas possible de faire la synchronisation dans la gestion des paramètres de synchronisation GTFPS.

   Cette gestion permet d'agir uniquement sur les paramètres en sortie pour :
      - les modifier ;
      - les supprimer en mettant un "^" dans le nom de la colonne et "constante" dans le type de la colonne ;
      - en créer de nouveaux.

Données

   Mnémonique appelant
   Il s'agit du mnémonique de la transaction appelante. Ce mnémonique peut être saisi à partir du menu général ou à partir de la zone d'appel des mnémoniques.
Ce mnémonique appelant doit être référencé dans la gestion des mnémoniques.

   Mnémonique appelé
   Il s'agit de l'identifiant du mnémonique de la transaction appelée lors de la synchronisation. Celui-ci doit être référencé dans la gestion des mnémoniques.

   Paramètre
   Il s'agit du nom du paramètre de synchronisation qui doit exister dans GPSN.
C'est pour ce paramètre de synchronisation qu'il y a l'exception.

   Propriétaire
   Le propriétaire correspond au propriétaire de l'exception du paramètre de synchronisation.

   Plusieurs propriétaires possibles :
        - IFR : pour les exceptions de paramètres de synchronisation créées par Cegid ;
        - * : pour les exceptions de paramètres de synchronisation créées par les clients. Elles sont prioritaires sur celles du propriétaire IFR. Elles permettent de personnaliser les synchronisations pour une utilisation propre à chaque client ;
        - profil : pour les exceptions de paramètres de synchronisation créées par les clients pour un profil fonctionnel. Elles sont prioritaires sur celles des propriétaires IFR et * ;
        - utilisateur : pour les exceptions de paramètres de synchronisation créées par les clients pour un utilisateur individuel. Elles sont prioritaires sur celles des propriétaires IFR, * et profil.

   Bloc
   Il s'agit du nom du bloc que l'on veut synchroniser.

   Le bloc est le nom technique représentant une partie de la transaction (réservé aux programmeurs). Ce bloc doit être renseigné pour les gestions et consultations graphiques uniquement. Pour les gestions classiques, il n'est pas nécessaire de préciser le bloc.

   Valeur en entrée pour la synchronisation
   Si la synchronisation est activée (case cochée), elle permet :
        - de mettre à jour la valeur par défaut du champ et est proposée en création ;
        - d'exécuter la recherche au moment de la synchronisation en tenant compte de cette information.
Si la synchronisation n'est pas activée (case non cochée), seule la valeur par défaut sera affectée.

   Colonne
   Il s'agit du champ, d'un symbole ou d'une constante pour lequel l'information de synchronisation va être lue ou passée.
Dans la transaction appelante, le champ correspond :
   - au nom de la colonne à lire et à passer aux formes synchronisées pour un type "champ" ;
   - à la valeur correspondant au symbole si le type est "symbole" ;
   - à cette valeur directement si le type est "constante". La constante '^' est un cas particulier : En réception si la valeur vaut '^', le paramètre de synchronisation ne sera pas traité. Cette méthode permet d'annuler un paramètre défini en standard par Cegid.

   Le nom de la colonne peut être retrouvé à l'aide de l'information sur le champ courant (ou propriétés du champ).

   Type de colonne
   Indique quel type de donnée est contenu dans l'information "colonne" (champ FLDGTEPS).
Ce type peut être :
     - Champ : La valeur à passer en synchronisation est le contenu d'un champ de la transaction appelante pour un champ géré en sortie ;
     - Constante : La valeur saisie sera directement passée en synchronisation. Ce type n'est géré que pour les paramètres de synchronisation en sortie. Deux constantes sont gérées de manière particulière :
                     '^' : Qui permet d'éliminer un paramètre
                     'NULL' : Qui permet de faire une sélection sur un champ dont la valeur ne serait pas renseignée ;
     - Symbole : La valeur passée en synchronisation correspond au symbole saisi. Tout symbole doit commencer par '$'. Ce type n'est géré que pour les paramètres de synchronisation en sortie.
Voir liste des symboles.
Le symbole $LANG donne la langue courante de l'utilisateur de connexion.

   Technologie
   Ligne technologique dans laquelle est utilisé le paramètre de synchronisation pour les mnémoniques.

   Champ en sortie du formulaire
   Indique si la valeur pour synchronisation en sortie doit provenir du champ du formulaire de saisie ou du champ du formulaire de recherche.
Cela donne la possibilité de gérer des synchronisations classiques, mais aussi de propager des critères de recherche d'une transaction vers une autre (les fourchettes dans les consultations par exemple).

   Requête SQL à exécuter en sortie de la transaction appelante
   La valeur passée en sortie de la transaction appelante provient d'une requête SQL. Il est possible de prendre en compte les champs de la transaction appelante et des symboles dans les critères de sélection de cette requête. Cette requête ne peut retourner qu'une seule valeur.

   Exemple de codification :

   select ch1gtpar from gtpara where etsgtpar is null and padgtpar = #CO1TABLE# and isnull(occgtpar,'^') = isnull(#CO2TABLE[F]#,'^') and dt1gtpar = #$DATLOG#

   Principe :
- Les champs ou symboles à substituer doivent être entourés par des #.
- Si le champ entre les # commence par '$' : c'est un symbole.
   Les symboles autorisés sont :
       $LANG : Langue par défaut de l'utilisateur connecté
       $USER/$USR : Utilisateur de connexion
       $LOG/$DATLOG : Date logique
       $DATMIN : Date minimale
       $DATMAX : Date maximale
- Le mot-clé [F] après un nom de champ, indique qu'on exécute la requête même si le champ à traiter vaut "null". Attention dans ce cas, prévoir au niveau de la requête le cas où le champ n'est pas encore renseigné. Si on ne force pas la requête, le résultat de la requête retournera "null" tant que tous les paramètres nécessaires à l'exécution ne seront pas renseignés.
- Pour les gestions/consultations graphiques, il est possible de préciser le bloc auquel appartient le champ s'il ne fait pas partie du bloc du paramètre de synchronisation.
Exemple : #BGTITFGSLCT :NUMGTTRAD#
Si le bloc n'est pas renseigné, on va chercher le champ se trouvant dans le bloc défini dans la gestion des paramètres de synchronisation (BLKGTEPS).

   Ordre
   L'ordre est utilisé en entrée de synchronisation. Cette gestion ne gérant que des sorties, il n'est donc pas géré.

   Paramètres standard

Messages
   GTEPS050 - Le mnémonique appelé doit être différent de l'appelant

   GTEPS051 - Le bloc doit être renseigné pour une gestion ou une consultation graphique

   GTEPS053 - Le propriétaire IFR est interdit

   GTEPS054 - Modification/Suppression d'une exception de paramètre de synchronisation impossible pour un enregistrement référence

   GTEPS056 - Le formulaire du champ en sortie doit être "F" (recherche) ou "C" (saisie)