XML-LECMESFIC
BUT
Cette fonction permet de lire un fichier ascii contenant un message XML et d’initialiser la liste standard WfEIAXmlMes, contenu du message structuré sous forme de liste et accessible avec les instructions de manipulation DIALOG.
TYPE
CARACTERE
SYNTAXE
Variable = XML-LECMESFIC (REF-MESSAGE-XML = référence message XML,
NOM-FICHIER= nom absolu du fichier ascii XML,
BALISE-DEPART = balise départ du message
)
PARAMETRES
Paramètre | E/S | O | Type | Description |
REF-MESSAGE-XML | E | Oui | Caractère | Référence Message XML mémorisé dans la structure WfEIAXmlMes : cette structure contient le contenu du message XML dans un format lisible par DIAPASON. L’initialisation permet de renseigner ou non une référence de message (utile uniquement dans le cas où il faut lire et manipuler simultanément plusieurs messages). La valeur peut être MESSAGE-COURANT (cas où un seul message a été initialisé : la référence message sera alors vide (CLO. ‘’)) ou bien peut être définie par une variable locale, une constante (locale ou globale) ou une variable contextuelle. |
NOM-FICHIER | E | Oui | Caractère | Nom du fichier ascii (avec adresse ou répertoire complet) contenant le message XML à lire. La valeur peut être définie par une variable locale, une constante (locale ou globale) ou une variable contextuelle. |
BALISE-DEPART | S | Oui | Caractère | Valeur de la balise de départ (de plus haut niveau) du message XML. La valeur est retournée dans une variable locale. |
Suite à son exécution, cette fonction retourne une valeur sous forme de variable pour préciser si le déroulement a été correct ou non : la variable retournée est vide si la fonction s’est déroulée correctement, sinon la variable contient *ERR suivie d’un code et libellée d’erreur ou *INC si l’exécution n’a pas pu être réalisée correctement.
EXEMPLE
VLO.Fonction = XML-LECMESFIC( REF-MESSAGE-XML= MESSAGE-COURANT , NOM-FICHIER= VCR.NomFichierXMLALire, BALISE-DEPART= VLO.Balise)
Cette instruction permet de lire le fichier ascii défini dans la variable locale VCR.NomFichierXMLALire et d’initialiser la liste WfEIAXmlMes avec la référence message (ou identfiant) à vide (CLO.’’).
NOTES
La structure de la liste WfEIAXmlMes est la suivante :
Champ | Désignation |
MesIde | Référence Message (à vide si valeur MESSAGE-COURANT) |
XmlPId | Identifiant Balise Père : compteur interne généré par la fonction |
XmlIde | Identifiant Balise Courante : compteur interne généré par la fonction (dans l’ordre de la lecture de l’arborescence du message) |
XmlNiv | Niveau Courant dans l’arborescence du message |
XmlNOr | Numéro Ordre du lien par rapport au Niveau Courant |
XmlTBa | Type : L(ien), V(aleur), A(ttribut) |
XmlBal | Nom de la Balise XML |
XmlVal | Valeur Rattachée a Balise XML |