4D v16.3
DOM SET XML ELEMENT VALUE
- 4D - Langage
-
- XML DOM
-
- Présentation des commandes XML DOM
- DOM Append XML child node
- DOM Append XML element
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elementsMod
- DOM Create XML element
- DOM Create XML element arrays
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODES
- DOM Get XML document ref
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML elementMod
- DOM Get XML information
- DOM Insert XML element
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTE
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML DECLARATION
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM SET XML ELEMENT VALUE
| DOM SET XML ELEMENT VALUE ( refElément {; xChemin}; valeurElément {; *} ) | ||||||||
| Paramètre | Type | Description | ||||||
| refElément | Chaîne |
|
Référence d’élément XML | |||||
| xChemin | Texte |
|
Chemin XPath de l’élément XML | |||||
| valeurElément | Chaîne, Variable |
|
Nouvelle valeur de l’élément | |||||
| * | Opérateur |
|
Si passé : définir la valeur en CDATA | |||||
La commande DOM SET XML ELEMENT VALUE permet de modifier la valeur de l’élément désigné par refElément.
Si vous passez le paramètre facultatif xChemin, vous choisissez d'utiliser la notation XPath pour désigner l’élément à modifier (pour plus d'informations sur cette notation, reportez-vous au paragraphe “Utilisation de la notation XPath” dans la section Présentation des commandes XML DOM). Dans ce cas, vous devez passer la référence d’un élément XML racine dans refElément et le chemin XPath de l’élément à modifier dans xChemin.
Passez dans valeurElément une chaîne ou une variable (ou un champ) contenant la nouvelle valeur de l’élément :
- si vous passez une chaîne, la valeur sera affectée telle quelle dans la structure XML.
- si vous passez une variable ou un champ, 4D appliquera un traitement approprié à la valeur en fonction du type de valeurElément. Tous les types de données peuvent être utilisés, à l’exception des tableaux, images et pointeurs.
Lorsque le paramètre facultatif astérisque (*) est passé, vous indiquez que la valeur de l’élément doit être définie sous la forme CDATA. La forme spéciale CDATA permet d’écrire du texte sous forme brute (cf. exemple 2).
Note : Lorsque l’élément désigné par refElément est de type BLOB, DOM SET XML ELEMENT VALUE l'encode automatiquement en base64. Dans ce cas, la commande DOM GET XML ELEMENT VALUE effectue automatiquement l'opération inverse.
Par conformité avec les règles de traitement XML, toutes les séquences de caractères de fin de ligne CR et CRLF sont converties en caractères LF.
Soit la source XML suivante :
<Book> <Title>The Best Seller</Title> </Book>
Si le code suivant est exécuté, en admettant que vRefElem contienne la référence de l’élément ‘Title’ :
DOM SET XML ELEMENT VALUE(vRefElem;"The Loser")Nous obtenons :
<Book> <Title>The Loser</Title> </Book>
Soit la source XML suivante :
<Maths> <Postulate>1+2=3</Postulate> </Maths>
Nous souhaitons écrire le texte “12 < 18” dans l’élément <postulate>. Cette chaîne ne peut pas être écrite telle quelle en XML car le caractère “<” n’est pas accepté. Ce caractère doit donc être transformé en “<”, ou la forme CDATA doit être utilisée. Si vElemRef désigne le noeud XML <Postulate> :
` Forme normale
DOM SET XML ELEMENT VALUE(vRefElem;"12 < 18")Nous obtenons :
<Maths> <Postulate>12 < 18</Postulate> </Maths>
` Forme CDATA
DOM SET XML ELEMENT VALUE(vRefElem;"12 < 18";*)Nous obtenons :
<Maths> <Postulate><![CDATA[12 < 18]]></Postulate> </Maths>
Si la commande a été exécutée correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0 et une erreur est générée (par exemple, si la référence de l’élément n’est pas valide).
Produit : 4D
Thème : XML DOM
Numéro :
868
Modifié : 4D 2004.4
Modifié : 4D v11 SQL
4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)
