SAX AJOUTER VALEUR ELEMENT XML

4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 11 (Modifiée)


SAX AJOUTER VALEUR ELEMENT XML (document; données{; *})

ParamètreTypeDescription
documentDocRefRéférence du document ouvert
donnéesTexte | VariableTexte 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

SAX LIRE VALEUR ELEMENT XML.

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.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant