4D Doc Center : XML LIRE OPTIONS

4D v14.3

XML

XML LIRE OPTIONS


XML LIRE OPTIONS ( refElément \| document ; sélecteur ; valeur {; sélecteur2 ; valeur2 ; ... ; sélecteurN ; valeurN} )

Paramètre	Type	Description
refElément \| document	Texte, RefDoc	Référence d’élément XML racine ou Référence de document ouvert
sélecteur	Entier long	Option à lire
valeur	Entier long	Valeur courante de l’option

Description

La commande XML LIRE OPTIONS permet de lire la valeur courante d’un ou plusieurs paramètre(s) XML définis pour la session courante et l’utilisateur courant.

Passez dans sélecteur une des constantes du thème XML ci-dessous, indiquant l’option à connaître. La valeur courante de l’option est retournée dans le paramètre valeur :

Constante	Type	Valeur	Commentaire
XML encodage binaire	Entier long	5	Définit la manière dont les données binaires seront converties. Valeurs possibles : XML Base64 (valeur par défaut) : les données binaires sont simplement converties en base64. XML Data URI scheme : les données binaires sont converties en base64 et l’en-tête "data:;base64" est ajouté. Ce format permet principalement à un navigateur de décoder automatiquement une image, et est également requis pour l’insertion d’images . Pour plus d’informations, voir http://en.wikipedia.org/wiki/Data_URI_scheme.
XML encodage chaînes	Entier long	1	Définit la manière dont les chaînes 4D sont converties en valeurs d’éléments. Il ne concerne pas les conversions en attributs pour lesquelles le XML impose l’utilisation de caractères d’échappement. Valeurs possibles : XML Avec échappement (valeur par défaut) : conversion des chaînes 4D en valeurs d’éléments XML avec remplacement des caractères. Les données de type texte sont automatiquement analysées de manière à ce que les caractères interdits (<&>’) soient remplacés par des entités XML (&<> '"). XML Données brutes : les chaînes 4D sont envoyées en tant que données brutes, 4D n’effectue ni encodage ni analyse. Les valeurs 4D seront converties si possible en fragments XML et insérées en tant qu’enfant de l’élément cible. Si une valeur ne peut pas être considérée comme fragment XML, elle est insérée sous forme de donnée brute dans un nouveau noeud CDATA
XML encodage dates	Entier long	2	Définit la manière dont les dates 4D seront converties. Par exemple, le !01/01/2003! dans le fuseau horaire de Paris. Valeurs possibles : XML ISO (valeur par défaut) : utilisation du format xs:datetime sans indication de fuseau horaire. Résultat : "2003-01-01". La partie heure, si elle est présente dans la valeur 4D (via le SQL), est perdue. XML Local : utilisation du format xs:date avec indication de fuseau horaire. Résultat : "2003-01-01 +01:00". La partie heure, si elle est présente dans la valeur 4D (via le SQL), est perdue. XML Datetime local : utilisation du format xs:dateTime (ISO 8601). Indication de fuseau horaire. Ce format permet de conserver la partie heure, si elle est présente dans la valeur 4D (via le SQL). Résultat : "<Date>2003-01-01T00:00:00 +01:00</Date>". XML UTC : utilisation du format xs:date. Résultat : "2003-01-01Z". La partie heure, si elle est présente dans la valeur 4D (via le SQL), est perdue. XML Datetime UTC : utilisation du format xs:dateTime (ISO 8601). Ce format permet de conserver la partie heure, si elle est présente dans la valeur 4D (via le SQL). Résultat : "<Date>2003-01-01T00:00:00Z</Date>".
XML encodage heures	Entier long	3	Définit la manière dont les heures 4D seront converties. Par exemple, ?02/00/46? (heure de Paris). L’encodage diffère suivant que vous souhaitez exprimer une heure ou une durée. Valeurs possibles pour les heures : XML Datetime UTC : heure exprimée en UTC (Temps Universel Coordonné). A noter que la conversion en UTC est automatique. Résultat : "<Duree>0000-00-00T01:00:46Z</Duree>". XML Datetime local : heure exprimée avec le décalage horaire de la machine du moteur de 4D. Résultat : "<Duree>0000-00-00T02:00:46+01:00</Duree>". XML Datetime local absolu (valeur par défaut) : heure exprimée sans indication de fuseau horaire. Pas de modification de la valeur. Résultat : "<Duree>0000-00-00T02:00:46</Duree>". Valeurs possibles pour les durées : XML Secondes : nombre de secondes depuis minuit, pas de modification de la valeur puisqu’elle exprime une durée. Résultat : "<Duree>7246</Duree>". XML Durée : durée exprimée de manière conforme au XML Schema Part 2: Datatypes Second Edition. Pas de modification de la valeur puisqu’elle exprime une durée. Résultat : "<Duree>PT02H00M46S</Duree>".
XML encodage images	Entier long	6	Définit la manière dont les images doivent converties (avant l’encodage en base64). Valeurs possibles : XML Convertir en PNG (valeur par défaut) : les images sont converties en PNG avant d’être encodées en base64. XML Codec natif : les images sont converties dans leur premier CODEC natif de stockage avant d’être encodées en base64. Vous devez utiliser ces options pour encoder des images SVG (voir exemple de la commande XML FIXER OPTIONS).
XML indentation	Entier long	4	Définit l’indentation du document XML. Valeurs possibles : XML Avec indentation (valeur par défaut) : le document est indenté. XML Sans indentation : le document n’est pas indenté, son contenu est placé sur une seule ligne.