LEC-IT
BUT
Cette fonction permet d’initialiser un contexte (la structure liste WfITIni) qui contient l’ensemble des informations techniques d’un pointeur donné.
Cette fonction est disponible dans les requêtes de type RN5.
TYPE
CARACTERE
SYNTAXE
Variable_Résultat = LEC-IT( POINTEUR= Référence_Pointeur)
PARAMETRES
Paramètre | E/S | O | Type | Description |
Pointeur | E | Oui | Caractère | Référence pointeur pour lequel les informations techniques sont recherchées. Cette référence doit contenir la valeur de l’identifiant du pointeur connu lors de la génération de celui-ci dans la variable contextuelle SCR.NomPtrGen. Cette référence peut être donnée par une variable locale, une constante globale, une constante locale ou bien la valeur d’une variable contextuelle. |
Cette fonction retourne dans la variable résultat le retour de l’exécution de la fonction (vide : exécution OK, non vide : problème).
EXEMPLE
Initialisation liste des informations du pointeur identifié dans la variable VBP.PointeurIT :
VLO.Resultat = LEC-IT( POINTEUR=VBP.PointeurIT)
NOTES
Si le pointeur a été trouvé et des informations techniques existent, la liste WfITIni est initialisée avec les éléments suivants (tous alphanumériques, sauf di---nor, de type entier):
ge-ref-ptr : Référence Pointeur
di-t-nor : Numéro d'Ordre de rangement de l'Information Technique
di-t-type : Type Information Technique
di-t-sstype : Sous-Type Information Technique
di-t-code : Code Information Technique
di-t-valeur : Valeur Information Technique
Le comportement de la liste est le suivant :
à chaque exécution d’une RN5 sur un pointeur, cette liste est vidée.
cette liste est accessible uniquement en lecture dans la RN5.
il y a un enregistrement par pointeur et détail d'information technique; on peut donc récupérer des informations techniques de plusieurs pointeurs.
il y a deux indexs : ParCleIdx (ge-ref-ptr , di-t-type , di-t-sstype , di-t-code) et ParOrdIdx (ge-ref-ptr , di-t-nor).
Le pointeur doit avoir été auparavant généré ; si la référence pointeur donnée ne correspond pas à un pointeur généré, la fonction retourne en résultat la valeur *INC.
La liste peut être vide si aucune information technique existe sur le pointeur donné.