version 2004.2 (Modifiée)
DOM Lire premier element XML enfant (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 de l'élément XML enfant | |
valeurElémentEnf | Chaîne | Valeur de l'élément XML enfant | |
Résultat | Chaîne | Référence de l'élément XML enfant (16 caractères) |
Description
La commande DOM Lire premier element XML enfant 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:=DOM Analyser variable XML(maVarBlob) $ref_XML_Enfant:=DOM Lire premier element XML enfant($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:=DOM Analyser variable XML(maVarBlob) $ref_XML_Enfant:=DOM Lire premier element XML enfant($ref_XML_Parent;$enfantNom;$enfantValeur)
Référence
DOM Lire element XML frere suivant.
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.