4D v14.3

SAX AJOUTER VALEUR ELEMENT XML

Accueil

 
4D v14.3
SAX AJOUTER VALEUR ELEMENT XML

SAX AJOUTER VALEUR ELEMENT XML 


 

SAX AJOUTER VALEUR ELEMENT XML ( document ; données {; *} ) 
Paramètre Type   Description
document  RefDoc in Référence du document ouvert
données  Texte, Variable in Texte ou variable à insérer dans le document
Opérateur in Si passé = Encoder les caractères spéciaux en mode 'XML Données brutes'

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 BASE64. Dans ce cas bien entendu, vous devez passer un BLOB dans données.

Par défaut, la commande encode les caractères spéciaux (< > ” ’...) contenus dans le paramètre données, sauf si vous avez désactivé ce mécanisme pour le process courant à l'aide de la commande XML FIXER OPTIONS en passant la valeur XML Données brutes à l'option XML Encodage chaînes. Par exemple :


Dans ce contexte, pour forcer l'encodage des caractères spéciaux lors de l'appel de SAX AJOUTER VALEUR ELEMENT XML, il est nécessaire 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)

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.

 
PROPRIÉTÉS 

Produit : 4D
Thème : XML SAX
Numéro : 855
Nom intl. : SAX ADD XML ELEMENT VALUE

Cette commande modifie la variable système OK

 
HISTORIQUE 

Modifié : 4D v11 SQL
Modifié : 4D v12

 
VOIR AUSSI  

SAX LIRE VALEUR ELEMENT XML
XML FIXER OPTIONS

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)

Parent de : SAX AJOUTER VALEUR ELEMENT XML ( 4D v11 SQL Release 6)