WP EXPORTER DOCUMENT

4D v20


WP EXPORTER DOCUMENT ( docWP ; cheminFichier {; format {; options}} )

Paramètre	Type	Description
docWP	Objet	Variable 4D Write Pro
cheminFichier	Chaîne	Chemin du fichier d'export
format	Entier long	Format de sortie du document
options	Objet, Entier long	Options d'export

Description

La commande WP EXPORTER DOCUMENT exporte l'objet 4D Write Pro docWP dans un document sur disque défini par le paramètre cheminFichier ainsi que des paramètres optionnels.

Dans docWP, passez l'objet 4D Write Pro que vous voulez exporter.

Dans cheminFichier, passez le chemin de destination et le nom du document à exporter. Si vous passez uniquement un nom de fichier, il sera enregistré au même niveau que le fichier de structure de 4D. Par défaut, si vous omettez le paramètre format, la commande utilise l'extension du fichier pour déterminer le format d'export du document.

Vous pouvez également passer une constante du thème Constantes 4D Write Pro dans le paramètre format. Dans ce cas, 4D ajoute l'extension appropriée au nom de fichier si nécessaire. Les formats suivants sont pris en charge :

Constante	Valeur	Comment
wk 4wp	4	Le document 4D Write Pro est sauvegardé dans un format d'archive natif (HTML zippé avec images stockées dans un dossier séparé). Les expressions 4D ne sont pas calculées et les balises 4D spécifiques sont incluses. Ce format est particulièrement approprié pour la sauvegarde et l'archivage de documents 4D Write Pro sur disque sans aucune perte d'informations.
wk docx	7	Extension .docx. Le document 4D Write Pro est sauvegardé sous format Microsoft Word (certifié pour Microsoft Word 2010 et versions plus récentes). Les éléments du document exportés sont les suivants : Corps / en-têtes / pieds de page / sections Page / paramètres d'impression (marges, couleur d'arrière-plan / image, bordures, marges intérieures, taille du papier / orientation) Images - en ligne, ancrée, et format d'image d'arrière-plan (défini avec wk background image) Variables et expressions compatibles (numéro de page, nombre de pages, date, heure, metadonnées). Les variables et expressions non compatibles seront évaluées et figées avant l'export. Signets Notez que certains paramètres de 4D Write Pro peuvent être non disponibles ou fonctionner différemment dans Microsoft Word.
wk mime html	1	Le document 4D Write Pro est sauvegardé au format MIME HTML avec les documents html et les images embarqués en tant que parties MIME (encodées en base64). Les expressions sont calculées et les balises 4D spécifiques sont supprimées. Ce format est particulièrement adapté à l'envoi de mails au format HTML à l'aide de la commande SMTP_QuickSend.
wk page web complète	2	Extension .htm ou .html. Le document est sauvegardé au format HTML standard et ses ressources sont sauvegardées séparément. Les balises 4D spécifiques sont supprimées et les expressions sont calculées. Ce format est particulièrement adapté à l'affichage d'un document 4D Write Pro dans un navigateur Web.
wk pdf	5	Extension .pdf. Le document 4D Write Pro est sauvegardé au format PDF, selon le mode de vue Page. Les métadonnées suivantes sont exportées dans un document PDF : Titre Auteur Sujet Créateur de contenu Notes : Les expressions sont automatiquement figées lorsque le document est exporté Les liens vers les méthodes ne sont PAS exportés
wk svg	8	La page du document 4D Write Pro est enregistrée au format SVG, défini sur le mode d'affichage Page. Note : Lors de l'export au format SVG, vous pouvez exporter une seule page à la fois uniquement. Utilisez wk page index pour renseigner la page à exporter.

Notes :

"Balises 4D spécifiques" désigne le XHTML 4D avec namespace 4D et styles CSS 4D.
Pour plus d'informations sur le format de document 4D Write Pro, veuillez vous reporter au paragraphe Format de document .4wp.
Pour consulter la liste des différences ou des incompatibilités connues liées à l'utilisation du format .docx, veuillez lire Exporter au format .docx.
Pour plus d'informations sur l'exportation au format SVG, voir Exporter au format SVG.

Paramètre option

Passez un objet dans option contenant les valeurs définissant les propriétés du document exporté. Les propriétés suivantes sont disponibles :

