LPO-PROPRIETE
BUT
Cette fonction permet d'initialiser et de gérer le contexte d'exécution de la requête en maintenant les variables partagées objet (VPO).
Cette fonction peut être utilisée dans les requêtes de type GCQ, PSD, RCT, REB, RN5.
TYPE
Caractère (rubrique fonction gestion).
SYNTAXE
Variable = LPO-PROPRIETE(CONTEXTE = Référence_Contexte
, ACTION=Action
, TYPE-VARIABLE=VPO
, NOM-VARIABLE=Variable
, E-S :VALEUR= Valeur)
PARAMETRES
Paramètre | E/S | O | Type | Description |
CONTEXTE | E-S | Oui | Caractère | Paramètre donné sous forme de variable locale ou variable contextuelle contenant référence de la liste partagée objet à utiliser dans la requête et qui a été auparavant défini avec la fonction LPO-CONTEXTE et l'option CREATION-CONTEXTE dans cette requête ou une autre requête. |
ACTION | E | Oui | Paramètre | Ce paramètre permet d'indiquer l'action effectuée à par la fonction; les actions possibles sont : REC-MODELE: retourne dans le paramètre VALEUR le modèle LPO d'une liste partagée objet dont la référence est donnée dans le paramètre CONTEXTE REC-VALEUR : indique dans le paramètre VALEUR la valeur d'une variable partagée objet VPO au sein de la liste partagée objet dont la référence est donnée dans le paramètre CONTEXTE MAJ-VALEUR : met à jour avec le paramètre VALEUR la valeur d'une variable partagée objet VPO au sein de la liste partagée objet dont la référence est donnée dans le paramètre CONTEXTE |
TYPE-VARIABLE | E | Oui | Paramètre | Ce paramètre indique le type de variable traité (VPO) |
NOM-VARIABLE | E | Oui | Caractère | Paramètre donné sous forme de variable locale ou constante locale ou référence donnée VPO indiquant la variable VPO à traiter par la fonction |
E-S :VALEUR | E-S | Oui | Caractère | Paramètre donné sous forme de variable locale ou variable contextuelle. - Pour l'action REC-MODELE, la fonction retourne dans cette variable le modèle de la LPO rattaché à la liste partagée objet dont la référence est définie dans le paramètre CONTEXTE - Pour l'action REC-VALEUR, la fonction retourne dans cette variable la valeur de la variable VPO donnée dans paramètre NOM-VARIABLE rattaché à la liste partagée objet dont la référence est définie dans le paramètre CONTEXTE - Pour l'action MAJ-VALEUR, la fonction met à jour la valeur donnée dans ce paramètre la variable VPO donnée dans paramètre NOM-VARIABLE rattaché à la liste partagée objet dont la référence est définie dans le paramètre CONTEXTE |
EXEMPLE
L'instruction ci-dessous permet d'initialiser la variable VPO.Fam_Client dans le contexte de la liste partagée objet VCR.Reference_LPO avec la valeur contenue dans la variable VLO.Valeur_Famille :
VLO. Fonction = LPO-PROPRIETE( CONTEXTE= VCR.Reference_LPO, ACTION= MAJ-VALEUR , TYPE-VARIABLE= VPO , NOM-VARIABLE= Fam_Client, E-S:VALEUR= VLO.Valeur_Famille )
L'instruction ci-dessous permet de récupérer la valeur de la variable VPO.Fam_Client du contexte de la liste partagée objet VCR.Reference_LPO dans la variable locale VLO. Fam_Client :
VLO. Fonction = LPO-PROPRIETE( CONTEXTE= VCR.Reference_LPO, ACTION= REC-VALEUR , TYPE-VARIABLE= VPO , NOM-VARIABLE= Fam_Client, E-S:VALEUR= VLO.Fam_Client)
L'instruction suivante permet de récupérer dans la variable locale VLO.Modele, la référence modèle de liste partagée objet correspondant à la liste dont la référence est VCR.Reference_LPO.
VLO. Fonction = LPO-PROPRIETE( CONTEXTE= VCR.Reference_LPO, ACTION= REC-MODELE, E-S:VALEUR= VLO.Modele)
NOTES
La fonction retourne dans la variable résultat une valeur non nulle ou non vide lors de toute anomalie d’exécution.
Cette instruction est liée à l'utilisation de la fonction LPO-METHODE : elle permet d'initialiser un contexte de variables (type VPO) avant d'exécuter la méthode (règle REB) définie sur le modèle de la liste LPO correspondante.