Variables globales
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
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.
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 :
Cette variable appartient à la classe [V]. |
|
|
Caractéristiques
| Un code activité vous permet de :
Si le code activité est désactivé :
|
| 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. |
| 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
| 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. |
| Champ affiché avec la valeur issue du 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. |
Formules de dimensionnement
| 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. |
|
|
|
|
|
|
Initialisation
| 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 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. |
|
|
Génération
| 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 :
|
|
|
| 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 champs suivants sont présents dans la fenêtre ouverte par ce bouton : Bloc numéro 1
Bloc numéro 2
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
Bloc numéro 2
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
Bloc numéro 2
Permet non seulement de supprimer l'enregistrement dans la table des variables globales, mais aussi
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
Bloc numéro 2
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.