version 11 (Modifiée)
SAX AJOUTER VALEUR ELEMENT XML (document; données{; *})
Paramètre | Type | Description | |
document | DocRef | Référence du document ouvert | |
données | Texte | Variable | Texte ou variable à insérer dans le document | |
* | * | Si passé = Encoder les caractères spéciaux | |
Si omis = Ne pas encoder les caractères spéciaux |
Description
La commande SAX AJOUTER VALEUR ELEMENT XML ajoute directement dans le document XML référencé par document des données sans les convertir. Cette commande équivaut par exemple à insérer une pièce jointe dans le corps (body) d'un email.
Vous pouvez passer dans le paramètre données soit directement une chaîne de caractères, soit une variable 4D. Le contenu de la variable sera converti en texte pour pouvoir être inséré dans le document XML.
Si vous souhaitez encoder le contenu de données, vous devez utiliser la commande ENCODER. Dans ce cas bien entendu, vous devez passer un BLOB dans données.
Par défaut, la commande n'encode pas les caractères spéciaux (< > " '...) contenus dans le paramètre données. Pour forcer l'encodage de ces paramètres, il suffit de passer le paramètre facultatif *.
Pour que cette commande fonctionne, un élément doit être ouvert. Dans le cas contraire, une erreur est générée.
Exemple
Cet exemple insère le fichier whitepaper.pdf dans l'élément XML ouvert :
C_BLOB(vBMonBLOB) DOCUMENT VERS BLOB ("c:\\whitepaper.pdf";vBMonBLOB) SAX AJOUTER VALEUR ELEMENT XML($RefDoc;vBMonBLOB)
Référence
Variables et ensembles système
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.