REC-PRO : Recherche propriété
BUT
Cette fonction permet d’accéder directement à une propriété d’un pointeur hors contexte nomenclature de pointeurs. Elle renvoie sous forme de liste, les valeurs de la propriété demandée.
Cette fonction est disponible dans tous les types de requêtes.
SYNTAXE
Cas : Ligne de commande :
VLO.Resultat_Fonction = REC-PRO ( ENTITE=LIG.CDE,
NUM.CDE= Référence Commande,
NUMLIG = Référence Ligne,
REF-POINTEUR = Référence Pointeur,
DOMAINE= Référence Domaine,
GROUPE = Référence Groupe,
PROPRIETE= Référence Propriété,
SEPARATEUR= Séparateur de valeur,
S : TYPE = VLO.Type,
S :NBRE= VLO.Nbr,
S: VALEUR = VLO.Val)
Cas Article :
VLO.Resultat_Fonction = REC-PRO ( ENTITE=ARTICLE,
REFERENCE= Référence Article,
REF-POINTEUR = Référence Pointeur,
DOMAINE= Référence Domaine,
GROUPE = Référence Groupe,
PROPRIETE= Référence Propriété,
SEPARATEUR= Séparateur de valeur,
S : TYPE = VLO.Type,
S :NBRE= VLO.Nbr,
S: VALEUR = VLO.Val)
PARAMETRES
Paramètre | E/S | O | Type | Description |
ENTITE | E | Oui | Caractère | Indique l’entité à laquelle est rattachée la nomenclature de définition parcourue. Les valeurs possibles sont : ARTICLE : correspond à l’entité article standard. LIG.CDE : correspond à l’entité ligne de commande (commerciale ou besoin de gestion). |
NUM.CDE | E | Oui | Caractère | Numéro de commande correspondant à la nomenclature de définition à parcourir. Peut être donné sous la forme d’une constante ou d’une variable (variable locale ou contextuelle à la requête). A renseigner si entité ligne de commande. |
NUM.LIG | E | Oui | Caractère | Numéro de ligne de commande commerciale ou numéro de ligne de besoin de gestion correspondant à la nomenclature de définition à parcourir. Peut être donné sous la forme d’une constante ou d’une variable (variable locale ou contextuelle à la requête). A renseigner si entité ligne de commande. |
REFERENCE | E | Oui | Caractère | Référence article standard pour lequel la nomenclature de définition doit être parcourue. Peut être donné sous la forme d’une constante ou d’une variable (variable locale ou contextuelle à la requête). A renseigner si entité article standard. |
REF-POINTEUR | E | Oui | Caractère | Référence du pointeur concerné. Peut être donné sous la forme d’une constante ou d’une variable (variable locale ou contextuelle à la requête) |
DOMAINE | E | Oui | Caractère | Référence du domaine pour lequel on recherche les propriétés. Peut être donné sous la forme d’une constante ou d’une variable (variable locale ou contextuelle à la requête) |
GROUPE | E | Oui | Caractère | Référence du groupe lié au domaine ci-dessus, pour lequel on recherche les propriétés. Peut être donné sous la forme d’une constante ou d’une variable (variable locale ou contextuelle à la requête) |
PROPRIETE | E | Oui | Caractère | Référence de la propriété à récupérer. Peut être donné sous la forme d’une constante ou d’une variable (variable locale ou contextuelle à la requête). Doit être donné de la forme : VPR.référence propriété. |
SEPARATEUR | E | Oui | Caractère | Séparateur à utiliser dans la liste des valeurs en retour. Peut être donné sous la forme d’une constante ou d’une variable (variable locale ou contextuelle à la requête) |
S :TYPE | S | Oui | Caractère | Type de la propriété demandée |
S :NBRE | S | Oui | Numérique | Nombre d’occurrences de la propriété demandée |
S :VALEUR | S | Oui | Caractère | Liste des valeurs prises par la propriété demandée, séparées par le séparateur donné dans le paramètre SEPARATEUR ci-dessus. |
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
Cette fonction permet de rechercher tous les code programmes liés à une commande.
VLO.v1 = REC-PRO ( ENTITE= LIG.CDE , NUM.CDE= CLO."1510000018" , LIG.CDE= CLO."001" , REF-POINTEUR= CLO."0000500006" , DOMAINE= CLO."USI-O" , GROUPE= CLO."DUBUS-A" , PROPRIETE= CLO."VPR.CodProg" , SEPARATEUR= CLO."@" , S:TYPE= VLO.type , S:NBRE= VLO.VN , S:VALEUR= VLO.val )
La fonction renvoie :
Variable | Valeur |
Type | C |
Nbr | 6 |
Val | Vit015/mou27/quicim/quibeq70/quibal/ser005 |
NOTES
La variable retour est vide si l’exécution de la fonction s’est correctement déroulée ; sinon, elle contient le code erreur DIAPASON et le libellé associé à l’erreur.