Cegid XRP Ultimate  |  
I3   Actualisé le 06/10/2022
Fondations
Symboles utilisables en paramétrage

Objectif
Liste des symboles prédéfinis
Symboles paramétrables
Symboles complémentaires
Symboles dates sur lesquels on peut ajouter ou soustraire
Grammaire sur les symboles / Calcul de dates par expressions
Symbole heure sur lequel on peut ajouter ou soustraire
Grammaire sur les symboles / Calcul d'heures par expressions
Concaténation de texte

   Objectif

Pour faciliter la saisie des valeurs par défaut dans les transactions, il a été mis en place une liste de symboles.

   Liste des symboles prédéfinis

$ETS : établissement de connexion.

$WSA : poste de travail.

$USER ou $USR : utilisateur de connexion.

$GESUSR : gestionnaire associé à l'utilisateur de connexion.

$COTUSR : contact associé à l'utilisateur de connexion (symbole utilisable uniquement si l'Application XRM est en place).

$LANG : langue de l'utilisateur de connexion.

$TERRITORY : territoire de l'utilisateur de connexion.

$DEPGES : dépôt associé à l'utilisateur de connexion.
Sur l'établissement de connexion, c'est le plus petit des codes dépôts ayant les mêmes tiers et adresse que le gestionnaire associé à l'utilisateur connecté.
Ce symbole ramène la valeur "??????" si :
      - l'Application Supply Chain Foundations n'est pas installée ;
      - le tiers et l'adresse du gestionnaire ne sont pas renseignés.

$DEPGESPHY : dépôt physique associé à l'utilisateur de connexion.
Sur l'établissement de connexion, c'est le plus petit des codes dépôts physiques ayant les mêmes tiers et adresse que le gestionnaire associé à l'utilisateur connecté.
Ce symbole ramène la valeur "??????" si :
      - l'Application Supply Chain Foundations n'est pas installée ;
      - le tiers et l'adresse du gestionnaire ne sont pas renseignés.

$MAIL : adresse électronique du gestionnaire associé à l'utilisateur de connexion.

$DATMIN : date minimale.

$DATMAX : date maximale.

$ANNEE : année courante sur 4 caractères.

$VIDE : valeur nulle.

$BASE : nom de la base de données.

$MAC : nom de la machine sur laquelle se trouve la base de données.

$SEQUENCE : numéro séquentiel incrémenté de 1 en 1 à chaque utilisation.

$HORO : horodatage à la milliseconde.

$IAC_HOME : si ce symbole est présent dans un critère de soumission, il sera automatiquement remplacé par sa valeur sur le serveur de traitements lors de l'exécution du travail.

   Symboles paramétrables
Toutes les occurrences du paramètre SYMBOLE, saisies dans GPAR, peuvent être utilisées comme symbole.
La valeur testée 1 de ces occurrences définit le type du symbole (C : Caractères, D : Date, N : Numérique).
Suivant le type du symbole, la valeur du symbole retournée est stockée dans les différents champs :
          - C : chaîne 1
          - D : date 1
          - N : valeur 1

Si le symbole correspond à une date, il est possible de l'utiliser dans des calculs (Cf. ci-dessous).

ATTENTION : En mode paramétrage d'une transaction, si de nombreuses occurrences de ce paramètre sont utilisées, les performances lors de l'ouverture de la transaction risquent d'être altérées.

   Symboles complémentaires
De plus, des symboles complémentaires, définis dans GTSER, sont pris en compte lors de la saisie des valeurs par défaut dans les transactions.

   Symboles dates sur lesquels on peut ajouter ou soustraire

- des jours (+nJ ou -nJ) ;
- des jours ouvrés (+nO ou -nO). Jours étant définis dans le calendrier "MOR" ;
- des mois (+nM ou -nM) ;
- des années (+nA ou -nA).

$JOUR : date système.

$LOG ou $DATLOG : date logique.

$DEBMOIS : 01MMAAAA / date système.

$FINMOIS : fin MMAAAA / date système.

$DEBMOP : début mois précédent / date système.

$FINMOS : fin mois suivant / date système.

$DEBAN : 1er jour année courante / date système.

$FINAN : dernier jour année courante / date système.

$DEBMOANP : 1er jour du mois année précédente / date système.

$FINMOANP : dernier jour du mois année précédente / date système.

$LUNDI : dernier lundi précédant la date courante / date système.

$MARDI : dernier mardi précédant la date courante / date système.

$MERCREDI : dernier mercredi précédant la date courante / date système.

$JEUDI : dernier jeudi précédant la date courante / date système.

$VENDREDI : dernier vendredi précédant la date courante / date système.

$SAMEDI : dernier samedi précédant la date courante / date système.

$DIMANCHE : dernier dimanche précédant la date courante / date système.

$ECH3M :
          - 20 du mois courant si la date système est comprise entre le 1 et le 8 du mois ;
          - dernier jour du mois courant si la date système est comprise entre le 9 et le 18 du mois ;
          - 10 du mois suivant lorsque la date système est comprise entre le 19 et le dernier jour du mois.

$TRAIT :
          - date système si heure système supérieure à l'heure définie dans la chaîne 1 du paramètre AUTGTI occurrence H-TRAIT ;
          - date courante -1 jour si heure système inférieure ou égale à la chaîne 1 ;
          - date courante si l'occurrence du paramètre n'existe pas ou si la chaîne est vide.

