PA-NOMDEF-PRO
BUT
Cette instruction permet de déclencher le parcours récursif partiel d’une nomenclature de définition (nomenclature de pointeur). Seulement sur les pointeurs sur lesquels sont calculées des propriétés pour un domaine et un groupe donnés, sont considérés. Chaque itération déclenchée par cette instruction permet de se positionner sur un pointeur et d’accéder à toute variable contextuelle du pointeur (par la fonction LEC-NOMDEF) et de parcourir :
les informations techniques du pointeur (par l’instruction PA-IT-NOMDEF)
les propriétés du pointeur (par l’instruction PA-PR-NOMDEF)
Cette fonction est disponible uniquement dans les requêtes de type REB.
SYNTAXE
PARCOURS NOMENCLATURE DEFINITION/DOMAINE
DOMAINE= Référence Domaine,
GROUPE= Référence Groupe ou TOUS,
ENTITE = ARTICLE / LIGNE DE COMMANDE,
ARTICLE = Référence Article,
Ou NUM.CDE=Num.Cde , LIG.CDE= Lig.Cde,
ERREUR = Erreur
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 | 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. |
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. |
LIG.CDE | 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. |
DOMAINE | E | Oui | Caractère | Référence du domaine permettant de filtrer les pointeurs à parcourir pointeurs pour lesquels il existe des propriétés calculées pour ce domaine. |
GROUPE | E | Oui | Caractère | Référence du groupe permettant de filtrer les pointeurs à parcourir pointeurs pour lesquels il existe des propriétés calculées pour ce domaine et ce groupe. |
ERREUR | E | Oui | Caractère | Nom de la variable locale qui va contenir l’erreur éventuelle lors du parcours de la nomenclature de définition (exemple : il n’existe pas de nomenclature de définition). |
EXEMPLE
Parcours de la nomenclature de pointeurs de la ligne de commande 0001000010/04 pour le domaine DOMNAD_VA0 et tous les groupes liés à ce domaine.
PARCOURS NOMENCLATURE DEFINITION / DOMAINE ENTITE= LIG.CDE , NUM.CDE= CLO."0001000010" , LIG.CDE= CLO."04" , DOMAINE= CLO."DOMNAD_VA0" , GROUPE= TOUS , ERREUR= VLO.erreur :
/* Parcours des propriétés du pointeur courant */
PARCOURS PROP. NOMENCLATURE DEFINITION DOMAINE= CLO."DOMNAD_VA0" , GROUPE= TOUS , ERREUR= VLO.erreur :
SI VLO.erreur = CGL.VIDE
VLO.erreur = LEC-NOMDEF( ACTION= REC-VALEUR , TYPE-VARIABLE=VBA , NOM-VARIABLE= di_prop_dom , S:VALEUR= VLO.domaine )
VLO.erreur = LEC-NOMDEF( ACTION= REC-VALEUR , TYPE-VARIABLE=VBA , NOM-VARIABLE= di_prop_grp , S:VALEUR= VLO.groupe )
VLO.erreur = LEC-NOMDEF( ACTION= REC-VALEUR , TYPE-VARIABLE=VBA , NOM-VARIABLE= di_prop_ref , S:VALEUR= VLO.reference )
VLO.erreur = LEC-NOMDEF( ACTION= REC-VALEUR , TYPE-VARIABLE=VBA , NOM-VARIABLE= di_prop_val , S:VALEUR= VLO.val )
VLO.erreur = LEC-NOMDEF( ACTION= REC-VALEUR , TYPE-VARIABLE=VBA , NOM-VARIABLE= di_prop_ord , S:VALEUR= VLO.ord )
VLO.erreur = LEC-NOMDEF( ACTION= REC-VALEUR , TYPE-VARIABLE=VBA , NOM-VARIABLE= di_prop_arb , S:VALEUR= VLO.arbo )
FIN_BLOC
FIN_BLOC
FIN_BLOC
NOTES
La variable locale correspondant à l’erreur va contenir un code erreur si le parcours ne peut être exécuté (cas ou l’article ou la ligne de commande ou de besoin de gestion donnés sont incohérents) ou bien si la nomenclature de définition n’est pas définie pour l’entité donnée. Les valeurs possibles sont :
*ERR:CTX-NON-POS : contexte non positionné
*ERR:PAR-NOM-ENC' : parcours déjà en cours
*ERR:NOM-NON-DEF-DOM' : pas de pointeur pour ce domaine
*ERR:PTR-INC' : pointeur inconnu
*ERR:NOM-INC' : nomenclature inconnue
*ERR:ART-INC' : article inconnu
*ERRENT-INC' : entité inconnue
*ERR:PROP-INC' : propriété inconnue
Cette instruction permet de parcourir partiellement une nomenclature de pointeur sous forme itérative : le premier pointeur correspond au pointeur de niveau 0, puis le parcours est effectué dans l’ordre récursif de la nomenclature.
Pour l’entité article standard, seules les nomenclatures majeures (type nomenclature = 0) sont parcourues.
Cette instruction permet d’utiliser la fonction LEC-NOMDEF pour accéder à toute variable contextuelle du pointeur courant.
Cette instruction permet d’utiliser :
l’instruction PA-IT-NOMDEF pour parcourir les informations techniques du pointeur courant
l’instruction PA-PR-NOMDEF pour parcourir les propriétés du pointeur courant