サポート > Wagby定義ファイル > 15 帳票 > プレースホルダ
テンプレートファイルに記述するプレースホルダの書式、ルール、表記例を説明します。（Wagby R6.0.1 より Excel 帳票におけるプレースホルダ指定で、日付型項目の値をシリアル値に変換するオプション指定が用意されました。） R6.0.1
プレースホルダの書式
帳票のテンプレートファイルは Excel を用いて自由に作成できます。 ここで、Excel のセル中に特別な表記である「プレースホルダ」を用意すると、その項目に、実際のデータが格納されます。
プレースホルダの書式は次のとおりです。
${プレゼンテーションモデル名.英語項目名}
Wagbyでは、詳細表示用のモデルを内部で「プレゼンテーションモデル」と呼びます。詳細表示用テンプレートファイルでは、モデル名に「_p」を付記して区別します。同様に、一覧表示用テンプレートファイルでは、モデル名に「_lp」を付記します。
プレースホルダの具体例
ここでは「顧客（customer）」というモデルの「氏名（customername）」という項目を例にとります。
詳細帳票におけるプレースホルダ表記を用意するには、まずモデル名の末尾に「_p」を付加します。これに「.」を付与し、英語の項目名をその後につけます。最後に、この文字列の先頭に”${”を、末尾に”}”を付加します。
すなわち、この例では「${customer_p.customername}」となります。 テンプレートファイル中にこの表記を埋め込んだ部分が、データベースに含まれる顧客氏名データに置き換わります。
プレースホルダのルール
ここでは、プレースホルダに関するいくつかのルールについて説明します。
- (1) プレースホルダ名は半角英数字で入力する。
- 全角文字でプレースホルダを指定しても正しく置換されません。ただし1セル内にプレースホルダとそれ以外の通常の文字を混在させることはできます。このような場合はプレースホルダのみを置換し、他の文字列はそのまま残します。
- (2) 該当するデータが存在しない場合は「空白」文字に置換される。
- プレースホルダに該当する項目の値がデータに格納されていない場合、プレースホルダは空白文字に置換されます。
- (3) 権限設定を行った項目は、帳票でも（同設定が）有効となる。
- 項目毎に権限設定を行った場合、帳票でも有効となります。例えばある項目に隠し権限を設定した場合、帳票でも出力されません。（プレースホルダは空白文字に置換されます。）
- (4) 一つの項目についてのプレースホルダを複数、異なる場所に記述することもできる。
- 例を示します。${customer_p.customername} というプレースホルダをシート中に「複数」記述した場合、すべてのプレースホルダが置換されます。
- (5) プレースホルダは（Excelファイルの）1 シート目のみに適用される。
- プレースホルダが適用されるのは 1 シート目のみです。2 シート目以降はプレースホルダが適用されません。 このルールを使って、複雑なレイアウトを作成する方法も用意しています。
表記一覧
各データ型やデータの種類におけるプレースホルダの表記方法を示します。