$ACH_DATCLO : date de dernier mois clos dans les achats. Date 1 de l'occurrence DATCLO du paramètre AUTSACLO.

$SVT_DATCLO : date de dernier mois clos dans les ventes. Date 1 de l'occurrence DATCLO du paramètre AUTSVT.

$STK_DATCLO : date de dernier mois clos dans les stocks. Date 1 +1 jour de l'occurrence DATCLO du paramètre AUTSTOCK.

$GP_DATCLO : date de dernier mois clos dans la gestion de production. Date 1 de l'occurrence DATCLO du paramètre AUTQAL.

$AMO_DATCLO : date de dernier mois clos dans les immobilisations. Date 1 de l'occurrence CLO du paramètre AUTAMO.

$OCT_DATCLO : date de dernier mois clos dans la comptabilité. Date 1 de l'occurrence DATE du paramètre AUTCPT.

$QPR_DATCLO : date de dernier mois clos dans les projets. Date 1 de l'occurrence DATCLO du paramètre AUTQPR.

$QAM_DATCLO : date de dernier mois clos dans la maintenance. Date 1 de l'occurrence DATCLO du paramètre AUTQAM.

$QTA_DATCLO1 : date de dernier mois clos pour les salariés dans les temps et activités. Date 1 de l'occurrence DATCLO du paramètre AUTQTA.

$QTA_DATCLO2 : date de dernier mois clos pour les intérimaires dans les temps et activités. Date 2 de l'occurrence DATCLO du paramètre AUTQTA.

$DEBEXE : date de début de l'exercice de l'établissement courant.

$FINEXE : date de fin de l'exercice de l'établissement courant.

$DEBTRIM : date de début du trimestre courant.

$FINTRIM : date de fin du trimestre courant.

   Grammaire sur les symboles / Calcul de dates par expressions

Une date peut être déterminée par calculs successifs définis par une expression composée :
     - de symboles (+ ou - un nombre de jours/mois/années) ;
     - d'ajouts/suppressions de jours/mois/années.
     (séparés par des points-virgules)

La date est obtenue en appliquant successivement les composants de l'expression de gauche à droite.

Tous les symboles renvoyant des dates peuvent être formatés via le symbole et ainsi être saisis dans des champs autres que des champs de type date tout en ayant un format date à l'affichage.
En fin de symbole ajouter :
;$F(format:sep)
format : format de la date
         - YYYY ;
         - YYYYMM ;
         - MMYYYY ;
         - YYYYMMDD ;
         - DDMMYYYY ;
         - MMDDYYYY ;
         - MMYYYYDD.
sep: séparateur - ou /

Le format peut être saisi sans séparateur.
ATTENTION : la saisie d'un format d'un symbole sur un champ date peut renvoyer des erreurs ou des dates tout à fait erronées.

Exemples:
Dernier vendredi du mois : $FINMOIS+1J;$VENDREDI.
Premier vendredi du mois suivant : $FINMOIS+1J;$VENDREDI+7J ou $FINMOIS+8J;$VENDREDI ou $FINMOIS+1J;$VENDREDI;+7J.
Dans un champ texte, avoir le mois et l'année suivante au format MM-YYYY : $JOUR+1A;$F(MMYYYY:-).

   Symbole heure sur lequel on peut ajouter ou soustraire

- des heures (+nH ou -nH) ;
- des minutes (+nN ou -nN).


$HEURE : si ce symbole est employé en paramétrage par défaut d'une transaction, il correspond à l'heure d'ouverture de la transaction ; sinon, il retourne l'heure courante.

$DEBHEURE : début de l'heure courante (exemple : pour une heure courante égale à 14h35, le symbole retourne 14h00)

$FINHEURE : Fin de l'heure courante (exemple : pour une heure courante égale à 14h35, le symbole retourne 14h59)

   Grammaire sur les symboles / Calcul d'heures par expressions
Une heure peut être déterminée par calculs successifs définis par une expression composée :
     - de symboles (+ ou - un nombre d'heures/minutes) ;
     - d'ajouts/suppressions d'heures/minutes
     (séparés par des points-virgules).

L'heure est obtenue en appliquant successivement les composants de l'expression de gauche à droite.

Exemple : Demi-heure précédant l'heure courante : $HEURE-1H;+30N.

   Concaténation de texte
Il est possible de concaténer du texte avec un symbole ou une expression de symboles à l'aide du caractère |. Le texte peut être ajouté avant ou après le symbole. Il est également possible de concaténer plusieurs symboles.
Les espaces, majuscule/minuscule sont significatifs dans le texte, mais pas côté symbole.

Exemples d'expressions possibles
$USER | est l'utilisateur de connexion
Liste de pièces de | $USER | à la date du | $JOUR ;$F(DDMMYYYY:/)
Liste de pièces de | $USER | $ETS ou Liste de pièces de |$USER|$ETS

Si l'utilisateur GTI est connecté sur l'établissement 01 le 29/04/2008, on obtiendra les résultats suivants :
GTI est l'utilisateur de connexion
Liste de pièces de GTI à la date du 29/04/2008
Liste de pièces de GTI01