DOM Append XML child node

DOM Append XML child node ( refElément ; typeEnfant ; valeurEnfant ) : Text

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

Description

La commande DOM Append XML child node 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 comment	Entier long	2
XML DATA	Entier long	6
XML DOCTYPE	Entier long	10
XML ELEMENT	Entier long	11
XML processing instruction	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 Create XML element(refElement;"monElement")
 DOM SET XML ELEMENT VALUE(Reference ;"Bonjour")
 temp:=DOM Create XML element(Reference ;"br")
 temp:=DOM Append XML child node(Reference;XML DATA;"La")
 temp:=DOM Create XML element(Reference;"br")
 temp:=DOM Append XML child node(Reference;XML DATA;"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 Append XML child node(refElement;XML Processing Instruction;$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 Append XML child node(refElement;XML Comment;"Hello world")

Résultat :

<!--Hello world-->

Exemple 4

Ajout d’un noeud de type CDATA :

 Reference:=DOM Append XML child node(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 Append XML child node(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 Append XML child node(refElement;XML ELEMENT;"simoneva")  

Résultat :

<parent>  
    <child>simon</child>  
    <child>eva</child>  
</parent>  

• sinon, un nouvel élément enfant vide est ajouté :

 Reference:=DOM Append XML child node(refElement;XML ELEMENT;"tbreak")  

Résultat :

<parent>  
     <tbreak/>  
 </parent>  

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

Voir aussi

DOM GET XML CHILD NODES
DOM Get XML document ref

Propriétés

Numéro de commande	1080
Thread safe	✓