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

    Présentation

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

    Fermer

     

    Champs

    Les champs suivants sont présents dans cet onglet :

    Bloc numéro 1

    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)

    Destiné à figurer sur les états et les écrans dans lesquels le code de la fiche peut être saisi ou sélectionné. Ce texte permet de donner une description de la fiche concernée.

    Caractéristiques

    Un code activité permet :

    • de rendre optionnel un élément du dictionnaire si la valeur associée au code activité est nulle.
    • de signer les éléments spécifiques dès lors qu'ils sont marqués par un code commençant par X, Y ou Z.
    • de dimensionner un nombre de lignes maximum lorsque le code activité marque des éléments d'un tableau.

    Ainsi, si le code activité est non actif, l'élément marqué ne sera pas utilisable, et le code associé (s'il y en a) ne sera pas généré ni activable.

    • Module (champ MODULE)

    Module d'appartenance du paramétrage. Ce champ 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

    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.

    Fermer

     

    Boutons spécifiques

    Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

    Bloc numéro 1

    • champ OBJET

     

    • champ CLES

     

    Bloc numéro 2

    • Depuis le dossier (champ DOSORG)

    Ce champ permet de définir 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)

    Ce champ permet de définir le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

    Fermer

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

    Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

    Bloc numéro 1

    • champ OBJET

     

    • champ CLES

     

    Bloc numéro 2

    • Depuis le dossier (champ DOSORG)

    Ce champ permet de définir 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)

    Ce champ permet de définir le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

    Fermer

    Permet non seulement de créer l'enregistrement dans la table des variables globales, mais aussi de générer la documentation ( paragraphe PRE), si du texte est saisi.

    Permet de créer les lignes de déclaration de la variable dans le traitement lié.

    Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

    Bloc numéro 1

    • champ OBJET

     

    • champ CLES

     

    Bloc numéro 2

    • Depuis le dossier (champ DOSORG)

    Ce champ permet de définir 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)

    Ce champ permet de définir le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

    Fermer

    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.

    Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

    Bloc numéro 1

    • champ OBJET

     

    • champ CLES

     

    Bloc numéro 2

    • Depuis le dossier (champ DOSORG)

    Ce champ permet de définir 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)

    Ce champ permet de définir le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.

    Fermer

    Permet de recopier la définition d'une variable globale vers un autre dossier. une validation est ensuite nécessaire pour générer le traitement associé.

    Permet la re-génération de tous les traitements connus de ce dictionnaire des variables globales.

    Barre de menu

    Option / Contexte assistant de formules

    Permet d'aller en tunnel sur la fonction "contexte assistant de formule".

    Documentation / Paragraphes

    Cette fonction permet d'accéder à la gestion de la documentation, sur le premier paragraphe de la documentation (si elle existe) associé à la fiche courante.

    Documentation / Liens

    Cette fonction permet d'accéder à la gestion des liens. Elle permet de définir des liens entre la fiche courante et d'autres fiches (par exemple des liens entre fonctions et paramètres). Ces liens, purement documentaires, permettent d'alimenter la mécanique de génération des squelettes de documentation.

    Documentation / Génération

    Ce menu permet de lancer une génération de documentation. La génération peut se lancer également à partir du bouton [Génération] dans le bas de la fenêtre.

    Trois types de génération peuvent être lancées, séparément ou simultanément :

    • la génération du squelette de documentation à partir du dictionnaire (tables ADOCUMENT, ADOCBLB, ADOCCLB).
    • la génération de la documentation à partir des tables précédentes.
    • la génération de la documentation sur champ.

    Les bornes proposées par défaut tiennent compte de la fiche en cours, mais elles peuvent être modifiées au lancement.

    Messages d'erreur

    Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

    Paramètre inexistant

    Si un paramètre est saisi, il doit existé dans la table de définition des paramètres ADOPAR.

    Ce paramètre est utilisé par la variable globale xxxxxxxxx

    Ce paramètre est déjà associé à une variable globale. Il ne peut en alimenter qu'une seule.

    Type de données incorrect

    Il faut une entière compatibilité entre le type de donnée de la variable et le type du paramètre.

    Valeur incorrecte
    Le code variable doit commencer par G, X, Y, ou Z

    Le nom d'une variable globale doit commencer par G pour le standard et X, Y ou Z pour le spécifique.

    Tables mises en oeuvre

    SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre