サブフォームセットの使用

サブフォームセットは、複数の繰り返しサブフォームまたは複数ページのサブフォームをグループ化したものです。

サブフォームセットは、セット内のサブフォームがレンダリングされる順序を、セット内にサブフォームを表示する順序に基づいて制御する場合に使用します。

例えば、サンプルの発注書フォームを見ると、detailHeader および detail サブフォームが 1 つのサブフォームセットにグループ化されているのがわかります。サブフォームセットには 2 つのサブフォームが共に保存されています。したがって各データアイテムについて両方のサブフォームがレンダリングされ、detail サブフォームに対応したデータが存在しない場合はどちらのサブフォームもレンダリングされません。

サブフォームを 1 つのサブフォームセットにグループ化すると、サブフォームのレンダリング用データが存在しない場合、セット内のサブフォームはレンダリングされないことに注意してください。

セット内のサブフォームがレンダリングされる順序を制御するには、オブジェクトパレットの「サブフォームセット」タブにある種類リストから、次のいずれかのオプションを選択します。

  • すべてのサブフォームを順番に使用

    最終文書には、サブフォームセット内のすべてのサブフォームが階層パレットに表示される順序で表示されます。

  • 候補からサブフォームを 1 つ選択する

    最終文書には、セットにあるサブフォームの 1 つが表示されます。詳しくは、選択サブフォームセットの使用を参照してください。

サブフォームのレンダリング方法を選択するときは、次の事項に注意してください。

  • サブフォームを最小値 0 に設定した場合、サブフォーム内のデータがなければ、サブフォームはレンダリングされません。

  • サブフォームをデータ内の実際のオカレンス数よりも小さい最小値に設定した場合、残りのデータ値は表示されません。逆に、サブフォームをデータ内の実際のオカレンス数よりも大きい最大値に設定すると、指定された数のサブフォームがレンダリングされます。サブフォーム内の一部のオブジェクトはデータなしでレンダリングされ、空白で表示されることになります。

  • サブフォームセットは、必要に応じて、別のサブフォームセット内に任意のレベル数まで階層化できます。ただし、線、円、テキストフィールドオブジェクトなどの個々のオブジェクトはサブフォームセット内に配置できません。

サブフォームセットを挿入するには

サブフォームセットは、まとめておいた方が都合のよい複数のサブフォームをグループ化したものです。サブフォームセットは、サブフォームをまとめ、レンダリングの順序を制御する場合に使用できます。

サブフォームセットを作成する前に、「サブフォーム」タブの種類リストから正しいオプションを選択できるよう、フォームをレンダリングする順序を考えておくことをお勧めします。

  1. 階層パレットを右クリックしてから、「サブフォームセットの挿入」を選択します。名称未設定のサブフォームセットが階層パレットに追加されます。

  2. 階層パレットで、連結するサブフォームをサブフォームセットにドラッグします。

  3. 階層パレットでサブフォームセットを選択した状態で、オブジェクトパレットの「サブフォームセット」タブをクリックし、種類リストから必要なオプションを選択します。

  4. 「連結」タブをクリックします。オプションで、「名前」ボックスにサブフォームセットの名前を入力することもできます。

  5. 提供されたデータに応じてサブフォームセットを繰り返す場合は、「各データアイテムについてサブフォームセットを繰り返す」を選択してから、必要に応じて最小値および最大値を指定します。

  6. フォームデザインをプレビューしてサブフォームセットをテストします。