プレースホルダ前へ12345678910...次へテンプレートファイルに記述するプレースホルダの書式、ルール、表記例を説明します。プレースホルダの書式テンプレートファイル内に「プレースホルダ」を用意することができます。その項目に、実際のデータが格納されます。プレースホルダの書式は次のとおりです。詳細表示用テンプレートファイルでは、モデル名に「_p」を付記して区別します。一覧表示用テンプレートファイルでは、モデル名に「_lp」を付記します。${モデル名_p.英語項目名}プレースホルダの具体例ここでは「顧客(customer)」というモデルの「氏名(customername)」という項目を例にとります。プレースホルダ表記は、まずモデル名の末尾に「_p」を付加します。これに「.」を付与し、英語の項目名をその後につけます。最後に、この文字列の先頭に”${”を、末尾に”}”を付加します。この例では「${customer_p.customername}」となります。テンプレートファイル中にこの表記を埋め込んだ部分が、データベースに含まれる顧客氏名データに置き換わります。プレースホルダのルールプレースホルダに関するいくつかのルールについて説明します。プレースホルダ名は半角英数字で入力する。全角文字でプレースホルダを指定しても正しく置換されません。該当するデータが存在しない場合は「空白」文字に置換される。プレースホルダに該当する項目の値がデータに格納されていない場合、プレースホルダは空白文字に置換されます。権限設定を行った項目は、帳票でも(同設定が)有効となる。項目毎に権限設定を行った場合、帳票でも有効となります。ある項目に隠し権限を設定した場合、帳票でも出力されません。(プレースホルダは空白文字に置換されます。一つの項目についてのプレースホルダを複数、異なる場所に記述することもできる。いうプレースホルダを複数個記述した場合、すべてのプレースホルダが置換されます。シート目のみに適用される。シート目以降はプレースホルダが適用されません。このルールを使って、複雑なレイアウトを作成することもできます。プレースホルダとそれ以外の文字は混在できる。プレースホルダとそれ以外の通常の文字を混在させることができます。プレースホルダのみが置換され、他の文字列はそのまま維持されます。「顧客名は${customer_p.customername}です。終わるもの)について、各データ型やデータの種類におけるプレースホルダの表記方法を示します。文字列型/数値型/日付型モデル中の項目の値が転記されます。表記${モデル名_p.項目名}例${customer_p.name}数値型(出力フォーマット)数値型項目は標準で、出力フォーマットは適用されません。表記${fmt:モデル名_p.項目名}例${fmt:sale_p.uriage}日付型(シリアル値)日付型項目は標準で、出力フォーマットが適用されます。シリアル値として出力するオプションを用意しています。表記${e:モデル名_p.項目名}例${e:customer_p.date}シリアル値を使うと、Excel帳票のテンプレートファイルで、(Excelが提供する)任意の日付書式を設定できます。参照先モデルの「内容部」が転記されます。付与すると、参照先モデルの「ID部」が転記されます。(一覧表示には未対応です。添字に対応した繰り返し項目の値が転記されます。添字は「0」から開始されます。表記${モデル名_p.項目名.添字}例${customer_p.email.0}繰り返しコンテナ(固定長)添字に対応したコンテナの項目の値が転記されます。添字は「0」から開始されます。詳細は"繰り返し項目の固定長指定"をお読みください。表記${モデル名_p.コンテナ名.添字.項目名}例${customer_p.report.0.rid}繰り返しコンテナ(可変長)出力する数に応じて帳票イメージが伸縮します。詳細は"繰り返し項目の可変長指定"をお読みください。一行にまとめて記述します。(複数行にまたがって記述することはできません。参照先モデルのデータ値が転記されます。項目を参照していない項目についても、次の方法で参照先モデルの任意の項目のデータを転記することができます。参照先モデルが外部キー連携している場合の子モデルのデータ値が転記されます。外部キー連携している場合の子モデル内の繰り返しコンテナのデータ値が転記されます。参照先モデルが外部キー連携している場合の子モデル内の繰り返しコンテナのデータ値が転記されます。表記${自モデル名_p.項目名.参照先モデル名_p->参照先モデルの子モデル名.添字.参照先モデルの子モデル名_p.コンテナ名.添字.項目名}例${management_p.name.customer_p->support.0.support_p.report.0.supportdate}画像(ファイル型)ファイル型項目は次のように扱うことができます。繰り返しコンテナ(可変長)ファイルのパスupload_dirフォルダからの相対パスとなります。繰り返しコンテナ(可変長)画像セルに画像を埋め込みます。対応しているフォーマットはjpeg,pngです。画像を埋め込むセルの範囲を指定することができます。