VP EXPORT DOCUMENT

Home

4D v19

VP EXPORT DOCUMENT


VP EXPORT DOCUMENT ( vpAreaName ; DateiPfad {; paramObj} )

Parameter	Typ	Beschreibung
vpAreaName	Text	Name des Formularobjekts 4D View Pro Area
DateiPfad	Text	Pfadname des Dokuments
paramObj	Objekt	Exportoptionen

Beschreibung

Der Befehl VP EXPORT DOCUMENT exportiert das 4D View Pro Objekt, das im 4D View Pro Bereich vpAreaName übergeben ist, gemäß den Parametern DateiPfad und paramObj in ein Dokument auf der Festplatte.

In vpAreaName übergeben Sie den Namen des 4D View Pro Bereichs im 4D Formular. Übergeben Sie einen Namen, der nicht existiert, wird ein Fehler zurückgegeben.

In DateiPfad übergeben Sie den Zielpfad und -namen des Dokuments zum Exportieren. Sie können die Endung für das Format an den Dokumentnamen anhängen: 4D View Pro (".4VP") oder Microsoft Excel (".xlsx"). Übergeben Sie nur den Dokumentnamen, wird er mit der standardmäßigen Endung .4VP auf derselben Ebene wie die 4D Strukturdatei gespeichert.

Mit dem optionalen Parameter paramObj können Sie mehrere Eigenschaften für das exportierte 4D View Pro Objekt definieren und eine Callback-Methode starten, wenn der Export abgeschlossen ist.

Eigenschaften

Typ

Beschreibung

format

Text

Gibt, falls vorhanden, das Format der exportierten Datei an: ".4vp" (Standard), ".xlsx" oder ".pdf". Im Parameter Format können Sie eine Konstante unter dem Thema 4D View Pro Konstanten übergeben. In diesem Fall fügt 4D bei Bedarf die passende Endung an den Dateinamen an

Folgende Formate werden unterstützt:

Konstante	Wert	Kommentar
vk 4D View Pro format	.4VP	4D View Pro Format (Standardformat)
vk MS Excel format	.xlsx	Microsoft Excel Format
vk pdf format	.pdf	PDF Format

Entspricht das übergebene Format nicht der Endung in DateiPfad, wird sie an das Ende von DateiPfad angefügt. Sind in DateiPfad weder ein Format noch eine Endung angegeben, wird das standardmäßige Dateiformat verwendet.

password

Text

Nur Microsoft Excel (optional) Kennwort zum Schützen des MS Excel Dokuments

formula

Objekt

Name der Callback-Methode, die nach abgeschlossenem Export gestartet wird. Sie ist bei asynchronem Export erforderlich (das ist bei PDF und Excel Formaten der Fall), wenn bestimmter Code nach dem Export ausgeführt werden muss. Die Callback-Methode muss den Befehl Formula verwenden. Weitere Informationen siehe unten.

valuesOnly

Boolean

Gibt an, dass nur die Werte von Formeln (sofern vorhanden) exportiert werden.

includeFormatInfo

Boolean

Wahr zum Integrieren von Formatangaben (Standardeinstellung), sonst Falsch. Formatangaben sind in einigen Fällen hilfreich, z.B. für den Export in SVG. Andererseits verringert sich die Exportdauer, wenn diese Eigenschaft auf Falsch gesetzt ist.

sheetIndex

Zahl

nur PDF (optional) - Index der Arbeitsblätter zum Exportieren (startet bei 0). -2=alle sichtbaren Arbeitsblätter (Standard), -1=nur aktuelles Arbeitsblatt

pdfOptions

Objekt

nur PDF (optional) - Optionen für den pdf Export

Eigenschaft	Typ	Beschreibung
creator	text	Name der Anwendung, die das Originaldokument erstellt hat, von dem aus konvertiert.
title	text	Titel des Dokuments
author	text	Name des Verfassers
keywords	text	Dem Dokument zugewiesene Schlüsselwörter
subject	text	Betreff des Dokuments

