Skip to main content
Skip table of contents

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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.