Constante	Valeur	Comment
wk HTML pretty print	htmlPrettyPrint	Le code HTML est formaté pour faciliter sa lecture.
wk max picture DPI	maxPictureDPI	Utilisé pour réajuster (réduire) les images à une résolution souhaitée. Pour les images SVG sur Windows, elles sont utilisées pour le tramage. Valeurs par défaut : 300 (pour wk optimized for = wk print) 192 (pour wk optimized for = wk screen) Valeur maximale possible : 1440
wk optimized for	optimizedFor	Définit comment un document exporté est optimisé selon son support. Valeurs possibles : wk print (valeur par défaut pour wk pdf) Les images bitmap peuvent être réajustées à l'aide du DPI défini par wk max picture DPI ou 300 (valeur par défaut) et peuvent être converties en PNG si le codec n'est pas pris en charge par le type d'export. Les images vectorielles sont converties en PNG à l'aide du DPI défini par wk max picture DPI ou 300 (Windows uniquement) Si une image contient plus d'un format, le meilleur format pour l'impression sera utilisé (ex : .tiff au lieu de .jpg) wk screen (valeur par défaut pour wk page web complète et wk mime html) Les images bitmap peuvent être réajustées à l'aide du DPI défini par wk max picture DPI ou 192 (valeur par défaut) et peuvent être converties en JPEG (images opaques) ou en PNG (images transparentes) si le codec n'est pas pris en charge par le type d'export. Les images vectorielles sont converties en PNG à l'aide du DPI défini par wk max picture DPI ou 192 (Windows uniquement) Si une image contient plus d'un format, le meilleur format pour le rendu écran sera utilisé
wk recompute formulas	recomputeFormulas	Définit si les formules doivent être recalculées lorsqu'elles sont exportées. Valeurs possibles : vrai- Valeur par défaut. Toutes les formules sont recalculées faux- Ne recalcule pas les formules
wk visible background and anchored elements	visibleBackground	Affiche ou exporte les images de fond, la couleur de fond, les images ancrées et les zones de texte (pour l'affichage, effet visible uniquement en mode d'affichage Page ou Inclus). Valeurs possibles : True/False
wk visible footers	visibleFooters	Affiche ou exporte les pieds de page (pour l'affichage, effet visible uniquement en mode d'affichage Page). Valeurs possibles : True/False
wk visible headers	visibleHeaders	Affiche ou exporte les en-têtes (pour l'affichage, effet visible uniquement en mode d'affichage Page). Valeurs possibles : True/False
wk visible references	visibleReferences	Affiche ou exporte toutes les expressions 4D insérées dans le document en tant que références. Valeurs possibles : True/False

Le tableau suivant indique l'option disponible par format d'export :

	wk 4wp	wk docx	wk mime html	wk pdf	wk web page html 4D	wk svg
wk CID host domain name	-	-		-	-	-
wk HTML pretty print	(par défaut : faux)	-	(par défaut : Faux)	(par défaut : Faux)	(par défaut : Faux)	(par défaut : faux)
wk max picture DPI	-	toujours 300		(par défaut : 300)	-	(par défaut : 300)
wk optimized for	-	toujours wk print	(par défaut :wk screen)	toujours wk print	-	(par défaut : wk print)
wk recompute formulas	-	(par défaut : vrai)	(par défaut : vrai)	(par défaut : vrai)	-	(par défaut : vrai)
wk visible background and anchored elements	-	(par défaut : vrai)	toujours vrai	(par défaut : vrai)	-	(par défaut : vrai)
wk visible footers	-	toujours vrai	toujours faux	(par défaut : vrai)	-	(par défaut : vrai)
wk visible headers	-	toujours vrai	toujours faux	(par défaut : vrai)	-	(par défaut : vrai)
wk visible empty images		(par défaut : vrai)	(par défaut : vrai)	(par défaut : vrai)		(par défaut : vrai)
wk visible references	-	-	-	(par défaut : faux)	-	(par défaut : faux)
wk page index						(par défaut : 1)
wk embedded pictures						(par défaut : vrai)
wk google fonts tag						(par défaut : faux)

Note de compatibilité : Passer une valeur entier long dans option est pris en charge pour des raisons de compatibilité, mais il est recommandé d'utiliser un paramètre objet.

Exemple 1

Vou souhaitez exporter le contenu de l'objet 4D Write Pro myArea aux formats HTML et PDF :

  // exporter HTML

 var $option : Object

 $option:=Creer object

 

 $option[wk recompute formulas]:=Faux

 $option[wk HTML pretty print]:=Faux

 $option[wk optimized for]:=wk print

 $option[wk max picture DPI]:=600 //remplacer la valeur par défaut pour l'impression (300 DPI)

 

 WP EXPORTER DOCUMENT(myArea;$path;wk web page complete;$option)

 

  //exporter PDF

 var $option : Object

 $option:=Creer object

 

 $option[wk visible headers]:=Vrai

 $option[wk visible footers]:=Vrai

 $option[wk visible background]:=Vrai

 $option[wk max picture DPI]:=96 //remplacer la valeur par défaut pour l'écran (192 DPI) pour limiter la taille du document

 $option[wk optimized for]:=wk screen

 $option[wk recompute formulas]:=Vrai

 

 WP EXPORTER DOCUMENT(myArea;$path;wk pdf;$option)

Exemple 2

Vous souhaitez exporter le contenu de l'objet 4D Write Pro myArea dans le format .4wp :

 C_TEXTE($path)

 C_ENTIER LONG($docRef)

 

 Au cas ou

    :(Evenement formulaire code=Sur clic)

 

       $path:=Dossier 4D(Dossier base)+"Export"+Séparateur dossier

       $path:=Selectionner document($path;".4wp";" title";Saisie nom de fichier)

 

       Si($path#"")

          WP EXPORTER DOCUMENT(myArea;document;wk 4wp;wk normal)

       Sinon

          ALERTE("An error occurred.")

       Fin de si

 Fin de cas

Exemple 3

Pour exporter la deuxième page du document en SVG et exporter les images depuis le document :

 var $options : Object

 

 $options:=New object

 $options[wk embedded pictures]:=false

 $options[wk page index]:=2

 

 WP EXPORT DOCUMENT(WPArea;"my exported document";wk svg;$options)

Voir aussi

Exporter au format .docx
Exporter aux formats HTML et MIME HTML
WP EXPORTER VARIABLE