INT-CTX
BUT Cette fonction permet de récupérer le contexte (type, valeur) des variables d’une interface utilisateur (exemple : disposer des variables d’un formulaire en cours de saisie ou visualisation).
Cette fonction est disponible uniquement pour les requêtes de type RCT.
TYPE CARACTERE (rubrique fonction gestion ; libellé : Recherche dans Contexte Interface).
SYNTAXE
Variable = INT-CTX ( ACTION = REC-TYPE,REC-VALEUR,
TYPE-VARIABLE = Type DIAPASON de variable contextuelle
NOM-VARIABLE = Référence de la variable
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 rechercher 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. |
TYPE-VARIABLE | E | Oui | Caractère | Type DIAPASON de variable. Peut être donné sous la forme d’une variable (variable locale ou contextuelle à la requête) ou sous la forme d’un type donné (PSD, VBA, STO, ou variables standard ou spécifiques entité) |
NOM-VARIABLE | E | Oui | Caractère | Nom de la variable dans le dictionnaire des variables DIAPASON. Peut être donné sous la forme d’une variable (variable locale ou contextuelle à la requête) |
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 = INT-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 (notamment lorsque la variable n’a pas été trouvée) et la valeur vide pour toute exécution correcte.
La fonction retourne dans la variable résultat la valeur *NEX si la fonction ne peut être exécutée (cas de l’utilisation de la fonction dans une requête RCT dont le contexte d’exécution ne dispose pas d’une interface de type fiche en cours de saisie ou visualisation).