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

XML_APPEND_ELEMENT

Fonction de script : Joint un élément XML existant à un autre élément.

Syntaxe

XML_APPEND_ELEMENT (Reference element, element)

Elément de syntaxe

Description / format

Élément de référence

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

Elément

Référence à l'élément devant lequel l'autre élément doit être inséré.
Format : littéral de script ou variable de script


 

Code retour

Référence à l'élément joint

Remarques

La fonction de script joint un élément du document XML ouvert (voir élément de script XML_OPEN) à un autre élément, sous forme de sous-élément. Cela déplace l'élément.

La structure XML n'est modifiée que dans la mémoire. L'onglet Documentation n'est pas affecté par l'élément de script.

Exemple

Dans l'exemple suivant, l'onglet Documentation structurée est ouvert sous forme de document XML. De plus, l'élément "SubChild3", qui se trouve dans "Child2" est ensuite joint au premier élément de la structure XML (Child1).

Tous les sous-éléments se trouvant dans "Child1" seront ensuite consignés dans le rapport d'activation.

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

:IF &XMLDOCU# <> ""
:SET &FIRST# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &TOAPPEND# = XML_SELECT_NODE(&XMLDOCU#,"Child2/SubChild3")

:SET &CLONECHILD# = XML_APPEND_ELEMENT(&FIRST#,&TOAPPEND#)

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

:ENDIF
 

 
:XML_CLOSE &XMLDOCU#

Résultat dans le rapport d'activation :

2013-08-14 13:32:27 – U0020408 Element: SubChild1
2013-08-14 13:32:27 – U0020408 Element: SubChild2
2013-08-14 13:32:27 – U0020408 Element: SubChild3

 

Rubriques connexes :

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

 

Élément de script – Lecture ou modification d'objets

Documentation structurée

www.w3c.org/TR/xmlbase

Exemples
Détermination du message et du numéro de l'erreur

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle