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

XML_APPEND_CLONE

Fonction de script : Duplique un élément XML et le joint à un autre élément.

Syntaxe

XML_APPEND_CLONE(élément de référence, élément)

Élément de syntaxe

Description/format

Élément de référence

Référence à l'élément auquel l'élément dupliqué doit être joint.
Format : Littéral de script ou Variable de script

Elément

Se réfère à l'élément dupliqué
Format : littéral de script ou variable de script


Code retour

Référence à l'élément dupliqué.

Remarques

L'élément de script XML_APPEND_CLONE copie un élément du document XML ouvert (voir élément de script XML_OPEN) et l'ajoute à un autre élément sous forme de sous-élément. Le sous-élément est toujours ajouté au dernier élément.

La duplication prend en compte toutes les valeurs et éléments subordonnés.

L'élément de script ne fait que copier la structure XML enregistrée dans la mémoire. L'onglet Documentation n'est pas modifié.

Exemple

Dans l'exemple suivant, l'onglet Documentation structurée est ouvert sous forme de document XML. L'élément "SubChild3" est ensuite copié et ajouté à "Child3" en tant que sous-élément. Tous les sous-éléments de "Child3" s'affichent dans le rapport d'activation à des fins de vérification.

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

:IF &XMLDOCU# <> ""
:SET &ELEMENT# = XML_SELECT_NODE(&XMLDOCU#,"Child2/SubChild3")
:SET &CHILD# = XML_SELECT_NODE(&XMLDOCU#,"Child3")

:SET &CLONECHILD# = XML_APPEND_CLONE(&CHILD#,&ELEMENT#)

: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#

Résultat dans le rapport d'activation :

2013-08-14 14:19:17 – U0020408 Element: SubChild4
2013-08-14 14:19:17 – 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
Éléments de script - Liste alphabétique
Éléments de script - Division fonctionnelle