4D v16.3
DOM EXPORTER VERS VARIABLE
- 4D - Langage
-
- XML DOM
-
- Présentation des commandes XML DOM
- DOM Ajouter element XML
- DOM Ajouter noeud enfant XML
- DOM Analyser source XML
- DOM Analyser variable XML
- DOM Chercher element XML
- DOM Chercher element XML par ID
- DOM Compter attributs XML
- DOM Compter elements XMLMod
- DOM Creer element XML
- DOM Creer element XML tableaux
- DOM Creer ref XML
- DOM ECRIRE ATTRIBUT XML
- DOM ECRIRE NOM ELEMENT XML
- DOM ECRIRE VALEUR ELEMENT XML
- DOM EXPORTER VERS FICHIER
- DOM EXPORTER VERS VARIABLE
- DOM FERMER XML
- DOM FIXER DECLARATION XML
- DOM Inserer element XML
- DOM LIRE ATTRIBUT XML PAR INDEX
- DOM LIRE ATTRIBUT XML PAR NOM
- DOM Lire dernier element XML enfant
- DOM Lire element XML frere precedent
- DOM Lire element XML frere suivant
- DOM Lire element XML parent
- DOM Lire element XML racine
- DOM Lire element XMLMod
- DOM Lire informations XML
- DOM LIRE NOEUDS ENFANTS XML
- DOM LIRE NOM ELEMENT XML
- DOM Lire premier element XML enfant
- DOM Lire ref document XML
- DOM LIRE VALEUR ELEMENT XML
- DOM SUPPRIMER ATTRIBUT XML
- DOM SUPPRIMER ELEMENT XML
DOM EXPORTER VERS VARIABLE
| DOM EXPORTER VERS VARIABLE ( refElément ; vVarXml ) | ||||||||
| Paramètre | Type | Description | ||||||
| refElément | Chaîne |
|
Référence d’élément XML racine | |||||
| vVarXml | Texte, BLOB |
|
Variable devant recevoir l’arbre XML | |||||
La commande DOM EXPORTER VERS VARIABLE permet de sauvegarder un arbre XML dans une variable texte ou BLOB.
Passez dans refElément la référence de l’élément racine à exporter.
Passez dans vVarXml le nom de la variable devant contenir l’arbre XML. Cette variable peut être de type Texte ou BLOB. Vous pouvez choisir le type en fonction des opérations à effectuer par la suite ou de la taille que l’arbre peut atteindre (rappelons qu'en mode Non unicode les variables de type Texte sont limitées à 32 K de texte, en mode Unicode cette limite est de 2 Go).
Attention, en mode Non unicode si vous utilisez une variable Texte pour stocker l'élément refElément, il sera encodé en Mac “courant” (c'est-à-dire Mac Roman sur la plupart des systèmes occidentaux). Cela signifie que le texte retourné ne sera plus dans l'encodage d'origine (encoding="xxx"). Dans ce cas, la variable vVarXml permet de visualiser ou de stocker le code obtenu mais PAS de générer un document XML valide (via la commande ENVOYER PAQUET par exemple).
En mode Unicode, l'encodage d'origine est conservé dans la variable.
En XML, les retours à la ligne ne sont pas significatifs, qu'ils soient présents à l'intérieur ou entre des éléments XML. En interne, le XML utilise des caractères normalisés LF comme séparateurs de lignes.
Lors des opérations d'importation et d'exportation, les caractères de retour à la ligne peuvent donc être convertis. A l'importation, l'analyseur XML remplace les caractères CRLF (retours à la ligne standard sous Windows) par des caractères LF. A l'export, les LF sont remplacés par des caractères CR sous macOS et des caractères CRLF sous Windows.
Si vous souhaitez préserver des retours chariot, il faut les inclure dans un élément XML CDATA pour qu'ils ne soient pas traités par l'analyseur XML. Vous pouvez également utiliser le caractère "<br/>" qui est un retour chariot explicite et qui ne sera pas traité par l'analyseur en lieu et place des caractères CRLF.
Cet exemple sauvegarde l’arbre vRefElem dans une variable texte :
C_TEXTE(vtMonTexte)
DOM EXPORTER VERS VARIABLE(vRefElem;vtMonTexte)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 :
863
Nom intl. : DOM EXPORT TO VAR
Créé : 4D 2004
4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)
