version 2003
Lire premier element XML (refElément{; nomElémentEnf{; valeurElémentEnf}}) Chaîne
| Paramètre | Type | Description | |
| refElément | Chaîne | Référence d'élément XML | |
| nomElémentEnf | Chaîne | Nom du champ sélectionné | |
| valeurElémentEnf | Chaîne | Valeur du champ sélectionné | |
| Résultat | Chaîne | Référence de l'élément XML (16 caractères) |
Description
La commande Lire premier element XML retourne une référence XML vers le premier "enfant" de l'élément XML passé en référence dans refElément. Cette référence pourra être utilisée avec les autres commandes d'analyse XML.
Les paramètres nomElémentEnf et valeurElémentEnf, s'ils sont passés, reçoivent respectivement le nom et la valeur de l'élément enfant.
Exemples
(1) Récupération de la référence du premier élément XML du parent racine. La structure XML (C:\\import.xml) est préalablement chargée dans un BLOB :
C_BLOB(maVarBlob)
C_ALPHA(16;$ref_XML_Parent;$ref_XML_Enfant)
DOCUMENT VERS BLOB("c:\\import.xml";maVarBlob)
$ref_XML_Parent:=Analyser variable XML(maVarBlob)
$ref_XML_Enfant:=Lire premier element XML($ref_XML_Parent)
(2) Récupération de la référence, du nom et de la valeur du premier élément XML du parent racine. La structure XML (C:\\import.xml) est préalablement chargée dans un BLOB :
C_BLOB(maVarBlob)
C_ALPHA(16;$ref_XML_Parent;$ref_XML_Enfant)
C_TEXTE($enfantNom;$enfantValeur)
DOCUMENT VERS BLOB("c:\\import.xml";maVarBlob)
$ref_XML_Parent:=Analyser variable XML(maVarBlob)
$ref_XML_Enfant:=Lire premier element XML($ref_XML_Parent;$enfantNom;$enfantValeur)
Référence
Variables et ensembles système
Si la commande a été correctement exécutée, la variable système OK prend la valeur 1. Sinon, elle prend la valeur 0.