WP EXPORT VARIABLE

Home

4D v20 R7

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 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 svg	Lange Ganzzahl	8	Die 4D Write Pro Dokumentseite wird im SVG-Format gespeichert, basierend auf dem Seitenansichtsmodus. Hinweis: Beim Export in das SVG-Format können Sie immer nur eine Seite exportieren. Verwenden Sie das wk page index, um die zu exportierende Seite anzugeben.
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
Wenn Sie mit diesem Befehl in das SVG-Format exportieren, werden die Bilder im base64-Format eingebettet.
Weitere Informationen zum Export in das SVG-Format finden Sie unter Exporting to SVG format.

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 embedded pictures	embeddedPictures	Nur für SVG-Export. Legt fest, ob Bilder in die exportierte .svg-Datei eingebettet werden, wenn Sie WP EXPORT DOCUMENT aufrufen. Verfügbare Werte: true (Standard): Bilder werden in die exportierte .svg-Datei eingebettet falsch: Die Bilder werden in einen Ordner namens "filename_images" auf der Ebene der exportierten .svg-Datei exportiert, wobei "filename" der Name ist, der dem Befehl für die Datei übergeben wurde, ohne die Erweiterung. Die Bilder werden nicht eingebettet, sondern in der .svg-Datei referenziert. Beachten Sie das: Wenn der Ordner bereits existiert, wird er geleert, bevor die Datei exportiert wird. Wenn sich auf der exportierten Seite kein Bild befindet, wird der Ordner gelöscht.
wk factur x	facturX	Nur für den PDF-Export. Wert: Objekt zur Konfiguration eines "Factur-X (ZUGFeRD)" PDF-Exports (siehe wk factur x objekt).
wk files	files	Nur für den PDF-Export. Wert: Collection von Objekten, von denen jedes eine Datei beschreibt, die in das endgültige Dokument eingebettet wird (siehe wk files collection). Diese Funktion wird nur in PDF/A-3-Dokumenten unterstützt: Wenn das Attribut wk files verwendet wird, wird automatisch die "PDF/A-3"-Version gesetzt (das Attribut wk pdfa version wird ignoriert). Im Falle eines Factur-X PDF-Exports (siehe unten) muss das erste Objekt der Collection die Factur-X xml-Datei enthalten.
wk google fonts tag	googleFontsTag	Nur für SVG-Export. Legt die Importregel für Google-Schriften im exportierten SVG fest. Mögliche Werte: false (Standard): Es wird keine Google-Fonts-Importregel hinzugefügt. wahr: Fügt die @import-Regel zur exportierten Datei hinzu. Nützlich, wenn Sie Schriftarten verwenden möchten, die unter Windows oder macOS nicht standardmäßig verfügbar sind. Hinweis: Diese Eigenschaft ist standardmäßig auf "false" gesetzt, da Google-Schriften, wenn sie aktiviert sind, die nativen Schriftarten überschreiben und native Schriftarten im Allgemeinen besser im Browser dargestellt werden.
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. Hinweis: Dokumente, die im Format wk docx exportiert werden, sind immer für wk print optimiert (die Option wk optimized for wird ignoriert).
wk page index	pageIndex	Nur für SVG-Export. Index der Seite, die in das SVG-Format exportiert werden soll (Standard ist 1). Der Seitenindex beginnt bei 1 für die erste Seite des Dokuments. Hinweis: Der Seitenindex ist unabhängig von der Seitennummerierung.
wk pdfa version	pdfaVersion	Exportiert PDF mit Konformität zu einer PDF/A-Version. Weitere Informationen zu den PDF/A-Eigenschaften und -Versionen finden Sie auf der PDF/A-Seite auf Wikipedia. Mögliche Werte: wk pdfa2: Exportiert nach Version "PDF/A-2" wk pdfa3: Exportiert nach Version "PDF/A-3" Hinweis: Unter macOS kann wk pdfa2 nach PDF/A-2 oder PDF/A-3 oder höher exportieren, je nach Plattformimplementierung. Außerdem bedeutet wk pdfa3 "exportiert mindestens nach PDF/A-3". Unter Windows wird die PDF-Ausgabedatei immer der gewünschten Konformität entsprechen.
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 and anchored elements	visibleBackground	Zeigt Hintergrundbilder und Hintergrundfarbe an (sichtbarer Effekt nur im Modus Seite und Eingebunden). Mögliche Werte: True/False
wk visible empty images	visibleEmptyImages	Zeigt ein schwarzes Standardrechteck für Bilder an, die nicht geladen oder berechnet werden können (leere Bilder oder Bilder in einem nicht unterstützten Format). Mögliche Werte: Wahr/Falsch. Standardwert: True Wenn der Wert False ist, werden fehlende Bildelemente nicht angezeigt, auch wenn sie Rahmen, Breite, Höhe oder Hintergrund haben; dies kann sich auf das Seitenlayout für Inline-Bilder auswirken.
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 svg
wk CID host domain name	-	-		-	-
wk HTML pretty print	(Standard: falsch)	-	(Standard: falsch)	(Standard: falsch)	(Standard: falsch)	(Standard: falsch)
wk max picture DPI	-	immer 300		(Standard: 300)	-	(Standard: 300)
wk optimized for	-	immer wk print	(Standard: wk screen)	immer wk print	-	(Standard:wk print)
wk recompute formulas	-	(Standard: wahr)	(Standard: wahr)	(Standard: wahr)	-	(Standard: wahr)
wk visible background and anchored elements	-	(Standard: wahr)	immer wahr	(Standard: wahr)	-	(Standard: wahr)
wk visible footers	-	immer wahr	immer falsch	(Standard: wahr)	-	(Standard: wahr)
wk visible headers	-	immer wahr	immer falsch	(Standard: wahr)	-	(Standard: wahr)
wk visible empty images	-	(Standard: wahr)	(Standard: wahr)	(Standard: wahr)	-	(Standard: wahr)
wk visible references	-	-	-	(Standard: wahr)	-	(Standard: falsch)
wk pdfa version	-	-	-		-	-
wk factur x	-	-	-		-	-
wk files	-	-	-		-	-
wk page index	-	-	-	-	(Standard: 1)	(Standard: 1)
wk embedded pictures	-	-	-	-	(Standard: wahr)	(Standard: wahr)
wk google fonts tag	-	-	-	-	(Standard: falsch)	(Standard: falsch)

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:

 var $option;$export : Objet

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

 WP EXPORT VARIABLE(myArea;$export;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

Beispiel 3

So exportieren Sie die erste Seite eines 4D Write Pro als SVG in eine Textvariable und blenden die Kopfteile aus:

 var $options : Object

 var $destination : Text

 

 $options:=New object

 $options[wk optimized for]:=wk screen

 $options[wk visible headers]:=False

 WP EXPORT VARIABLE(WPArea;$destination;wk svg;$options)

Siehe auch

4D QPDF (Component) - PDF Get attachments
Blog post - 4D Write Pro: Electronic invoice generation
Blog post - 4D Write Pro: Export to PDF with enclosures
Exportieren in die Formate HTML und MIME HTML
Import und Export im Format .docx
WP EXPORT DOCUMENT