Fonction de script : Modifie ou définit la valeur d'un élément XML.
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 |
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. |
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.
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 |
É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