WP EXPORTER VARIABLE

4D v19


WP EXPORTER VARIABLE ( docWP ; destination ; format {; options} )

Paramètre	Type	Description
docWP	Objet	Variable 4D Write Pro
destination	Variable texte, Variable BLOB	Variable devant recevoir le contenu exporté
format	Entier long	Format de sortie de la variable
options	Objet, Entier long	Options d'export

Description

La commande WP EXPORTER VARIABLE exporte l'objet 4D Write Pro docWP dans la variable 4D destination avec le format spécifié.

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

Dans destination, passez la variable que vous voulez remplir avec l'objet 4D Write Pro exporté. Le type de la variable dépend du format d'export défini dans le paramètre format :

si vous passez le format natif .4wp ou le format .docx, la variable sera de type Blob,
si vous passez un format html, la variable sera de type Texte.

Dans le paramètre format, passez une constante du thème Constantes 4D Write Pro définissant le format d'export que vous voulez utiliser. Chaque format est lié à un usage spécifique. Les formats suivants sont pris en charge :

Constante	Type	Valeur	Comment
wk 4wp	Entier long	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	Entier long	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	Entier long	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 html 4D	Entier long	3	Le document 4D Write Pro est sauvegardé au format HTML et inclut les balises 4D spécifiques ; chaque expression est insérée sous forme d'espace insécable. Comme ce format est sans perte, il est approprié pour le stockage dans un champ texte.
wk pdf	Entier long	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

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.

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 CID host domain name	cidHostDomain	Nom de domaine hôte : domaine hôte qui sera ajouté aux URLs CID générés comprenant un '@' comme séparateur. Disponible uniquement lorsque le format wk mime html est utilisé.
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	visibleBackground	Affiche les images de fond et la couleur de fond (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 CID host domain name	-	-		-	-
wk HTML pretty print	(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)	-
wk optimized for	-	toujours wk print	(par défaut :wk screen)	always [#cst id="5048839" /]	-
wk recompute formulas	-	(default: true)	(par défaut : vrai)	(par défaut : vrai)	-
wk visible background	-	toujours vrai	toujours faux	(par défaut : vrai)	-
wk visible footers	-	toujours vrai	toujours faux	(par défaut : vrai)	-
wk visible headers	-	toujours vrai	toujours faux	(par défaut : vrai)	-
wk visible references	-	-	-	(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

Vous souhaitez exporter le contenu de l'objet 4D Write Pro myArea au format MIME et ajouter "gmail.com" comme domaine hôte :

 var $option;$export : Objet

 $option[wk CID host domain name]:="gmail.com"

 WP EXPORTER VARIABLE(myArea;$export;wk mime html;$option)

Exemple 2

Vous voulez envoyer un mail contenant du texte multistyle, des références 4D et des images. Vous pouvez utiliser une zone 4D Write Pro exportée au format MIME HTML et l'envoyer en utilisant 4D Internet Commands :

 C_ENTIER LONG($smtpid_l;$err_l;$smtpOption_l;$smtpPort_l)

 C_TEXTE($str;$emailBody_t;$smtpHost_t;$emailTo_t;$emailFrom_t;$smtpPass_t)

 

  //export zone dans le format approprié

 WP EXPORTER VARIABLE(myWPArea;$str;wk mime html)

 $emailTo_t:="johnsmith@4d.com"

 $emailFrom_t:="testWritePro@gmail.com"

 $emailBody_t:=$str

 $smtpHost_t:="smtp.gmail.com"

 $smtpOption_l:=9

 $smtpPort_l:=465

 $smtpPass_t:="QRN_on_bretzelburg"

 

 $err_l:=SMTP_QuickSend($smtpHost_t;$emailFrom_t;$emailTo_t;$emailTitle_t;\

 $emailBody_t;$smtpOption_l;$smtpPort_l;$smtpUser_t;$smtpPass_t)

 

 Si(($err_l=0))

    ALERTE("Message envoyé à "+emailTo_t)

 Sinon

    ALERTE("Erreur dans les paramètres, veuillez réessayer.")

 Fin de si

Voir aussi

Exporter au format .docx
WP EXPORTER DOCUMENT