Fonction de script : Ajoute un nouveau sous-élément à un élément XML.
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é. |
Nom |
Nom du nouveau sous-élément |
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é |
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 !
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 |
Élément de script – Lecture ou modification d'objets
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