XML_SET_ATTRIBUTE

Fonction de script : Ajoute un nouvel attribut à un élément XML ou modifie un attribut existant.

Syntaxe

XML_SET_ATTRIBUTE (Element, Attribute, Value)

Elément de syntaxe	Description / format
Elément	Référence de l'élément dont l'attribut doit être modifié ou auquel le nouvel attribut doit être ajouté. Format : littéral de script ou variable de script
Attribute	Nom de l'attribut précédé par le caractère "@" Format : littéral de script ou variable de script
Value	Valeur de l'attribut Format : littéral de script ou variable de script

Code retour
"0" : l'attibut a été modifié / ajouté avec succès.

Remarques :

L'élément de script modifie l'attribut d'un élément du document XML ouvert (XML_OPEN). Vous devez spécifier une référence de l'élément, ainsi que le nom et la valeur de l'attribut. Si l'attribut saisi n'est pas placé, il sera ajouté une nouvelle fois à l'élément.

Notez que seul l'élément enregistré en mémoire sera modifié. L'onglet Documentation n'est pas affecté.

Une erreur d'exécution se produira si le caractère "@" ne précède pas le nom de l'attribut.

Exemple

L'exemple suivant illustre l'ouverture de l'onglet Documentation structurée sous la forme d'un document XML et sélectionne l'élément "Child". Le nouvel attribut "Attribute1" est ensuite ajouté à l'élément. S'il est ajouté avec succès, l'attribut défini est alors lu une fois de plus pour vérification et la valeur est écrite dans le rapport d'activation.

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

:IF &XMLDOCU# <> ""
:SET &ELEMENT# = XML_SELECT_NODE(&XMLDOCU#,"Child")

:SET &RET# = XML_SET_ATTRIBUTE(&ELEMENT#,"@Attribute1","Value1")
:IF &RET# = 0
:SET &ATT# = XML_GET_ATTRIBUTE(&ELEMENT#,"@Attribute1")
:P &ATT#
:ENDIF

:ENDIF