Manuel des Scripts Automation Engine > Organisation fonctionnelle > Lecture ou modification d'objets > XML_APPEND_CHILD

XML_APPEND_CHILD

Fonction de script : Ajoute un nouveau sous-élément à un élément XML.

Syntaxe

XML_APPEND_CHILD(Element, Name, Value)

Elément de syntaxe

Description / format

Elément

Référence à l'élément auquel un nouveau sous-élément doit être ajouté.
Format : littéral de script ou variable de script

Nom

Nom du nouveau sous-élément
Format : littéral de script ou variable de script

Valeur Valeur du nouveau sous-élément
Format : littéral de script ou variable de script


 

Code retour

Référence au nouveau sous-élément inséré

Remarques

L'élément de script insère un nouveau sous-élément avant un élément spécifique du document XML ouvert (voir élément de script XML_OPEN). Il faut spécifier une référence à l'élément auquel le sous-élément est alloué, ainsi que le nom / la valeur du sous-élément. Le sous-élément est toujours ajouté à la fin.

Notez que la structure XML ne sera modifiée que dans la mémoire. L'élément de script n'a aucun effet sur l'onglet Documentation.

Il ne doit y avoir aucun espace dans le nom du nouveau sous-élément !

Exemple

Dans l'exemple suivant, l'onglet Documentation est ouvert sous forme de document XML avec l'élément "Child3" dans le nouveau sous-élément "New_Child". Tous les sous-éléments se trouvant dans "Child3" seront consignés ensuite dans le rapport d'activation.

:SET &XMLDOCU#=XML_OPEN(DOCU,,"@Details")

:IF &XMLDOCU# <> ""
:SET &CHILD# = XML_SELECT_NODE(&XMLDOCU#,"Child3")
:SET &NEWCHILD# = XML_APPEND_CHILD(&CHILD#,"New_Child","Test")

:SET &ELEMENT# = XML_GET_FIRST_CHILD(&CHILD#)
:WHILE &ELEMENT# <> ""
: SET &NAME# = XML_GET_NODE_NAME(&ELEMENT#)
: P "Element : &NAME#"
: SET &ELEMENT# = XML_GET_NEXTSIBLING(&ELEMENT#)
:ENDWHILE

:ENDIF
 

 
:XML_CLOSE &XMLDOCU#

Cela signifie les lignes suivantes sont consignées dans le rapport :

2013-08-14 13:32:27 – U0020408 Element: SubChild4
2013-08-14 13:32:27 – U0020408 Element: New_Child

 

 

Rubriques connexes :

Elément de script Description
XML_OPEN Ouvre un document XML en vue du traitement
:XML_CLOSE Ferme un document XML