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

XML_DELETE_NODE

Fonction de script : Supprime un élément XML spécifique.

Syntaxe

XML_DELETE_NODE(Element)

Elément de syntaxe

Description / format

Elément

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


 

Code retour

"0" – L'élément a été supprimé avec succès.

Remarques

L'élément de script supprime un élément spécifique du document XML ouvert (XML_OPEN). Il faut spécifier la référence à l'élément à supprimer.

Si l'élément contient des sous-éléments, ces derniers seront également supprimés.

La modification de l'élément de script n'affecte que la structure XML stockée dans la mémoire. L'onglet Documentation n'est pas affecté.

Exemple

Dans l'exemple suivant, l'onglet Documentation structurée est ouvert sous forme de document XML, le premier élément est capturé, puis supprimé. Un message indiquant si la suppression a réussi s'affiche dans le rapport d'activation.

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

:IF &XMLDOCU# <>
""
:SET &FIRST# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &DELETE# = XML_DELETE_NODE(&FIRST#)

:IF &DELETE# = 0
:P 'First XML element successfully deleted'
:ELSE 
:P ]><span class="scriptstring">'An error occurred while deleting the XML element'</span><br />:<span class="scriptstatement">ENDIF</span></span><span class="script"><br /></span><span class="script"><br />:<span class="scriptstatement">ENDIF </span></span><br /> <br /><span class="script">:<span class="scriptstatement">XML_CLOSE </span><![CDATA[ &XMLDOCU#

 

Rubriques connexes :

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