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

XML_CLONE_AND_RENAME

Fonction de script : Duplique et renomme un élément XML.

Syntaxe

XML_CLONE_AND_RENAME(Element, Name)

Elément de syntaxe

Description / format

Elément

Référence à l'élément à dupliquer.
Format : littéral de script ou variable de script

Nom

Nouveau nom de l'élément dupliqué
Format : littéral de script ou variable de script


Code retour

Référence au nouvel élément dupliqué.

Remarques

L'élément de script duplique un élément du document XML ouvert (voir élément de script XML_OPEN) et le renomme. L'élément dupliqué doit être ajouté à un élément via la fonction de script XML_APPEND_ELEMENT 

XML_CLONE_AND_RENAME duplique l'élément, mais ne l'ajoute à aucun élément. Utilisez XML_APPEND_ELEMENT pour ajouter l'élément dupliqué en tant que sous-élément d'un autre é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 affecté.

Notez que les espaces ne sont pas autorisés dans le nom de l'élément et provoquent une erreur d'exécution.

Exemple

L'exemple qui suit montre l'onglet Documentation structurée ouvert et l'élément "SubChild3" se trouvant dans l'élément parent "Child2" est dupliqué avec le nom "New_Element". Les sous-éléments de "Child2" s'afficheront ensuite dans le rapport d'activation.

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

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

:SET &CLONECHILD# = XML_CLONE_AND_RENAME(&TOCLONE#,"New_Element")

:SET &PARENT# = XML_SELECT_NODE(&XMLDocu#, "Child3")
:SET &RET# = XML_APPEND_ELEMENT(&PARENT#, &CLONECHILD#)

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

:ENDIF

:XML_CLOSE &XMLDOCU#

Les lignes suivantes sont alors disponibles dans le rapport d'activation :

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

 

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