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

XML_SET_NODE_TEXT

Fonction de script : Modifie ou définit la valeur d'un élément XML.

Syntaxe

XML_SET_NODE_TEXT(element, value)

Elément de syntaxe

Description / format

Elément

Référence à l'élément dont vous souhaitez modifier / définir la valeur
Format : littéral de script ou variable de script

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


 

Code retour

"0" – La valeur de l'élément a été définie avec succès.

Remarques

L'élément de script définit la valeur d'un élément spécifié dans le document XML ouvert. Si cet élément possède déjà une valeur, elle sera modifiée. Vous devez spécifier une référence à l'élément, ainsi et la nouvelle valeur.

L'élément est enregistré dans la mémoire via la fonction de script. L'onglet Documentation n'en est pas affecté.

Les sauts de lignes sont autorisés dans la valeur de l'élément. Utilisez l'élément de script UC_CRLF pour insérer des sauts de lignes.

Exemple

Dans l'exemple suivant, l'onglet Documentation structurée est ouvert sous forme de document XML, le premier élément est capturé et sa valeur est consignée dans le rapport d'activation. La valeur de l'élément est ensuite modifiée. Une fois cette action effectuée avec succès, la nouvelle valeur est détectée via un test et également consignée dans le rapport d'activation.

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

:IF &XMLDOCU# <>
""

:SET &ELEMENT# = XML_GET_FIRST_CHILD(&XMLDOCU#)

:SET &VALUE# = XML_GET_NODE_TEXT(&ELEMENT#)
:P "Old Value: &VALUE#"

:SET &RET# = XML_SET_NODE_TEXT(&ELEMENT#,"New Node Text")

:IF &RET# = 0

:SET &VALUE# = XML_GET_NODE_TEXT(&ELEMENT#)
:P "New Value: &VALUE#"

:ENDIF

:ENDIF

:XML_CLOSE &XMLDOCU#

Résultat dans le rapport d'activation :

2013-08-14 13:32:27 – U0020408 Old Value: Old Node Text
2013-08-14 13:32:27 – U0020408 New Value: New Node Text

 

Rubriques connexes :

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