DOM EXPORT TO FILE
DOM EXPORT TO FILE ( 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 |
Description
La commande DOM EXPORT TO FILE 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.
Notes sur le traitement des caractères de fin de ligne et des BOM
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 "
", 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.
Exemple
Cet exemple sauvegarde l’arbre vRefElem dans le fichier MonDoc.xml :
DOM EXPORT TO FILE(vRefElem;"C:\\dossier\MonDoc.xml")
Variables et ensembles système
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.
Gestion des erreurs
Une erreur est générée lorsque :
- la référence de l’élément n’est pas valide,
- le chemin d’accès spécifié n’est pas valide,
- le volume de stockage retourne une erreur (disque plein, etc.).