WP EXPORT VARIABLE

4D v19

WP EXPORT VARIABLE


WP EXPORT VARIABLE ( wpDoc ; destination ; format {; option} )

引数	型	説明
wpDoc	オブジェクト	4D Write Pro変数
destination	テキスト変数, BLOB変数	書き出したコンテンツを受け取る変数
format	倍長整数	変数出力フォーマット
option	オブジェクト, 倍長整数	書き出しオプション

説明

WP EXPORT VARIABLE コマンドはwpDoc 変数内の4D Write Proオブジェクトをformat 引数で指定したフォーマットでdestination 引数で指定した4D変数へと書き出します。

wpDoc 引数には、書き出したい4D Write Proオブジェクトを渡します。

destination 引数には、書き出された4D Write Pro オブジェクトを受け取る変数を渡します。必要な変数の型は、format 引数で指定した書き出しフォーマットに応じて変化します:

ネイティブな.4wpフォーマットまたは.docx フォーマットを渡した場合、必要な変数はBLOB型になります。
HTMLフォーマットを渡した場合、必要な変数はテキスト型になります。

format 引数には、4D Write Pro テーマから、使用する書き出しフォーマットを設定する定数を渡します。それぞれのフォーマットは特定の用法と関連しています。サポートされているフォーマットは以下の通りです:

定数	型	値	コメント
wk 4wp	倍長整数	4	4D Write Proドキュメントは、ネイティブなアーカイブフォーマット(zipになったHTMLと、別のフォルダに保存された画像)にて保存されています。4D特有のタグも含まれ、4D式は計算はされていません。このフォーマットは、特に4D Write Proドキュメントをディスク上に損失なく保存してアーカイブする事に適しています。
wk docx	倍長整数	7	.docx 拡張子を意味します。4D Write Pro ドキュメントはMicrosoft Word フォーマットで保存されます。Microsoft Word 2016 以降に正式に対応していますが、.docx フォーマットをサポートするバージョン(例: Microsoft Word 2007など)であればどれであっても互換性はあります。書き出しに対応しているドキュメントの部分は以下の通りです: 本文 / ヘッダー / フッター / セクションページ / 印刷設定 (余白、背景色 / 背景画像、境界線、パディング、用紙サイズ / 用紙の向き) 画像 - インライン、アンカー、背景画像パターン(wk background image で定義されているもの) 互換性のある変数と式(ページ番号、ページ数、日付、時間、メタデータ)。互換性のない変数と式は評価されて、書き出しの前に値が固定化されます。ブックマーク一部の4D Write Pro 設定はMicrosoft Word では利用できないか、振る舞いが異なる可能性があることに注意してください。
wk mime html	倍長整数	1	4D Write Proドキュメントは標準のMIME HTMLとして保存され、htmlドキュメントと画像はMIMEパーツとして埋め込まれます(base64でエンコードされます)。式は計算され4D特有のタグは除去されます。このフォーマットはSMTP_QuickSend コマンドを使用してHTML Eメールを送信するのに特に適しています。
wk pdf	倍長整数	5	.pdf 拡張子。4D Write Pro ドキュメントはページニューモードに基づいてPDF フォーマットで保存されています。 PDF ドキュメントには以下のメタ情報が書き出されています: タイトル作者サブタイトルコンテンツ作成者注: 式は、ドキュメントが書き出されるときに自動的に値が計算されて固定化されます。メソッドへのリンクはサポートされていません。
wk web page html 4D	倍長整数	3	4D Write ProドキュメントはHTMLとして保存され、4D独自のタグを含みます。それぞれの式はノンブレークのスペースとして挿入されます。このフォーマットはロスレスであるため、テキストフィールドへの保存目的に適しています。

注:

"4D独自のタグ" とは4Dネームスペースと4D CSSスタイルを含めた4D XHTMLのことです。
4D Write Pro ドキュメントフォーマットについてのより詳細な情報については、.4wp ドキュメントフォーマットを参照して下さい。
.docx フォーマットを使用する際の、既に知られている差異や変換されない設定の一覧については、.docxフォーマットの読み込み/書き出しを参照して下さい。

option 引数

option 引数には、書き出されるドキュメントのプロパティを定義する値を格納しているオブジェクト型の引数を渡します。以下のプロパティが利用可能です:

