4D Write Pro ドキュメントには、変数やフィールドに加え、式やプロジェクトメソッド、4D コマンドなどの動的な4Dフォーミュラへの参照を含めることができます。ページ番号などの特定の変数も参照することができます(以下の式の挿入 を参照してください)。

フォーミュラはWP INSERT FORMULA コマンドを使用することで4D Write Pro エリアに挿入することができ、WP Get formulas コマンドを使用して読み出しもできますが、WP Get text コマンドを使用することでも返されます。

フォーミュラは以下のタイミングで評価されます:

• 計算された値を表示するフォームオブジェクト内に挿入されたとき
• 計算された値を表示するフォームオブジェクト内に4D Write Pro オブジェクトが読み込まれたとき
• WP COMPUTE FORMULAS コマンドが呼び出された時
• WP FREEZE FORMULAS コマンドを使用して値が"固定化"(計算)されたとき(ただし事前に計算されていない場合)
• 印刷の前(ただし事前に計算されていない場合)
• .docx 形式に書き出される前(ただしフォーミュラがMS Word フォーミュラにマップすることができない場合)
• 固定化、印刷、フォーミュラの計算、の標準アクションが呼び出された時。詳細は標準アクションを参照してください。

フォーミュラはドキュメントが(WP New、 WP INSERT DOCUMENT を使用して、あるいはwpArea:=[table]field などで)読み込まれたときでも、以下の場合には評価されません:

• ドキュメントが画面外にある場合
• ドキュメントが画面内に表示されているが、フォームオブジェクトが参照しか表示していない場合

フォーミュラはWP FREEZE FORMULAS コマンドを呼び出すと、静的な値になります(ただしページ番号とページ数は除く、以下参照)。

互換性に関する注意: ST INSERT EXPRESSION、ST Get expression、ST COMPUTE EXPRESSIONS、およびST FREEZE EXPRESSIONS コマンドを使用して式を管理するのは、廃止予定となっていますが、4D Write Pro の互換性のために引き続きサポートはされます。

4D Write Pro エリアの選択範囲を、変数の中身で置き換えたい場合を考えます:

WP INSERT FORMULA コマンドを使用することで、任意のドキュメントエリア(本文、ヘッダー、フッター)にドキュメント属性やページ属性に関連した特殊な式を挿入することができます。

(*) 重要: This.pageNumber および This.pageCount は4D Write Pro フォーミュラ内でのみ直接使用できます(formula.source の文字列内に入っていなければなりません)。フォーミュラが呼び出したメソッド内の4D ランゲージ内で使用されていた場合には、返される値は不正確なものになります。しかしながらこれらを、フォーミュラから直接呼び出されるメソッドに引数として渡すことはできます:

• この形なら使用可能: « formatNumber(This.pageNumber) »
• この形は使用不可能: « formatNumber » formatNumber メソッド内でThis.pageNumber を処理する

例えば、ページ番号をフッターエリアに挿入したい場合:

互換性に関する注意: 4D v18 R2 以前のバージョンからのドキュメント内にある既存の$wp_ 変数は、引き続きサポートされ、評価されます。

日付

Current date コマンド、日付変数、日付を返すメソッドがフォーミュラに挿入された場合、それはsystem date short フォーマットを使用して自動的にテキストへと変換されます。

時間

Current time コマンド、時間変数、時間を返すメソッドがフォーミュラに挿入された場合、それはString コマンドに入れてあげる必要があります。なぜなら、時間型はJSON ではサポートされていないからです。以下のフォーミュラの例を参考にして下さい:

4D Writ Pro ドキュメントの挿入されたテーブルおよびフィールド式は、データベースのバーチャルストラクチャー定義をサポートします。フォーミュラに公開されるバーチャルストラクチャーは、SET FIELD TITLES(...;*) および SET TABLE TITLES(...;*) コマンドを通して定義されます。

バーチャルストラクチャーが定義されている場合:

• 4D Write Pro ドキュメントが値ではなく参照を表示する場合、フィールドを格納する式への参照はバーチャルな名前を表示します。
• WP Get text は、expressions 引数にwk expressions as source オプションが設定されている場合、バーチャルストラクチャー名を返します。
• WP INSERT FORMULA は、バーチャルストラクチャーを無視し、常に実際のテーブル/フィールド名を受け付けます。

注: ドキュメントが"式を表示"モードで表示されているとき、バーチャルストラクチャーに属していないテーブルまたはフィールドへの参照は"?"文字付きで表示されます。例えばあるフィールドがバーチャルストラクチャー内で定義されていなければ、 [VirtualTableName]? と表示されます。

ドキュメント内でフォーミュラがどのように表示されるかは以下のようにコントロールすることができます:

デフォルトでは、4D フォーミュラは値 として表示されます。4D フォーミュラを挿入すると、4D Write Pro は計算をしてカレントの値を表示します。どのフォーミュラが表示されているのか知りたい場合には、これを参照 として表示する必要があります。

フォーミュラを参照として表示するためには、以下の方法があります:

• プロパティリスト内の参照として表示オプションをチェックする(ビュープロパティの設定参照)
• visibleReferences 標準アクションを使用する(動的な式参照)
• WP SET VIEW PROPERTIES コマンドを、wk visible references セレクターをTrue にして使用する

フォーミュラが参照 として表示されている場合、ドキュメント内にはフォーミュラのソーステキストが表示され、デフォルトでは灰色の背景色がつけられます(これはwk formula highlight セレクターを使用することでカスタマイズ可能です)

例えば、カレントの日付をフォーマット付きで挿入した場合、その日付が表示されます:

フォーミュラを参照として表示した場合、そのフォーミュラのソースが表示されます:

When formula source texts are displayed in a document, the design could be confusing if you work on sophisticated templates using tables for example, and when formulas are complex:

フォーミュラのソーステキストがドキュメント内に表示されている場合、例えば表を使用したような込み入ったテンプレートで作業していてかつフォーミュラが複雑だった場合、デザインが分かりづらくなってしまううことがあります:

フォーミュラには名前を割り当てることができ、これによって4D Write Pro テンプレートドキュメントをエンドユーザーがより読みやすく理解しやすいようにすることができます。フォーミュラが参照として表示されている場合(そして記号として表示されていない場合)で、フォーミュラに対して名前を定義している場合、フォーミュラ名が表示されます。

例えば、以下のフォーミュラ参照はデフォルトではソーステキストとして表示されます:

フォーミュラ名を割り当てた場合、テキストではなく名前が表示されます:

フォーミュラに名前を割り当てるためには、 WP INSERT FORMULA コマンドにオブジェクト型 の引数を渡す必要があります。例:

注意: 名前をつけられるのはインラインフォーミュラのみです(アンカーされた画像、ブレーク行などに対するフォーミュラ、表データソースフォーミュラには名前をつけることはできません)。

フォーミュラの表示モードに関わらず、フォーミュラ上をマウスでホバーした時に表示されるtips でフォーミュラに関する追加の情報を得ることができます。