WP EXPORT DOCUMENT
WP EXPORT DOCUMENT ( wpDoc ; filePath {; format {; option}} )
WP EXPORT DOCUMENT ( wpDoc ; fileObj {; format {; option}} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| wpDoc | Object | → | 4D Write Pro 変数 |
| filePath | Text | → | 書き出されるファイルのパス |
| fileObj | 4D.File | → | 書き出すファイルオブジェクト |
| format | Integer | → | ドキュメント出力フォーマット(例: .docx、.pdf、など) |
| option | Object, Integer | → | 書き出しオプション、選択したフォーマットによって異なる |
説明
WP EXPORT DOCUMENT コマンドは wpDoc 引数で指定した4D Write Pro オブジェクトをfilePath あるいは fileObj 引数および他のオプションの引数に基づいて、ディスク上のドキュメントへと書き出します。
wpDoc 引数には、書き出したい4D Write Pro オブジェクトを渡します。
filePath あるいは fileObj のいずれかを渡すことができます:
-
filePath には、書き出されるドキュメントの保存先パスと名前とを渡します。 filePath には、書き出されるドキュメントの保存先パスと名前とを渡します。 filePath には、書き出されるドキュメントの保存先パスと名前とを渡します。 ドキュメント名のみを渡した場合、ドキュメントは4D ストラクチャーファイルと同じ階層に保存されます。
-
fileObj 引数には、書き出されるファイルを表す4D.File オブジェクトを渡します。
format 引数は省略可能ですが、省略した場合にはfilePath 引数で拡張子を指定する必要があります。 format 引数は省略可能ですが、省略した場合にはfilePath 引数で拡張子を指定する必要があります。 format 引数は省略可能ですが、省略した場合にはfilePath 引数で拡張子を指定する必要があります。 format 引数には、4D Write Pro 定数 テーマの定数を渡すこともできます。 この場合、4D は必要に応じて適切な拡張子をファイル名に追加します。 以下のフォーマットがサポートされています: この場合、4D は必要に応じて適切な拡張子をファイル名に追加します。 以下のフォーマットがサポートされています: この場合、4D は必要に応じて適切な拡張子をファイル名に追加します。 以下のフォーマットがサポートされています:
| 定数 | 値 | 説明 |
|---|---|---|
| wk 4wp | 4 | 4D Write Pro ドキュメントはネイティブなアーカイブフォーマット(圧縮されたHTML で画像は別個のフォルダに保存)で保存されます。 4D 特有のタグは含まれ、4D 式は計算されません。 このフォーマットは特にロスなく4D Write Pro ドキュメントをディスク上に保存するのに適しています。 4D 特有のタグは含まれ、4D 式は計算されません。 4D Write Pro ドキュメントはネイティブなアーカイブフォーマット(圧縮されたHTML で画像は別個のフォルダに保存)で保存されます。 4D 特有のタグは含まれ、4D 式は計算されません。 このフォーマットは特にロスなく4D Write Pro ドキュメントをディスク上に保存するのに適しています。 4D 特有のタグは含まれ、4D 式は計算されません。 このフォーマットは特にロスなく4D Write Pro ドキュメントをディスク上に保存するのに適しています。 |
| wk docx | 7 | .docx 拡張子を意味します。 4D Write Pro ドキュメントはMicrosoft Word フォーマットで保存されます。 Microsoft Word 2010 以降に正式に対応しています。 書き出しに対応しているドキュメントの部分は以下の通りです:: 本文 / ヘッダー / フッター / セクション / ページ / 印刷設定 (余白、背景色 / 背景画像、境界線、パディング、用紙サイズ / 用紙の向き) 画像 - インライン、アンカー、背景画像パターン(wk background image で定義されているもの) 互換性のある変数と式(ページ番号、ページ数、日付、時間、メタデータ)。 互換性のない変数と式は評価されて、書き出しの前に値が固定化されます。 リンク - ブックマーク URL 一部の4D Write Pro 設定はMicrosoft Word では利用できないか、振る舞いが異なる可能性があることに注意してください。 |
| wk mime html | 1 | 4D Write Proドキュメントは標準のMIME HTMLとして保存され、htmlドキュメントと画像はMIMEパーツとして埋め込まれます(base64でエンコードされます)。 式は計算され4D特有のタグやメソッドのリンクは除去されます。 埋め込みビューにアンカーされたテキストボックスのみが(divとして)書き出されます。 このフォーマットは コマンドを使用してHTML Eメールを送信するのに特に適しています。 式は計算され4D特有のタグやメソッドのリンクは除去されます。 埋め込みビューにアンカーされたテキストボックスのみが(divとして)書き出されます。 このフォーマットは コマンドを使用してHTML Eメールを送信するのに特に適しています。 |
| wk pdf | 5 | .pdf 拡張子。 .pdf 拡張子。 4D Write Pro ドキュメントはページビューモードに基づいてPDF フォーマットで保存されています。 PDF ドキュメントには以下のメタ情報が書き出されています: タイトル 作者 タイトル コンテンツ作成者 注意: 式は、ドキュメントが書き出されるときに自動的に値が計算されて固定化されます。メソッドへのリンクはサポートされていません。 PDF ドキュメントには以下のメタ情報が書き出されています: タイトル 作者 タイトル コンテンツ作成者 注意: 式は、ドキュメントが書き出されるときに自動的に値が計算されて固定化されます。メソッドへのリンクはサポートされていません。 |
| wk svg | 8 | 4D Write Pro ドキュメントのページはページビューモードに基づいてSVG フォマットで保存されます。 注意: SVG へと書き出す際は、一度に1ページしか書き出すことができません。 書き出すページを指定するにはwk page index を使用して下さい。 注意: SVG へと書き出す際は、一度に1ページしか書き出すことができません。 書き出すページを指定するにはwk page index を使用して下さい。 注意: SVG へと書き出す際は、一度に1ページしか書き出すことができません。 書き出すページを指定するにはwk page index を使用して下さい。 |
| wk web page complete | 2 | .htm または .html 拡張子。 このドキュメントは標準HTMLとして保存され、そのリソースは別に保存されます。 4Dタグは除去され、式は値が計算されます。 埋め込みビューにアンカーされたテキストボックスのみが(divとして)書き出されます。 このフォーマットは特に4D Write Pro ドキュメントWeb ブラウザで表示したい場合に特に適しています。 |
注:
- "4D 特有のタグ"とは、4Dネームスペースと4D CSSスタイルを含めた4D XHTMLのことです。
- For more information about the 4D Write Pro document format, refer to .4wp document format.
- To view a list of known differences or incompatibility when using the .docx format, see Importing and Exporting in .docx format.
- For more information on exporting to SVG format, see Exporting to SVG format.
option 引数
option 引数には、書き出されるドキュメントのプロパティを定義する値を格納しているオブジェクト を渡します。 次のプロパティを利用することができます: 次のプロパティを利用することができます: 次のプロパティを利用することができます:
| 定数 | 値 | 説明 |
|---|---|---|
| wk CID host domain name | cidHostDomain | CID ホストドメイン名: 生成されるCID URL に追加されるホストドメイン。'@' が区切り文字として含まれます。 wk mime html フォーマットが使用されている際にのみ使用可能です。 Available only when the wk mime html format is used. |
| wk embedded pictures | embeddedPictures | SVG 書き出し専用。 WP EXPORT DOCUMENT を呼び出した時、ピクチャーが書き出された.svg ファイル内に埋め込まれるかどうかを設定します。 Available values: |
| wk factur x | facturX | PDF 書き出しのみ。 Value: object configuring a "Factur-X (ZUGFeRD)" PDF export (see wk factur x object). |
| wk files | files | PDF 書き出しのみ。 Value: collection of objects, each of them describing a file to be embedded in the final document (see wk files collection). This feature is only supported in PDF/A-3 documents: when the wk files attribute is used, the "PDF/A-3" version is automatically set (the wk pdfa version attribute is ignored). Factur-X PDF 書き出し(下記参照)の場合、コレクションの最初のオブジェクトにはFactur-X XML ファイルが格納されている必要があります。 |
| wk google fonts tag | googleFontsTag | SVG書き出し専用。 SVG書き出し専用。 SVG書き出し専用。 書き出されたSVG 内でのGoogle フォントの読み込みルールを設定します。 取り得る値: false (デフォルト): Google フォントの読み込みルールは何も追加されません。 true: 書き出されたファイルに@import ルールを追加します。 Windows またはmacOS において利用できないフォントを使用したい場合に有用です。 注意: このプロパティはデフォルトではFalse に設定されています。なぜなら読み込まれたGoogle フォントはネイティブのフォントを上書きしますが、一般的にはネイティブのフォントはブラウザ上で綺麗にレンダリングされるからです。 取り得る値: false (デフォルト): Google フォントの読み込みルールは何も追加されません。 true: 書き出されたファイルに@import ルールを追加します。 Windows またはmacOS において利用できないフォントを使用したい場合に有用です。 注意: このプロパティはデフォルトではFalse に設定されています。なぜなら読み込まれたGoogle フォントはネイティブのフォントを上書きしますが、一般的にはネイティブのフォントはブラウザ上で綺麗にレンダリングされるからです。 Possible values: |
| wk HTML pretty print | htmlPrettyPrint | HTML コードは読みやすいようにフォーマットされます。 |
| wk max picture DPI | maxPictureDPI | 画像を適切な解像度にリサンプリング(縮小)するのに使用されます。 Windows でのSVG 画像に対しては。ラスタライズに使用されます。 デフォルト値: 300 (for wk optimized for = wk print 時) 192 (for wk optimized for = wk screen 時) 取り得る最大値: 1440 |
| wk optimized for | optimizedFor | 書き出されたドキュメントを、その目的に応じてどのように最適化するかを定義します。 Possible values:wk print (default value for wk pdf and wk svg) Bitmap pictures may be downscaled using the DPI defined by wk max picture DPI or 300 (default value) and may be converted to PNG if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by wk max picture DPI or 300 (Windows only). If a picture contains more than one format, the best format for printing is used (e.g., .tiff instead or .jpg)wk screen (default value for wk web page complete and wk mime html). Bitmap pictures may be downscaled using the DPI defined by wk max picture DPI or 192 (default value) and may be converted to JPEG (opaque images) or PNG (transparent images) if codec is not supported for the export type. Vectorial pictures are converted to PNG using the DPI defined by wk max picture DPI or 192 (Windows only). If a picture contains more than one format, the format for screen rendering is used.wk docx format are always optimized for wk print (wk optimized for option is ignored). |
| wk page index | pageIndex | SVG書き出し専用。 SVG書き出し専用。 SVG フォーマットへと書き出すページのインデックス(デフォルトは1)。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 注意: ページインデックスはページナンバリングとは異なるものです。 ページのインデックスは1から始まり、これはドキュメントの最初のページを指します。 注意: ページインデックスはページナンバリングとは異なるものです。 |
| wk pdfa version | pdfaVersion | PDF/A バージョンに適合したPDF を書き出します。 PDF/A のプロパティおよびバージョンの詳細については、Wikipedia のPDF/A のページ を参照してください。 Possible values: wk pdfa2: Exports to version "PDF/A-2"wk pdfa3: Exports to version "PDF/A-3"wk pdfa2 may export to PDF/A-2 or PDF/A-3 or higher, depending on platform implementation. Also, wk pdfa3 means "exports to at least PDF/A-3". Windows 上では、出力されたPDF ファイルは常に指定されたバージョンと同じになります。 |
| wk recompute formulas | recomputeFormulas | 書き出し時にフォーミュラを再計算するかどうかを定義します。 Possible values: |
| wk visible background and anchored elements | visibleBackground | 背景画像/背景色、アンカーされた画像またはテキストボックス(ディスプレイ用では、ページビューモードまたは埋め込みビューモードでのみ表示されるエフェクト)を表示または書き出しをします。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False |
| wk visible empty images | visibleEmptyImages | 読み込めない、あるいは計算できない画像(空の画像またはサポートされていないフォーマットの画像)に対してデフォルトの黒い四角形を表示または書き出しします。 取り得る値: True/False. 取り得る値: True/False. デフォルト値: True 値がFalse の場合、たとえ画像に境界線、幅、高さ、背景などが設定されてあっても空の画像要素は全く表示されないという点に注意して下さい。これはインライン画像のページレイアウトに影響する可能性があります。 |
| wk visible footers | visibleFooters | フッターを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False |
| wk visible headers | visibleHeaders | ヘッダーを表示または書き出しします(表示用においてはページビューモードでのみ表示されるエフェクトです)。 取り得る値: True/False 取り得る値: True/False 取り得る値: True/False |
| wk visible references | visibleReferences | ドキュメントに挿入されている4D 式を参照として表示または書き出しします。 取り得る値: True/False |
| wk whitespace | whitespace | Sets the "white-space" css value for wk mime html and wk web page complete export formats. The white-space css style is applied to paragraphs. Possible values: "normal", "nowrap", "pre", "pre-wrap" (default), "pre-line", "break-spaces". |
以下の表はformat 引数の各フォーマットごとに利用可能なoption 引数のオプションをあらわしています:
| wk 4wp | wk docx | wk mime html | wk pdf | wk web page complete | wk svg | |
|---|---|---|---|---|---|---|
| wk CID host domain name | - | - |  | - | - | - |
| wk embedded pictures | - | - | - | - | - | (デフォルト: true) |
| wk factur x | - | - | - | | - | - |
| wk files | - | - | - | | - | - |
| wk google fonts tag | - | - | - | - | - | (デフォルト: false) |
| wk HTML pretty print | (デフォルト: false) | - | (デフォルト: False) | (デフォルト: False) | (デフォルト: False) | (デフォルト: false) |
| wk max picture DPI | - | 常に300 | | (デフォルト: 300) | - | (デフォルト: 300) |
| wk optimized for | - | always wk print | (デフォルト: wk screen) | always wk print | - | (デフォルト: wk print) |
| wk page index | - | - | - | - | - | (デフォルト: 1) |
| wk pdfa version | - | - | - | | - | - |
| wk recompute formulas | - | (デフォルト: true) | (デフォルト: true) | (デフォルト: true) | - | (デフォルト: true) |
| wk visible background and anchored elements | - | (デフォルト: true) | 常にtrue | (デフォルト: true) | - | (デフォルト: true) |
| wk visible empty images | - | (デフォルト: true) | (デフォルト: true) | (デフォルト: true) | - | (デフォルト: true) |
| wk visible footers | - | 常にtrue | 常にfalse | (デフォルト: true) | - | (デフォルト: true) |
| wk visible headers | - | 常にtrue | 常にfalse | (デフォルト: true) | - | (デフォルト: true) |
| wk visible references | - | - | - | (デフォルト: false) | - | (デフォルト: false) |
| wk whitespace | - | - | (default: "pre-wrap") | - | (default: "pre-wrap") | - |
互換性に関する注意: option 引数に倍長整数 型の値を渡すことは互換性の理由からサポートされていますが、オブジェクト型 型の引数を渡すことが推奨されています。
wk files コレクション
wk files プロパティを使用すると、PDF に添付つきで書き出すことができます。 このプロパティには、最終ドキュメントに埋め込まれるファイルを記述するオブジェクトのコレクションを格納する必要があります。 コレクション内のそれぞれのオブジェクトは以下のプロパティを格納することができます: このプロパティには、最終ドキュメントに埋め込まれるファイルを記述するオブジェクトのコレクションを格納する必要があります。 コレクション内のそれぞれのオブジェクトは以下のプロパティを格納することができます: このプロパティには、最終ドキュメントに埋め込まれるファイルを記述するオブジェクトのコレクションを格納する必要があります。 コレクション内のそれぞれのオブジェクトは以下のプロパティを格納することができます:
| プロパティ | 型 | Description |
|---|---|---|
| name | Text | ファイル名。 file プロパティが使用されている場合には、デフォルトでは名前はファイル名が使用されるので、オプションとなります(必須ではありません)。 ファイル名。 file プロパティが使用されている場合には、デフォルトでは名前はファイル名が使用されるので、オプションとなります(必須ではありません)。 ファイル名。 file プロパティが使用されている場合には、デフォルトでは名前はファイル名が使用されるので、オプションとなります(必須ではありません)。 data プロパティが使用されている場合には必須(ただしFactur-X 書き出しの場合の最初のファイルを除く、この場合にはファイル名は自動的に"factur-x.xml" となっているため。詳細は以下参照) |
| description | Text | 任意。 オプション。 オプション。 省略時、Factur-X への最初の書き出しファイルのデフォルトの値は"Factur-X/ZUGFeRD Invoice" となり、それ以外の場合は空となります。 |
| mimeType | Text | 任意。 オプション。 任意。 任意。 任意。 任意。 If omitted, default value can usually be guessed from file extension; otherwise, "application/octet-stream" is used. 渡された場合、必ずISO mime タイプを使用するようにしてください。そうでない場合、書き出されたファイルは無効である場合があります。 |
| data | Text または Blob | file プロパティがない場合には必須。 |
| file | 4D.File オブジェクト | data プロパティがない場合には必須。それ以外の場合には使用されません。 |
| relationship | Text | 任意。 オプション。 任意。 任意。 任意。 任意。 If omitted, default value is "Data". オプション。 省略時、デフォルトの値は"Data" となります。 Factur-X の最初のファイルの取りうる値: BASIC、EN 16931 または EXTENDED プロファイルの場合: "Alternative"、"Source"または "Data" ("Alternative" はドイツの請求書にのみ使用されます)MINIMUM および BASIC WL プロファイルの場合: "Data" のみ。その他のプロファイルの場合: "Alternative"、"Source" または "Data" (国によって制約がある場合あり:他のプロファイルについての詳細な情報についてはプロファイルの指示書を参照してください。例えば、RECHNUNG プロファイルの場合は"Alternative" のみ使用可能です)その他の(ただしFactur-X invoice xml ファイルを除く)ファイルの場合 : "Alternative"、"Source"、"Data"、"Supplement" または "Unspecified"それ以外の値はエラーを生成します。 |
option 引数にも wk factur x プロパティが含まれている場合、 wk files コレクションの最初の要素はFactur-X (ZUGFeRD) invoice xml ファイルである必要があります(以下参照)。
注
PDF 添付はPDF/A-3 バージョンでのみサポートされています。 wk files プロパティを渡す場合、"PDF/A-3" バージョンが自動的に使用されます。
wk factur x オブジェクト
wk factur x プロパティは、2つまでのプロパティを格納することのできるオブジェクトです:
| プロパティ | 型 | Description |
|---|---|---|
| profile | Text | 任意。 オプション。 任意。 任意。 任意。 任意。 If omitted, profile is determined from the provided xml file or text (which must use a standard profile). 渡された場合には、標準のプロファイル名以外の名前でも構いません(他のプロファイル、例えばRECHNUNG などを使用することも可能)。 注意: 標準のプロファイル名は以下のとおりです: MINIMUM、BASIC WL、BASIC、EN 16931 (別名 COMFORT でありこれはエイリアス)、EXTENDED |
| version | Text | 任意。 オプション。 オプション。 デフォルト値は"1.0" |
About Factur-X / ZUGFeRD PDF documents
Factur-X / ZUGFeRD はハイブリッドな電子請求書のための欧州の規格です(PDFはユーザー用、XML データは処理の自動化用)。 詳細な情報については こちらのblog記事 を参照してください。 詳細な情報については こちらのblog記事 を参照してください。 詳細な情報については こちらのblog記事 を参照してください。
"Factur-X" PDF 書き出しをトリガーするためには、option 引数に wk factur x および wk files プロパティの両方を渡してください(以下の例題5参照)。 この場合: この場合: この場合において:
- Factur-X (ZUGFeRD) PDF が生成されます。
- wk files コレクションの最初の要素がFactur-X xml ファイルとして使用されます。
- wk files プロパティがない場合またはコレクションが空である場合、または最初の要素がxml ファイルでない亜場合、エラーが生成されます。
注
Factur-X / ZUGFeRD 書き出し実装についての詳細な例題については、こちらのHDI 4D project をダウンロードしてください。
例題 1
myArea 4D Write Pro オブジェクトのコンテンツをHTML 形式とPDF フォーマットの両方に書き出したい場合を考えます:
// 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 //印刷用のデフォルト値(300 DPI)を上書き
WP EXPORT DOCUMENT(myArea;$path;wk web page complete;$option)
// 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 //スクリーン用のデフォルト値(192 DPI) を上書きしてドキュメントのサイズを制限
$option[wk optimized for]:=wk screen
$option[wk recompute formulas]:=True
WP EXPORT DOCUMENT(myArea;$path;wk pdf;$option)
例題 2
myArea 4D Write Proオブジェクト内のコンテンツを、.4wpフォーマットで書き出したい場合を考えます:
var $path : Text
var $docRef : Integer
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
例題 3
ドキュメントの2ページ目をSVG として書き出し、ドキュメントからピクチャーを書き出したい場合を考えます:
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)
例題 4
PDF/A-2 準拠のPDF ドキュメントを書き出したい場合を考えます:
var $options: Object:={}
$options[wk visible empty images] :=False
$options[wk pdfa version]:=wk pdfa2 // "PDF/A-2" に準拠
WP EXPORT DOCUMENT(wpDoc;"invoice.pdf";wk pdf;$options)
例題 5
Factur-X PDF 書き出しをしたい場合を考えます:
//BASIC (標準のプロファイル)
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 は.xml ファイルをターゲットにした4D.File
$options[wk files]:=[$fileInfo]
WP EXPORT DOCUMENT(wpDoc;"facturX_basic.pdf";wk pdf;$options)
//RECHNUNG プロファイル(カスタムのプロファイル)
$options:={}
$options[wk factur x]:={}
$options[wk factur x].profile:="RECHNUNG"
$options[wk factur x].version:="2.1" //RECHNUNG の最後のバージョン
$fileInfo:={}
$fileInfo.file:=$file // この$file は.xml ファイルをターゲットにした4D.File
$fileInfo.name:="rechnung.xml" // RECHNUNG のPDFの場合に必須なファイル名
$fileInfo.relationship:="Alternative" //ドイツ用に必須
$fileInfo.description:="ZUGFeRD Rechnung"
$options[wk files]:=[$fileInfo]
WP EXPORT DOCUMENT(wpDoc;"facturX_rechnung.pdf";wk pdf;$options)
例題 6
File オブジェクトを使用してdocx ドキュメントを書き出す場合を考えます:
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)
参照
4D QPDF (Component) - PDF Get attachments
Exporting to HTML and MIME HTML formats
Importing and Exporting in .docx format
Blog post - 4D Write Pro: Electronic invoice generation
Blog post - 4D Write Pro: Export to PDF with enclosures
WP EXPORT VARIABLE