帳票テンプレートは、複数のテンプレートフィールドで構成されますが、データを連結しセルを展開する際にお互いに依存し合います。
例えば、以下の画像では、「team」と「name」の2つのデータフィールドが帳票テンプレートに定義されており、順番としては「team」が前、「name」が後になります。この場合、「name」は「team」に依存し、データ連結の際に「team」に基づいて値がグループ化およびフィルタリングされます。また、「name」の展開方向も「team」によって決定されます。つまり、「team」のテンプレートセルは「name」のコンテキストセルということになります。
コンテキスト関係
帳票テンプレートにてテンプレートフィールドが複数定義されている場合、それらの間に「コンテキスト」関係と呼ばれる関係が確立されます。前にあるテンプレートセルは、後のテンプレートセルのコンテキストセルとなります。この関係に基づいて、データを連結しセルを展開する際に、データをグループ化およびフィルタリングします。
コンテキスト関係には2種類あります。
- フィルタ関係：テンプレートセルに連結されるデータは、コンテキストセルのデータをフィルタ条件としてフィルタリングされます。例えば、以下の画像では、「name」のデータは、そのコンテキストセルである「team」のデータに対応してフィルタリングされています。
- フォロー関係：テンプレートセルに連結されるデータは、コンテキストセルのデータの展開方向に従って展開、グループ化されます。例えば、以下の画像では、「name」のデータは、そのコンテキストセルである「team」に対応してグループ化され、横方向に展開されています。
Context プロパティ
セルのコンテキストは Context（省略形：C）プロパティで設定します。テンプレートセルに連結されるデータは、そのコンテキストに応じて縦方向や横方向に展開されます。セルのコンテキストは、以下のとおりに設定できます。
- Context プロパティに None を設定 (C= None)：セルのコンテキストがない場合に指定します。
- Context プロパティに 独自の値を設定：セルのコンテキストを明示的に指定します。
-
Context プロパティを定義しない（デフォルト）：Context プロパティを定義しない場合、デフォルトのコンテキストセルは、展開方向が縦（E=V）の場合は左側の隣接するセル、展開方向が横（E=H）の場合は上側の隣接するセルになります。
例えば、以下の画像では、セル「A1」がセル「B1」のコンテキストセルであり、縦方向に展開されます。
また、以下の例では、セル「A1」がセル「A2」のコンテキストセルであり、横方向に展開されます。
コンテキストの優先順位
テンプレートセルに適用されるコンテキストの優先順位は、以下のとおりに決定されます。
明示的なコンテキスト > デフォルトコンテキスト > フォールバックコンテキスト
- 明示的なコンテキスト：テンプレートセル内の Context プロパティで設定されたコンテキストです。
- デフォルトコンテキスト：テンプレートセル内に Context プロパティが定義されていない場合、デフォルトコンテキストが優先されます。
- フォールバックコンテキスト： 左側または上側に隣接するセルに値がない場合、そのセルの位置を含む Range（省略形：R）プロパティを持つテンプレートセルを探し、それをコンテキストとして使用します。
フォールバックコンテキストは、デフォルトの場合や明示的なコンテキストが定義されていない場合、テンプレートセルに Range プロパティを定義することで設定できます。Range プロパティを定義したテンプレートセルは、他のセルが展開するためのコンテキストとして使用されます。
例えば、以下の帳票テンプレートは、商品名ごとの売上明細を出力するために作成されており、商品名ごとにデータを展開する必要があります。すべてのテンプレートフィールドにコンテキストを追加するかわりに、商品名「Name」に {{ds.Name(R=B11:F16)}} のように Range プロパティを定義して、売上明細を商品名ごとに展開しグループ化するよう設定できます。
上記の帳票テンプレートから、以下のような Excel 帳票を生成できます。