定数	値	コメント
wk CID host domain name	cidHostDomain	CID ホストドメイン名: 生成されるCID URL に追加されるホストドメイン。'@' が区切り文字として含まれます。wk mime html フォーマットが使用されている際にのみ使用可能です。
wk HTML pretty print	htmlPrettyPrint	HTML コードは読みやすいようにフォーマットされます。
wk max picture DPI	maxPictureDPI	画像を適切な解像度にリサンプリング(縮小)するのに使用されます。Windows でのSVG 画像に対しては。ラスタライズに使用されます。デフォルト値: 300 (wk optimized for = wk print 時) 192 (wk optimized for = wk screen 時) 取り得る最大値: 1440
wk optimized for	optimizedFor	書き出されたドキュメントを、その目的に応じてどのように最適化するかを定義します。取り得る値: wk print (wk pdf のデフォルト値) ビットマップピクチャーは、wk max picture DPI で定義されたDPI あるいは300 (デフォルト値)を使用してダウンスケールされ、書き出しタイプとしてコーデックがサポートされない場合にはPNGに変換されます。ベクターピクチャーはwk max picture DPI で定義されたDPI または300 (Windows のみ)を使用してPNG へと変換されます。ピクチャーに複数のフォーマットが格納されている場合、印刷に最適なフォーマットが使用されます(例: .jpg の代わりに .tiff など) wk screen (wk web page complete および wk mime html のデフォルト値) ビットマップピクチャーは、wk max picture DPI で定義されたDPI あるいは192 (デフォルト値)を使用してダウンスケールされ、書き出しタイプとしてコーデックがサポートされない場合にはJPEG (不透明タイプ)またはPNG(透過画像)に変換されます。ベクターピクチャーはwk max picture DPI で定義されたDPI または192 (Windows のみ)を使用してPNG へと変換されます。ピクチャーに複数のフォーマットが格納されている場合、スクリーン用のフォーマットが使用されます。
wk recompute formulas	recomputeFormulas	書き出し時にフォーミュラを再計算するかどうかを定義します。取り得る値: true - デフォルト値。全てのフォーミュラは再計算されます。 false- フォーミュラを再計算しません。
wk visible background	visibleBackground	背景画像と背景色の両方を表示します(ページ、または埋め込みビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk visible footers	visibleFooters	フッターを表示します(ページビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk visible headers	visibleHeaders	ヘッダーを表示します(ページビューモードでのみ表示されるエフェクトです)。取りうる値: True/False
wk visible references	visibleReferences	ドキュメントに挿入されている4D 式を参照として表示します。取りうる値: True/False

以下の表はformat 引数の各フォーマットごとに利用可能なoption 引数のオプションをあらわしています:

	wk 4wp	wk docx	wk mime html	wk pdf	wk web page html 4D
wk CID host domain name	-	-		-	-
wk HTML pretty print	(デフォルト: false)	-	(デフォルト: False)	(デフォルト: False)	(デフォルト: False)
wk max picture DPI	-	常に300		(デフォルト: 300)	-
wk optimized for	-	always wk print	(デフォルト:wk screen)	always wk print	-
wk recompute formulas	-	(デフォルト: true)	(デフォルト: true)	(デフォルト: true)	-
wk visible background	-	常にtrue	常にtrue	(デフォルト: true)	-
wk visible footers	-	常にtrue	常にfalse	(デフォルト: true)	-
wk visible headers	-	常にtrue	常にfalse	(デフォルト: true)	-
wk visible references	-	-	-	(デフォルト: false)	-

互換性に関する注意: option 引数に倍長整数 型の値を渡すことは互換性の理由からサポートされていますが、オブジェクト型の引数を渡すことが推奨されています。

例題 1

myArea 4D Write Pro オブジェクトのコンテンツをMIME 形式で書き出し、ホストドメインとして"gmail.com" を追加したい場合を考えます:

 C_OBJECT($option)

 var $option Object: 

 

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

 

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

例題 2

スタイル付テキストと4D参照と画像を含んだEメールを送信したい場合を考えます。この場合、MIME HTMLフォーマットで書き出された4D Write Proエリアを、SMTP を使用して送信することができます:

  // transporter オブジェクトを作成

 $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)

 

  // ピクチャーを追加(あれば)

 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

参照

.docxフォーマットの読み込み/書き出し
 WP EXPORT DOCUMENT