Vous êtes sur le site Web historique de la documentation de 4D. Les documentations sont progressivement déplacées vers developer.4d.com
- 4D - Langage
-
- XML DOM
-
-
Présentation des commandes XML DOM
-
DOM Append XML child node
-
DOM Append XML element
-
DOM CLOSE XML
-
DOM Count XML attributes
-
DOM Count XML elements
-
DOM Create XML element
-
DOM Create XML element arrays
-
DOM Create XML Ref
-
DOM EXPORT TO FILE
-
DOM EXPORT TO VAR
-
DOM Find XML element
-
DOM Find XML element by ID
-
DOM Get first child XML element
-
DOM Get last child XML element
-
DOM Get next sibling XML element
-
DOM Get parent XML element
-
DOM Get previous sibling XML element
-
DOM Get Root XML element
-
DOM GET XML ATTRIBUTE BY INDEX
-
DOM GET XML ATTRIBUTE BY NAME
-
DOM GET XML CHILD NODES
-
DOM Get XML document ref
-
DOM Get XML element
-
DOM GET XML ELEMENT NAME
-
DOM GET XML ELEMENT VALUE
-
DOM Get XML information
-
DOM Insert XML element
-
DOM Parse XML source
-
DOM Parse XML variable
-
DOM REMOVE XML ATTRIBUTE
-
DOM REMOVE XML ELEMENT
-
DOM SET XML ATTRIBUTE
-
DOM SET XML DECLARATION
-
DOM SET XML ELEMENT NAME
-
DOM SET XML ELEMENT VALUE
-
DOM EXPORT TO VAR
| DOM EXPORT TO VAR ( 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 EXPORT TO VAR 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 SEND PACKET par exemple).
En mode Unicode, l'encodage d'origine est conservé dans la variable.
En XML, les sauts de 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'import et d'export, les caractères de saut de ligne peuvent être convertis. Lors d'un import, le parseur XML remplace les caractères CRLF (sauts de ligne standard sous Windows) par des caractères LF. Pendant l'export, les caractères LF sont remplacés par des caractères CRLF sous Windows (pas de remplacement sous macOS).
Note : Si vous souhaitez conserver les retours chariot, vous devez les inclure dans un élément XML CDATA afin 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 qui ne sera pas traité par le parseur en lieu et place des caractères CRLF.
Par défaut, les fichiers XML sont écrits sans BOM (Byte order mask).
Vous pouvez contrôler le traitement des fins de ligne XML et du BOM à l'aide de la commande XML SET OPTIONS.
Note de compatibilité : Dans les bases /projets créés avec des versions de 4D allant jusqu'à la v19.x, 4D utilise par défaut CR comme caractère de fin de ligne sur macOS et ainsi qu'un BOM. Pour activer les nouveaux paramètres par défaut, vérifiez les paramètres de compatibilité (voir la page Compatibilité) ou utilisez la commande XML SET OPTIONS.
Cet exemple sauvegarde l’arbre vRefElem dans une variable texte :
C_TEXT(vtMonTexte)
DOM EXPORT TO VAR(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
Créé : 4D 2004
4D - Langage ( 4D v20 R7)
