動的フォーム・レイアウトのフィールドのグループ化

動的フォームのレイアウトを作成または編集するときに、フォームのフィールドをグループ化して、レイアウト内の単一のエンティティとしてまとめて表示できます。グループを非表示または表示にしたり、ページにレンダリングされたときに縮小または展開するように構成できます。

たとえば、名前、住所、市区町村、州、国および郵便番号の各フィールドを含む住所グループを作成できます。グループを表示するタイミングを制御する条件をグループに適用できます。また、グループを使用すると、複数のフィールドを個別に追加するのではなく、1つのステップで異なるレイアウトに簡単に追加できます。

グループのプロパティ(グループ・ラベル、グループが折りたたまれてレンダリングされる場合など)およびグループ内の個々のフィールド(複雑な動的フォーム・レイアウトを作成するためのフィールドの列スパンを指定する場合など)を定義できます。

動的フォーム・レイアウトのフィールドをグループ化するには:

操作する動的フォームのルール「セット」タブを開きます。スタンドアロンの動的フォームまたは動的コンテナの一部である動的フォームを選択できます。

これを行うには、ナビゲータの「レイアウト」タブでレイアウトを選択し、(ここに示すように)「ルールセット」タブで動的フォームを検索します。キャンバス領域のレンダリングされたページでフォームをクリックするか、プロパティ・ペインでフォームを選択します。
「
図employee-ruleset-standalone.pngの説明」
編集するフォームを開きます。

現在のレイアウトを複製する場合は、ツールバーのアイコンを使用します。
レイアウト・ダイアグラムで、CMDキー(macOSの場合)またはCtrlキー(Windowsの場合)を押しながら、グループ化するフィールドを選択します。
プロパティ・ペインで「グループ・フィールド」をクリックするか、ツールバーでをクリックします。

図group-fields-create.pngの説明

選択したフィールドは、レイアウト図の新しいフォルダの下にグループ化されます。

図group-fields-name.pngの説明
新規グループの名前を入力します。をクリックして、グループ名を保存します。
(オプション)「プロパティ」ペインでグループのプロパティを設定します。
- 「常に」をクリックして、レイアウトにグループを表示するタイミングを決定する条件を設定します。デフォルト設定では、常にグループが表示されます。
- 「ラベル」プロパティを使用して、グループ化されたフィールドのフォームに表示されるラベルを設定します。
- 「方向」プロパティを使用して、グループ化されたフィールドのレイアウト方向を設定します。
- 「グループ縮小可能」プロパティを使用して、ページのレンダリング時にグループをデフォルトで縮小するか展開するかを指定します。「折りたたみ不可」を選択すると、グループを折りたたむことができません。オプションを選択しない場合のグループのデフォルトの動作は「縮小不可」です。
- 「ラベル・エッジ」プロパティを使用して、ラベルとコンポーネントの位置合せ方法を設定します。
- 「列スパン」プロパティを使用して、レイアウトでフィールドの列スパンを設定します。
- 「最大列数」プロパティを使用して、最大列数を設定します。

グループを作成した後も、フィールドのハンドルを使用して、フィールドをグループの内外にドラッグできます。

ノート:

「ラベル」プロパティに入力した文字列に翻訳バンドルを使用する場合は、現在、「プロパティ」ペインの「ラベル」フィールドに翻訳式を手動で入力し、レイアウトのjsonファイル(layout.json)を編集して、翻訳バンドルのインポート要素を追加する必要があります。たとえば、ラベルがアドレス・グループで、翻訳バンドルの名前がtest_bundleの場合は、「ラベル」フィールドに[[$dynLayout.translations.test_bundle.AddressGroup()]]を追加します。

group-fields-label-translate.pngの説明が続きます

図group-fields-label-translate.pngの説明

また、翻訳バンドルのインポートをjsonファイル(この例ではtest_bundle)に手動で追加する必要があります。

"imports": {
    "translations": {
      "self": [
        "test_bundle"
      ]
    }
  }

詳細は、「翻訳の使用」を参照してください。