any

Jede eigene Eigenschaft, die in der Callback Methode über den Parameter $3 verfügbar ist.

Hinweis zum Excel Format: Beim Export eines 4D View Pro Dokuments in eine in Microsoft Excel formatierte Datei können ein paar Einstellungen verlorengehen. Beispielsweise werden 4D Methoden und Formeln nicht von Excel unterstützt. Weitere Einstellungen können Sie mit dieser Liste von GrapeCity überprüfen.
Hinweis zum PDF Format: Beim Export eines 4D View Pro Dokuments in PDF werden die im Dokument verwendeten Schriften automatisch in die PDF Datei eingebunden. Es lassen sich nur OpenType Schriften (.OTF oder .TTF Dateien) mit einer Unicode-Map einbinden. Wird für eine Schriftart keine gültige Schriftdatei gefunden, wird stattdessen eine Standardschrift verwendet.

Ist die Export Operation beendet, löst VP EXPORT DOCUMENT automatisch die Ausführung der Callback-Methode aus, sofern sie in paramObj übergeben ist.

Callback-Methode übergeben (Formula)

Mit dem optionalen Parameter paramObj lässt VP EXPORT DOCUMENT den Befehl Formula zum Aufrufen einer 4D Methode zu, die nach dem abgeschlossenen Export ausgeführt wird. Die Callback-Methode empfängt folgende Werte in lokalen Variablen:

Variable		Typ	Beschreibung
$1		Text	Name des 4D View Pro Objekts
$2		Text	Dateipfad des exportierten 4D View Pro Objekts
$3		Objekt	Referenz zum Parameter paramObj des Befehls
$4		Objekt	Von der Methode zurückgegebenes Objekt mit einer Statusmeldung
	.success	Boolean	Wahr, wenn Export erfolgreich, sonst Falsch
	.errorCode	Ganzzahl	Fehlercode. Kann von 4D oder JavaScript zurückgegeben werden.
	.errorMessage	Text	Fehlermeldung. Kann von 4D oder JavaScript zurückgegeben werden.

Beispiel 1

Den Inhalt des Bereichs "VPArea" in ein 4D View Pro Dokument auf der Festplatte exportieren:

 C_TEXT($docPath)

 

 $docPath:="C:\\Bases\\ViewProDocs\\MyExport.4VP"

 VP EXPORT DOCUMENT("VPArea";$docPath)

  //MyExport.4VP wird auf Ihrer Festplatte gesichert

Beispiel 2

Das aktuelle Arbeitsblatt in PDF exportieren:

 C_OBJECT($params)

 $params:=New object

 $params.format:=vk pdf format

 $params.sheetIndex:=-1

 $params.pdfOptions:=New object("title";"Annual Report";"author";Current user)

 VP EXPORT DOCUMENT("VPArea";"report.pdf";$params)

Beispiel 3

Ein 4D View Pro Dokument in ".xlsx" Format exportieren und eine Methode aufrufen, die Microsoft Excel mit dem geöffneten Dokument startet, wenn der Export abgeschlossen ist:

 $params:=New object

 $params.formula:=Formula(AfterExport)

 $params.format:=vk MS Excel format //".xlsx"

 $params.valuesOnly:=True

 

 VP EXPORT DOCUMENT("ViewProArea";"c:\\tmp\\convertedfile";$params)

Methode AfterExport:

 C_TEXT($1;$2)

 C_OBJECT($3;$4)

 $areaName:=$1

 $filePath:=$2

 $params:=$3

 $status:=$4

 

 If($status.success=False)

    ALERT($status.errorMessage)

 Else

    LAUNCH EXTERNAL PROCESS("C:\\Program Files\\Microsoft Office\\Office15\\excel "+$filePath)

 End if

Siehe auch

VP Convert to picture
VP Export to object
VP IMPORT DOCUMENT
VP PRINT