|
XML_SELECT_NODE |
Lecture ou modification d'objets |
XML_SET_NODE_TEXT |
|
Fonction de script : Ajoute un nouvel attribut à un élément XML ou modifie un attribut existant.
XML_SET_ATTRIBUTE(Element, Attribute, Value)
|
Elément de syntaxe |
Description / format |
|---|---|
|
Elément |
Référence à l'élément dont l'attribut doit être modifié ou auquel le nouvel attribut doit être ajouté |
| Attribut | Nom de l'attribut précédé par le caractère '@' Format : littéral de script ou variable de script |
| Valeur | 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. |
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 à 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.
Cotez que seul l'élément enregistré en mémoire sera modifié. L'onglet Documentation n'en est pas affecté.
Une erreur d'exécution se produira si le caractère '@' ne précède pas le nom de l'attribut.
Dans l'exemple suivant, l'onglet Documentation structurée est ouvert sous forme de document XML et l'élément "Child" est sélectionné. Le nouvel attribut "Attribute1" sera ensuite ajouté à l'élément. S'il est ajouté avec succès, l'attribut sera ensuite lu une fois de plus pour vérification et la valeur sera consignée 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
:XML_CLOSE &XMLDOCU#
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