4D v16.3

DOM EXPORTER VERS FICHIER

Accueil

 
4D v16.3
DOM EXPORTER VERS FICHIER

DOM EXPORTER VERS FICHIER 


 

DOM EXPORTER VERS FICHIER ( refElément ; cheminFichier ) 
Paramètre Type   Description
refElément  Chaîne in Référence d’élément XML racine
cheminFichier  Texte in 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 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.

Exemple  

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 :

  • 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.).



Voir aussi  

DOM EXPORTER VERS VARIABLE
SVG EXPORTER VERS IMAGE

 
PROPRIÉTÉS 

Produit : 4D
Thème : XML DOM
Numéro : 862
Nom intl. : DOM EXPORT TO FILE

Cette commande modifie la variable système OKCette commande modifie la variable système ErrorCommande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Créé : 4D 2004

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)