Cette fonction permet de capitaliser un ensemble de variables globales définies dans l'applicatif, et de généré automatiquement la déclaration (voire initialisée si cela est prévu dans la fiche), dans le sous-programme DEFVAR du traitement précisé sur la fiche.  En aucun cas, il n'est possible d'ajouter des lignes de traitement, dans les traitements générés.

Cette fonction est délicate puisqu'elle intervient sur la déclaration de variable dans les traitements. Elle doit être destinée essentiellement aux développeurs et ne doit, en aucun cas, être laissée entre les mains d'utilisateurs non avertis. Il est surtout recommander de ne pas modifier le standard ou de le faire en connaissance de cause. 

La case à cocher "public", si elle est positionnée, indique que la variable globale est ré-utilisable, notamment par le spécifique ; La documentation liée à cette variable est disponible.

Toutes les variables globales utilisées dans le produit ne sont toutes déclarées dans ce dictionnaire. On identifie :

  • celles affectées à un paramètre
  • celles devant exister au-delà d'un traitement.

Pour les variables absentes du dictionnaire, leur déclaration est à faire directement dans le traitement fonctionnel.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

Ecran de saisie

Un seul écran permet d'écrire la variable, d'indiquer son format, son dimensionnement et éventuellement de paramétrer son initialisation.

Bloc numéro 1

Code variable (champ CODVAR)

On adopte la norme suivante, pour le nom de la variable globale :

  • commence par la lettre "G" pour le standard
  • commence par "GX", ou "X" pour le vertical
  • commence par "GY" ou "Y", "GZ" ou "Z" pour le spécifique.

Cette variable appartient à la classe [V].

Intitulé (champ ZINTIT)

Caractéristiques

Code activité (champ CODACT)

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é.
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.
Public (champ PUBFLG)

Ce flag indique que cet élément est publié. Il est donc ré-utilisable par le spécifique. Une documentation associée est livrée.

Descriptif

champ TEXTE

Cette zone texte permet d'afficher des commentaires relatifs à la fiche courante.

Format

Type de données (champ CODTYP)

On définit ici le type de données de la variable global. Si le type de données est de type alphanumérique et défini avec une longueur, la variable globale est alors générée avec une longueur définie par GLONxxx (xxx=type de donnée).

La longueur est obligatoire si le type de données indiqué sur la fiche est de type interne alphanumérique, clob ou blob et n'ayant pas de longueur renseignée.

A l'inverse, la longueur n'est pas saisissable pour tout type de données ayant un type interne autre que alphanumérique, clob et blob.
Type interne (champ TYPTYP)

Champ affiché avec la valeur issue du type de donnée. 

Longueur (champ LNGTYP)

La longueur est obligatoire si le type de données indiqué sur la fiche est de type interne alphanumérique, clob ou blob et n'ayant pas de longueur renseignée.

A l'inverse, la longueur n'est pas saisissable pour tout type de données ayant un type interne autre que alphanumérique, clob et blob.

Formules de dimensionnement

Formule (champ FORDIM0)

Possibilité de définir des variables à une ou deux dimensions, le premier poste commencçant à 0 par défaut, mais selon le paramétrage pouvant commencer à 1.

Permet de définir une valeur par le biais d'une expression calculée pouvant contenir des constantes et des variables.
A partir de 1 (champ FORDEB0)
Formule (champ FORDIM1)
A partir de 1 (champ FORDEB1)

Initialisation

Paramètre (champ PARAM)

Permet de lier une variable à un paramètre, pour ainsi, récupérer automatiquement la valeur du paramètre dans cette variable globale lors de la connexion au dossier.

 
champ DES1
Formule (champ FORINI)

Champ permettant l'initialisation du champ. Génération de l'alimentation de la variable globale dans le Subprog DEFVAR du traitement nommé sur la fiche. Pour le standard, afin de conserver une homogénéïté, il recommandé de ne pas initialiser la variable dans le dictionnaire sauf pour les variables servant à la déclaration d'une autre variable. L'initialisation sera faite dans l'un des traitements GLOBxxx (xxx=module).

Permet de définir une valeur par le biais d'une expression calculée pouvant contenir des constantes et des variables.
Traitement d'init (champ TRTINI)

Génération

Script (champ TRTSTD)

Traitement dans lequel va être déclarée la variable. Doit avoir été créé dans le dictionnaire des traitements. Doit se nommer WWAGLOBxxx.

Pour le standard, on se limite à la liste disponible, bien que l'on puisse affecter de nouveaux traitements. Dans le produit X3, le traitement est à appeler depuis le traitement GLOBX3.

Pour le spécifique, il est conseillé, d'avoir ces propres traitements générés, qui adopteront la norme de nommage WWAGLOBxxx, ou xxx commencera par X, Y ou Z. Ce traitement devra être appelé par le point d'entrée OUVRE du traitement superviseur GLOBSUP.

Il existe deux traitements réservés aux variables globales associées à un paramètre :

  • WWAGLOBUSR : pour les paramètres de niveau utilisateur
  • WWAGLOBVAR : pour tout autre paramètre
champ TRTINTIT
Rang (champ RANG)

Rang de déclaration et d'initialisation de la variable dans le traitement nommé sur cette fiche. Cette information à surtout de l'importance, lorsqu'une variable sert au dimensionnement ou à l'initialisation d'une seconde variable.

Boutons spécifiques

Les variables globales déclarées par le standard sont protégées. Seuls certains champs sont modifiables.

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.

Permet non seulement de supprimer l'enregistrement dans la table des variables globales, mais aussi

  • de supprimer la documentation associée,
  • de supprimer la déclaration et l'initialisation éventuelle de la variable dans le traitement

Attention, il n'y a aucun cuntrole du superviseur, quant à l'utilisation de cette variable que ce soit dans le traitement courant ou tout autre traitement.

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.