基本的に帳票フォームファイルフィールド名と、そこに割り当てる値のマッピングという形式で構成されます。
左辺が帳票フォームファイル上のフィールド名で、右辺が値の指定となります。
値の指定方法にはいくつか種類がありますので、以下で順に説明します。
[データモデル内の項目の値を指定する場合]
印刷対象データとして渡されたデータモデル内の項目を指定する場合には以下のようにします。
形式：
{field
{帳票フィールド名} {session_value宣言で指定されたデータモデルのキー名}.{データモデル内の業務項目名}
}
例：session_value宣言で指定されたデータモデル内の項目を指定
{field
郵便番号 印刷対象データ.郵便番号
住所 印刷対象データ.住所
氏名 印刷対象データ.氏名
}
[データモデル内の明細リストの値を指定する場合]
この場合は一覧表示する箇所の印刷データを指定する形になりますので、その一覧部分のフィールドのまとまりを
サブセクションを設けてグルーピングし、その中でフィールド名と明細部分の項目をマッピングする形になります。
ここで指定するサブセクション名は任意の名称になります。特に帳票フォームファイルとリンクしていません。
フィールドのまとまりを表すわかりやすい名前をつけてください。ただしその帳票内では重複しない名称にしてください。
明細の階層は任意です。明細の明細がある場合は重ねて指定します。
形式：
{field
{任意のサブセクション名
{帳票フィールド名} {session_value宣言で指定されたデータモデルのキー名}.{明細を表す項目名1}.{明細を表す項目名N}.{明細内の業務項目名}
}
}
例：session_value宣言で指定されたデータモデル内の顧客リストの項目を展開
{field
{顧客一覧
郵便番号 印刷対象データ.顧客リスト.郵便番号
住所 印刷対象データ.顧客リスト.住所
氏名 印刷対象データ.顧客リスト.氏名
}
}
[データモデル内の項目にパス式を適用して指定する場合]
データモデルにマスタなどを指すProxy項目が含まれている場合は、パス式を適用してその先の名称などを引くことが出来ます。
形式：
{field
{帳票フィールド名} {session_value宣言で指定されたデータモデルのキー名}.{データモデル内の業務項目名}/{現象型パス式}
}
例：session_value宣言で指定されたデータモデル内の商品在庫リストの項目を商品Noから展開
{field
{商品一覧
商品コード 印刷対象データ.在庫リスト.商品No/商品コード
商品名 印刷対象データ.在庫リスト.商品No/商品名称
在庫数 印刷対象データ.在庫リスト.在庫数
}
}
[日付のフォーマット指定]
値の型がjava.util.Dateの場合、印刷した際の日付文字列フォーマットを指定することが出来ます。
日付フォーマットはフィールド名の後ろにアンダースコア("_")を２つ続けた後に指定します。
形式:
{field
{帳票フィールド名}__{日付フォーマット文字列} {session_value宣言で指定されたデータモデルのキー名}.{データモデル内の業務項目名}
}
例:yyyy/MM/ddの形式で支払日というフィールドに値をマッピングする
{field
支払日__yyyy/MM/dd 印刷対象データ.日付
}
[ヘルパクラスの指定]
データモデルから取得した値オブジェクトをフィールドに表示するための文字列に変換するヘルパクラスを指定することが出来ます。
ヘルパクラス名およびそれに対するパラメータををフィールド名の後ろにアンダースコア("_")を２つ続けてエクスクラメーション("!")をつけた後に指定します。
ここで指定したクラスについての情報は後述のhelper_class情報セクションで記述します。
形式:
{field
{帳票フィールド名}__!{値変換のヘルパクラス名}(パラメータ) {session_value宣言で指定されたデータモデルのキー名}.{データモデル内の業務項目名}
}
例:
{field
住所１__!imeg.server.util.print.helper.TestFormatHelper(testx,texty) 印刷対象データ.住所
}
