VAR-CTX
BUT
Cette fonction permet de piloter le contexte de certaines variables en identifiant le nom de ces variables sous la forme de variables et en permettant de récupérer le type de la variable, sa valeur ou d’initialiser sa valeur.
Cette fonction est disponible uniquement pour les requêtes de type GCA, GCL, GCQ, PSD, RN1, RN2 et RN5, et ne concerne que certains types de variables DIAPASON qui ne sont pas des tableaux.
TYPE
CARACTERE (rubrique fonction (libellé : Gestion Ctx Variable)).
SYNTAXE
Variable = VAR-CTX ( ACTION = REC-TYPE,REC-VALEUR,MAJ-VALEUR
TYPE-VARIABLE = (Type suivant contexte)
NOM-VARIABLE = Référence de la variable traitée
E-S :VALEUR = valeur liée à l’action de la fonction)
PARAMETRES
Paramètre | E/S | O | Type | Description |
ACTION | E | Oui | Caractère | REC-TYPE : cette action demande à DIAPASON de donner le type (Caractère, Numérique, Date, Logique) de la variable définie dans le paramètre NOM-VARIABLE. Le type est retourné dans la variable du paramètre entrée-sortie VALEUR. REC-VALEUR : cette action demande à DIAPASON de donner la valeur de la variable définie dans le paramètre NOM-VARIABLE. La valeur est retournée dans la variable du paramètre entrée-sortie VALEUR. MAJ-VALEUR : cette action demande à DIAPASON de mettre à jour la valeur de la variable définie dans le paramètre NOM-VARIABLE. La valeur est définie dans la variable du paramètre entrée-sortie VALEUR |
TYPE-VARIABLE | E | Oui | Caractère | Type DIAPASON de variable. Les valeurs possibles sont les suivantes : Requête PSD: les types possibles sont VBP, VCR ou VSD. Requête GCA, GCL, GCQ, RN1, RN2 et RN5: les types possibles sont VBP ou VBA. |
NOM-VARIABLE | E | Oui | Caractère | Nom de la variable du type précédemment sélectionné défini dans le dictionnaire des variables DIAPASON. |
VALEUR | E | Oui | Caractère | Valeur en entrée ou sortie de fonction dépendant du paramètre ACTION. |
EXEMPLE
L’instruction qui suit permet de mémoriser dans la variable locale Valeur la valeur
effective (au format caractère exclusivement) de la variable VBA dont le nom est le contenu de la variable locale Nom :
VLO.Fct = VAR-CTX( ACTION= REC-VALEUR , TYPE-VARIABLE=VBA , NOM-VARIABLE= VLO.Nom , E-S:VALEUR= VLO.Valeur )
NOTES
La fonction retourne dans la variable résultat la valeur *INC lors de toute anomalie d’exécution et la valeur vide pour toute exécution correcte.