4D Doc Center : DOM Ajouter noeud enfant XML

4D v14.3

DOM Ajouter noeud enfant XML


DOM Ajouter noeud enfant XML ( refElément ; typeEnfant ; valeurEnfant ) -> Résultat

Paramètre	Type	Description
refElément	Texte	Référence d’élément XML
typeEnfant	Entier long	Type d’enfant à ajouter
valeurEnfant	Texte, BLOB	Texte ou variable (Texte ou BLOB) dont la valeur doit être insérée en tant que noeud enfant
Résultat	Texte	Référence de l’élément XML enfant

Description

La commande DOM Ajouter noeud enfant XML permet d’ajouter la valeur valeurEnfant au noeud XML désigné par refElément.

Le type de noeud créé est défini par le paramètre typeEnfant. Passez dans ce paramètre l’une des constantes suivantes, placées dans le thème XML :

Constante	Type	Valeur
XML CDATA	Entier long	7
XML commentaire	Entier long	2
XML DOCTYPE	Entier long	10
XML Donnée	Entier long	6
XML Elément	Entier long	11
XML instruction de traitement	Entier long	3

Passez dans valeurEnfant les données à insérer. Vous pouvez passer une chaîne ou une variable 4D (chaîne ou BLOB). Le contenu de ce paramètre sera toujours converti en texte.

Note : Si le paramètre refElément désigne le noeud Document (noeud de plus haut niveau), la commande insère un noeud "Doctype" avant tout autre noeud. Il en va de même pour les instructions de traitement et les commentaires, qui sont toujours insérés avant le noeud racine (mais après le noeud Doctype).

Exemple 1

Ajout d’un noeud de type texte :

 Reference:=DOM Creer element XML(refElement;"monElement")

 DOM ECRIRE VALEUR ELEMENT XML(Reference ;"Bonjour")

 temp:=DOM Creer element XML(Reference ;"br")

 temp:=DOM Ajouter noeud enfant XML(Reference;XML Donnée;"La")

 temp:=DOM Creer element XML(Reference;"br")

 temp:=DOM Ajouter noeud enfant XML(Reference;XML Donnée;"France")

Résultat :

<monElement>Bonjour<br/>La<br/>France</monElement>

Exemple 2

Ajout d’un noeud de type instruction de traitement :

 $Txt_instruction:="xml-stylesheet type = \"text/xsl\" href=\"style.xsl\""

 Reference:=DOM Ajouter noeud enfant XML(refElement;XML instruction de traitement;$Txt_instruction )

Résultat (inséré avant le premier élément) :

<?xml-stylesheet type="text/xsl" href="style.xsl"?>

Exemple 3

Ajout d’un noeud de type commentaire :

Reference:=DOM Ajouter noeud enfant XML(refElement;XML commentaire;"Hello world")

Résultat :

<!--Hello world-->

Exemple 4

Ajout d’un noeud de type CDATA :

Reference:=DOM Ajouter noeud enfant XML(refElement;XML CDATA;"12 < 18")

Résultat :

<element><![CDATA[12 < 18]]></element>

Exemple 5

Ajout ou remplacement d’un noeud de type déclaration Doctype :

Reference:=DOM Ajouter noeud enfant XML(refElement;XML DOCTYPE;"Books SYSTEM \"Book.DTD\"")

Résultat (inséré avant le premier élément) :

<!DOCTYPE Books SYSTEM "Book.DTD">

Exemple 6

Ajout ou remplacement d’un noeud de type Elément.

si le paramètre valeurEnfant est un fragment XML, il est inséré en tant que noeuds enfants :
Reference:=DOM Ajouter noeud enfant XML(refElement;XML Elément;"<child>simon</child><child>eva</child>")

Résultat :
```
<parent>
    <child>simon</child>
    <child>eva</child>
</parent>
```
sinon, un nouvel élément enfant vide est ajouté :
Reference:=DOM Ajouter noeud enfant XML(refElement;XML Elément;"tbreak")

Résultat :
```
<parent>
     <tbreak/>
 </parent>
```

Si le contenu de valeurEnfant est invalide, une erreur est retournée.