WP EXPORT DOCUMENT

La commande WP EXPORT DOCUMENT exporte l'objet 4D Write Pro wpDoc vers un document sur disque selon le paramètre filePath ou fileObj ainsi que tout paramètre optionnel.

Dans wpDoc, passez l'objet 4D Write Pro que vous souhaitez exporter.

Vous pouvez passer soit un filePath ou fileObj :

• Dans filePath, passez le chemin de destination et le nom du document à exporter. Si vous ne passez que le nom du document, il sera sauvegardé au même niveau que le fichier de structure 4D.

• Dans le paramètre fileObj, passez un objet 4D.File représentant le fichier à exporter.

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

Notes :

• "Balises spécifiques 4D" signifie XHTML 4D avec un espace de noms 4D et des styles CSS 4D.
• Pour plus d'informations sur le format du document 4D Write Pro, reportez-vous à .4wp document format.
• Pour consulter la liste des différences ou des incompatibilités connues lors de l'utilisation du format .docx, voir Importation et exportation au format .docx.
• Pour plus d'informations sur l'exportation au format SVG, voir Exportation au format SVG.

Paramètre option​

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

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

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

Collection wk files​

La propriété wk files vous permet d'exporter un PDF avec des pièces jointes. Cette propriété doit contenir une collection d'objets décrivant les fichiers à incorporer dans le document final. Chaque objet de la collection peut contenir les propriétés suivantes :

Si le paramètre option contient également une propriété wk factur x, le premier élément de la collection wk files doit être le fichier xml de la facture Factur-X (ZUGFeRD) (voir ci-dessous).

Objet wk factur x​

La propriété wk factur x est un objet qui peut contenir jusqu'à deux propriétés :

À propos des documents PDF Factur-X / ZUGFeRD​

Factur-X / ZUGFeRD est une norme européenne pour les factures électroniques hybrides (PDF pour les utilisateurs et données XML pour l'automatisation des processus). Pour plus d'informations, veuillez lire cet article de blog.

Pour déclencher une exportation PDF "Factur-X", passez les propriétés wk factur x et wk files dans le paramètre option (voir exemple 5). Dans ce cas :

• un PDF Factur-X (ZUGFeRD) est généré,
• le premier élément de la collection wk files est utilisé comme fichier xml Factur-X,
• si la propriété wk files est manquante ou contient une collection vide, ou si son premier élément n'est pas un fichier xml, une erreur est générée.

Exemple 1​

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

 // exporter HTML
 var $option : Object
 $option:=New object

 $option[wk recompute formulas]:=False
 $option[wk HTML pretty print]:=False
 $option[wk optimized for]:=wk print
 $option[wk max picture DPI]:=600 //remplacer la valeur par défaut pour l'impression (300 DPI)

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

 //exporter PDF
 var $option : Object
 $option:=New object

 $option[wk visible headers]:=True
 $option[wk visible footers]:=True
 $option[wk visible background]:=True
 $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]:=True

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

Exemple 2​

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

 var $path : Text

 Case of
 :(Form event code=On Clicked)

 $path:=Get 4D folder(Database folder)+"Export"+Folder separator
 $path:=Select document($path;".4wp";" title";File name entry)

 If($path#"")
 WP EXPORT DOCUMENT(myArea;document;wk 4wp)
 End if
 End case

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)

Exemple 4​

Exportation d'un document PDF conforme à la norme PDF/A-2 :

 var $options: Object:={}
 $options[wk visible empty images] :=False
 $options[wk pdfa version]:=wk pdfa2 // conformité "PDF/A-2"
 WP EXPORT DOCUMENT(wpDoc;"invoice.pdf";wk pdf;$options)

Exemple 5​

Exemples d'exportations PDF de Factur-X :

 //BASIC (profil standard)
 var $options;$fileInfo : Object
 $options:={}
 $options[wk factur x]:={}
 $options[wk factur x].profile:="BASIC"
 $options[wk factur x].version:="1.0"

 $fileInfo:={}
 $fileInfo.file:=$file //$file est un 4D.File avec un fichier .xml comme cible
 $options[wk files]:=[$fileInfo]

 WP EXPORT DOCUMENT(wpDoc;"facturX_basic.pdf";wk pdf;$options)

 //Profil RECHNUNG (profil personnalisé)
 $options:={}
 $options[wk factur x]:={}
 $options[wk factur x].profile:="RECHNUNG"
 $options[wk factur x].version:="2.1" //dernière version pour RECHNUNG

 $fileInfo:={}
 $fileInfo.file:=$file //$file est un 4D.File avec un fichier .xml comme cible
 $fileInfo.name:="rechnung.xml" //Nom de fichier obligatoire dans le PDF pour RECHNUNG
 $fileInfo.relationship:="Alternative" //obligatoire pour l'Allemagne
 $fileInfo.description:="ZUGFeRD Rechnung"
 $options[wk files]:=[$fileInfo]

 WP EXPORT DOCUMENT(wpDoc;"facturX_rechnung.pdf";wk pdf;$options)

Exemple 6​

Exportation d'un document docx en utilisant un objet File :

var $file : 4D.File

$file:=File("/DATA/test-export")

$options:=New object(wk visible background and anchored elements; False)

WP EXPORT DOCUMENT(WParea; $file; wk docx; $options)

Voir également​

4D QPDF (Component) - PDF Get attachments
Exporter aux formats HTML et MIME HTML
Importer et exporter au format .docx
Blog post - 4D Write Pro: Electronic invoice generation
Blog post - 4D Write Pro: Export to PDF with enclosures
WP EXPORT VARIABLE