Vous êtes sur le site Web historique de la documentation de 4D. Les documentations sont progressivement déplacées vers developer.4d.com |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v20.6
DOM EXPORTER VERS FICHIER
|
DOM EXPORTER VERS FICHIER ( refElément ; cheminFichier ) | ||||||||
Paramètre | Type | Description | ||||||
refElément | Chaîne |
![]() |
Référence d’élément XML racine | |||||
cheminFichier | Texte |
![]() |
Chemin d’accès complet du fichier | |||||
La commande DOM EXPORTER VERS FICHIER permet de sauvegarder un arbre XML dans un fichier sur disque.
Passez dans refElément la référence de l’élément racine à exporter.
Passez dans cheminFichier le chemin d’accès complet du fichier d’export à utiliser ou à créer. Si le fichier n’existe pas, il est créé.
Si vous passez uniquement un nom de fichier (sans chemin d’accès), le fichier sera recherché ou créé à côté du fichier de structure.
Si vous passez une chaîne vide (""), une boîte de dialogue standard d’ouverture et de création de fichier apparaît.
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 FIXER 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 FIXER OPTIONS.
Cet exemple sauvegarde l’arbre vRefElem dans le fichier MonDoc.xml :
DOM EXPORTER VERS FICHIER(vRefElem;"C:\\dossier\MonDoc.xml")
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.
Une erreur est générée lorsque :
Produit : 4D
Thème : XML DOM
Numéro :
862
Nom intl. : DOM EXPORT TO FILE
Créé : 4D 2004
4D - Langage ( 4D v20)
4D - Langage ( 4D v20.1)
4D - Langage ( 4D v20.2)
4D - Langage ( 4D v20.3)
4D - Langage ( 4D v20.4)
4D - Langage ( 4D v20.5)
4D - Langage ( 4D v20.6)