WP EXPORT VARIABLE

Home

4D v19

WP EXPORT VARIABLE


WP EXPORT VARIABLE ( wpDoc ; Ziel ; Format {; Option} )

Parameter	Typ	Beschreibung
wpDoc	Objekt	4D Write Pro Variable
Ziel	Textvariable, BLOB Variable	Variable für den exportierten Inhalt
Format	Lange Ganzzahl	Ausgabeformat der Variablen
Option	Objekt, Lange Ganzzahl	Exportoptionen

Beschreibung

Der Befehl WP EXPORT VARIABLE exportiert das 4D Write Pro Objekt wpDoc in die 4D Variable Ziel im angegebenen Format.

In wpDoc übergeben Sie das Objekt 4D Write Pro für den Export.

In Ziel übergeben Sie die Variable, die Sie mit dem exportierten Objekt 4D Write Pro füllen wollen. Der Variablentyp richtet sich nach dem Exportformat, das im Parameter Format angegeben ist:

Übergeben Sie das native Format .4wp oder .docx , ist die Variable vom Typ Blob
Übergeben Sie ein HTML Format, ist die Variable vom Typ Text

Im Parameter Format übergeben Sie eine Konstante unter dem Thema 4D Write Pro Konstanten, um das gewünschte Exportformat zu setzen. Jedes Format dient für eine spezifische Verwendung. Folgende Formate werden unterstützt:

Konstante	Typ	Wert	Kommentar
wk 4wp	Lange Ganzzahl	4	Das 4D Write Pro Dokument wird in einem nativen Archivformat gesichert (gezipptes HTML und Bilder in einem eigenen Ordner abgelegt). 4D spezifische Tags sind enthalten, 4D Ausdrücke werden nicht berechnet. Dieses Format ist besonders geeignet, um 4D Write Pro Dokumente ohne Verluste auf der Festplatte zu sichern und archivieren.
wk docx	Lange Ganzzahl	7	Endung .docx. 4D Write Pro Dokument wird im Microsoft Word Format gesichert. Zertifizierte Unterstützung für Microsoft Word 2016 und neuer, jedoch kompatibel mit jeder Version, die das Format .docx unterstützt (z.B. Microsoft Word 2013). Die exportierten Dokumentteile sind: Hauptteil / Kopfteil / Fußteil / Abschnitte Seite / Druckeinstellungen (Abstände, Hintergrundfarbe / -bild, Rahmen, Einrückung, Papiergröße / Ausrichtung) Bilder - im Text eingebunden, verankert und Muster für Hintergrundbild (definiert mit wk background image) Kompatible Variablen und Ausdrücke (Seitenzahl, Anzahl Seiten, Datum, Zeit, Metadaten). Nicht-kompatible Variablen und Ausdrücke werden vor dem Export bewertet und eingefroren. Lesezeichen Beachten Sie, dass einige Einstellungen von 4D Write Pro in Microsoft Word u.U. nicht verfügbar sind oder sich anders verhalten können.
wk mime html	Lange Ganzzahl	1	Das 4D Write Pro Dokument wird als standard MIME HTML mit html Dokumenten und Bildern, eingebunden als MIME Teile (codiert in base64), gesichert. Ausdrücke werden berechnet und 4D spezifische Tags werden entfernt. Dieses Format eignet sich besonders, um E-Mails in HTML mit dem Befehl SMTP_QuickSend zu senden.
wk pdf	Lange Ganzzahl	5	.pdf Endung. 4D Write Pro Dokument wird im PDF Format gesichert, basierend auf die Modus Seitenansicht. Folgende Metadaten werden in ein PDF Dokument exportiert: title author subject Content creator Hinweise: Ausdrücke werden beim Exportieren des Dokuments automatisch eingefroren Links zu Methoden werden NICHT exportiert
wk web page html 4D	Lange Ganzzahl	3	Das 4D Write Pro Dokument wird als HTML mit spezifischen 4D Tags gesichert; jeder Ausdruck wird als nicht-umgebrochener Bereich eingefügt. Da dieses Format verlustlos ist, eignet es sich zum Speichern in einem Textfeld.

Hinweise:

"4D spezifische Tags" bedeutet 4D XHTML mit einem 4D Namensbereich und 4D CSS Stilarten
Weitere Informationen zum Format des 4D Write Pro Dokuments finden Sie im Abschnitt Dokumentformat .4wp
Weitere Informationen zum Format .docx, insbesondere die Liste der bekannten Unterschiede oder nicht kompatiblen Features, finden Sie unter Import und Export im Format .docx

Parameter Option

Im Parameter Option übergeben Sie ein Objekt mit den Werten zum Definieren der Eigenschaften des exportierten Dokuments. Es gibt folgende Konstanten:

Konstante	Wert	Kommentar
wk CID host domain name	cidHostDomain	Name des CID Host Domain: Host Domain, das zu generierten CID URLs hinzugefügt wird, mit einem '@' als Trenner. Nur verfügbar, wenn das Format wk mime html verwendet wird.
wk HTML pretty print	htmlPrettyPrint	HTML Code wird formatiert, damit der Inhalt von Menschen leichter lesbar ist (Quelltextformatierung).
wk max picture DPI	maxPictureDPI	Zum Anpassen (Verkleinern) von Bildern auf die bevorzugte Auflösung. Für SVG Bilder unter Windows zur Rasterung. Standardwerte: 300 (für wk optimized for = wk print) 192 (für wk optimized for = wk screen) Maximal mögliche Werte: 1440
wk optimized for	optimizedFor	Definiert wie ein exportiertes Dokument entsprechend dem vorgesehenen Medium optimiert wird. Mögliche Werte: wk print (Standardwert für wk pdf) Bitmap Bilder werden mit der DPI geladen, definiert über wk max picture DPI oder mit 300 (Standardwert), und in PNG konvertiert, wenn Codec für den Exporttyp nicht unterstützt wird. Vektorbilder werden in PNG konvertiert, mit der DPI definiert durch wk max picture DPI oder mit 300 (nur Windows) Enthält ein Bild mehr als ein Format, wird das zum Drucken am besten geeignete Format verwendet (z.B. .tiff anstatt .jpg) wk screen (Standardwert für wk web page complete und wk mime html) Bitmap Bilder werden mit der DPI geladen, definert über wk max picture DPI oder mit 192 (Standardwert), und in JPEG (kompakte Bilder) oder PNG (transparente Bilder) konvertiert, wenn Codec für den Exporttyp nicht unterstützt wird. Vektorbilder werden in PNG konvertiert, mit der DPI definiert durch wk max picture DPI oder mit 192 (nur Windows) Enthält ein Bild mehr als ein Format, wird das Format zum Rendern des Bildschirms verwendet.
wk recompute formulas	recomputeFormulas	Definiert, ob Formeln beim Export neu berechnet werden. Mögliche Werte: wahr - Standardwert. Alle Formeln werden neu berechnet falsch - Formeln nicht neu berechnen
wk visible background	visibleBackground	Zeigt Hintergrundbilder und Hintergrundfarbe an (sichtbarer Effekt nur im Modus Seite und Eingebunden). Mögliche Werte: True/False
wk visible footers	visibleFooters	Zeigt die Fußteile an (sichtbarer Effekt nur im Modus Seite). Mögliche Werte: True/False
wk visible headers	visibleHeaders	Zeigt die Kopfteile an (sichtbarer Effekt nur im Modus Seite). Mögliche Werte: True/False
wk visible references	visibleReferences	Zeigt alle im Dokument eingefügte 4D Ausdrücke als Referenzen an. Mögliche Werte: True/False

Nachfolgende Tabelle gibt die verfügbare Option je nach Export Format an:

	wk 4wp	wk docx	wk mime html	wk pdf	wk web page html 4D
wk CID host domain name	-	-		-	-
wk HTML pretty print	(Standard: falsch)	-	(Standard: falsch)	(Standard: falsch)	(Standard: falsch)
wk max picture DPI	-	immer 300		(Standard: 300)	-
wk optimized for	-	immer wk print	(Standard: wk screen)	immer wk print	-
wk recompute formulas	-	(Standard: wahr)	(Standard: wahr)	(Standard: wahr)	-
wk visible background	-	immer wahr	immer wahr	(Standard: wahr)	-
wk visible footers	-	immer wahr	immer falsch	(Standard: wahr)	-
wk visible headers	-	immer wahr	immer falsch	(Standard: wahr)	-
wk visible references	-	-	-	(Standard: wahr)	-

Hinweis zur Kompatibilität: Zur Wahrung der Kompatibilität wird der Wert Lange Ganzzahl in Option noch unterstützt, wir empfehlen jedoch einen Parameter Objekt zu verwenden.

Beispiel 1

Den Inhalt des 4D Write Pro Objekts myArea im MIME Format exportieren und "gmail.com" als Host Domain hinzufügen:

 C_OBJECT($option)

 var $option : Object

 

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

 

 WP EXPORT VARIABLE(myArea;$path;wk mime html;$option)

Beispiel 2

Ein E-Mail mit formatiertem Text, 4D Referenzen und Bildern senden. Dazu verwenden Sie einen 4D Write Pro Bereich, exportiert im Format MIME und gesendet über SMTP:

  // den Transporter erstellen

 $server:=New object

 $server.host:="smtp.gmail.com"

 $server.port:=465

 $server.user:="4D@gmail.com"

 $server.password:="XXXX"

 

 $transporter:=SMTP New transporter($server)

 

 WP EXPORT VARIABLE(WParea;$mime;wk mime html)

 

 $mailTmp:=MAIL Convert from MIME($mime)

 

  // Bilder hinzufügen (falls vorhanden)

 If($mailTmp.attachments#Null)

    $email.attachments:=$mailTmp.attachments

 End if

 

 $email.bodyStructure:=$mailTmp.bodyStructure

 $email.bodyValues:=$mailTmp.bodyValues

 

 $status:=$transporter.send($email)

 If(Not($status.success))

    ALERT("An error occurred: "+$status.statusText)

 End if

Siehe auch

Import und Export im Format .docx
WP EXPORT DOCUMENT