フォームデータモデルの使用 use-form-data-model

バージョン
記事リンク
AEM as a Cloud Service
ここをクリックしてください
AEM 6.5
この記事

hero-image

AEM Forms のデータ統合機能により、各種のバックエンドデータソースを使用してフォームデータモデルを作成できます。作成したデータフォームは、様々なアダプティブフォームとインタラクティブ通信のワークフローで、スキーマとして使用できます。そのためには、データソースの設定を行い、そのデータソース内の有効なデータモデルオブジェクトとデータモデルサービスに基づいて、フォームデータモデルを作成する必要があります。詳しくは、以下のトピックを参照してください。

JSON スキーマの拡張機能であるフォームデータモデルを使用して、以下の処理を行うことができます。

アダプティブフォームとアダプティブフォームフラグメントを作成する create-af

フォームデータモデルに基づいて、アダプティブフォームアダプティブフォームフラグメントを作成できます。フォームデータモデルを使用してアダプティブフォームまたはアダプティブフォームフラグメントを作成するには、以下の手順を実行します。

  1. プロパティを追加画面の「フォームモデル」タブで、 次から選択 ドロップダウンリストから「フォームデータモデル」を選択します。

    create-af-1-1

  2. 選択して展開 フォームデータモデルを選択. 使用可能なすべてのフォームデータモデルがリストされます。

    フォームデータモデルを選択します。

    create-af-2-1

  3. アダプティブフォームフラグメントのみ)フォームデータモデル内の 1 つのデータモデルオブジェクトのみに基づいて、アダプティブフォームフラグメントを作成できます。フォームデータモデル定義 ​ドロップダウンを展開します。指定したフォームデータモデル内のすべてのデータモデルオブジェクトがリスト表示されます。リストからデータモデルオブジェクトを選択します。

    create-af-3

フォームデータモデルに基づいてアダプティブフォームまたはアダプティブフォームフラグメントを作成すると、アダプティブフォームエディターのコンテンツブラウザーの「データモデルオブジェクト」タブにフォームデータモデルオブジェクトが表示されます。

NOTE
アダプティブフォームフラグメントの場合は、オーサリング時に選択したデータモデルオブジェクトと、そのオブジェクトに関連付けられているデータモデルオブジェクトだけが、「データモデルオブジェクト」タブに表示されます。

data-model-objects-tab

データモデルオブジェクトをアダプティブフォームまたはアダプティブフォームフラグメントにドラッグアンドドロップすると、フォームフィールドを追加することができます。追加されたフォームフィールドには、メタデータのプロパティが保持され、データモデルオブジェクトのプロパティとの連結が保持されます。この連結により、フォームの送信時は、対応するデータソース内のフィールド値が更新され、フォームのレンダリング時は、対応するデータソース内のフィールドに値が取り込まれます。

インタラクティブ通信を作成 create-ic

フォームデータモデルに基づいて、インタラクティブ通信を作成できます。フォームデータモデルを使用して、設定済みデータソースのデータをインタラクティブ通信に事前に取り込むことができます。また、フォームデータモデルに基づいて、インタラクティブ通信の構築ブロック(テキスト、リストおよび条件のドキュメントフラグメントなど)を作成できます。

インタラクティブ通信またはドキュメントフラグメントを作成する際に、フォームデータモデルを選択できます。次の図は、インタラクティブ通信を作成ダイアログの「一般」タブを示しています。

create-ic

インタラクティブ通信を作成ダイアログの「一般」タブ

詳しくは、次を参照してください。

インタラクティブ通信の作成

インタラクティブ通信内のテキスト

インタラクティブ通信内の条件

リストフラグメント

サンプルデータを使用したプレビュー preview-ic

フォームデータモデルエディターでは、フォームデータモデル内のデータモデルオブジェクト用のサンプルデータを生成して編集できます。このデータを使用すると、インタラクティブ通信とアダプティブフォームをプレビューおよびテストできます。プレビュー前にサンプルデータを生成します。詳しくは、 フォームデータモデルの使用.

サンプルのフォームデータモデルのデータを使用してインタラクティブ通信をプレビューするには:

  1. AEM オーサーインスタンスで、フォーム/フォームとドキュメント ​に移動します。
  2. インタラクティブ通信を選択し、 プレビュー ツールバーで、 Web チャネル, 印刷チャネル ​または 両方のチャネル :インタラクティブ通信をプレビューします。
  3. プレビューで [チャネル] ダイアログで、次の点を確認します。 フォームデータモデルのテストデータ を選択し、「 プレビュー.

サンプルデータが取り込まれた状態のインタラクティブ通信が表示されます。

web-preview

同様に、サンプルデータを含むアダプティブフォームをプレビューするには、アダプティブフォームをオーサリングモードで開き、「 」を選択します。 プレビュー.

フォームデータモデルサービスを使用したデータの事前入力 prefill

AEM Forms には、すぐに使用できるフォームデータモデル事前入力サービスが用意されています。フォームデータモデルに基づいて、このサービスをアダプティブフォームおよびインタラクティブ通信で使用することができます。この事前入力サービスは、アダプティブフォームおよびインタラクティブ通信内のデータモデルオブジェクトに対してデータソースのクエリを実行し、フォームまたは通信のレンダリング時にデータを事前入力します。

アダプティブフォームに対してフォームデータモデル事前入力サービスを有効にするには、アダプティブフォームコンテナのプロパティを開き、基本アコーディオンの​ 事前入力サービス ​ドロップダウンで「フォームデータモデル事前入力サービス」を選択します。次に、各プロパティを保存します。

prefill-service

インタラクティブ通信でフォームデータモデル事前入力サービスを設定するには、インタラクティブ通信の作成時に「事前入力サービス」ドロップダウンで「フォームデータモデル事前入力サービス」を選択します。後でプロパティを編集することもできます。

edit-ic-props

インタラクティブ通信のプロパティ編集ダイアログ

送信されたアダプティブフォームデータのデータソースへの書き込み write-af

ユーザーがフォームデータモデルに基づいてフォームを送信するとき、データモデルオブジェクトの送信データがそのデータソースに書き込まれるようにフォームを設定することができます。この設定を行うために、AEM Forms には、すぐに使用できるフォームデータモデル送信アクションが用意されています。これは、フォームデータモデルをベースとするアダプティブフォーム専用のアクションです。これにより、データモデルオブジェクトに送信されたデータが、そのデータソースに書き込まれます。

フォームデータモデル送信アクションを設定するには、アダプティブフォームコンテナのプロパティを開き、送信アコーディオンの「送信アクション」ドロップダウンで「フォームデータモデルを使用して送信」を選択します。次に、 送信するデータモデルオブジェクトの名前 ドロップダウンで、目的のデータモデルオブジェクトを探して選択します。各プロパティを保存します。

フォームを送信すると、設定されているデータモデルオブジェクトのデータが、各データソースに書き込まれます。

data-submission

バイナリデータモデルオブジェクトのプロパティを使用して、フォームの添付ファイルをデータソースに送信することもできます。添付ファイルを JDBC データソースに送信するには、次の手順を実行します。

  1. バイナリプロパティを含むデータモデルオブジェクトをフォームデータモデルに追加します。

  2. アダプティブフォームで、「添付ファイル」コンポーネントをコンポーネントブラウザーからアダプティブフォームにドラッグ&ドロップします。

  3. 「 」を選択して追加したコンポーネントを選択し、「 」を選択します。 settings_icon をクリックして、コンポーネントのプロパティブラウザーを開きます。

  4. 「バインド参照」フィールドで、「 foldersearch_18 フォームデータモデルに追加したバイナリプロパティに移動して選択します。 必要に応じて、他のプロパティを設定します。

    選択 check-button をクリックしてプロパティを保存します。 これで、添付ファイルフィールドがフォームデータモデルのバイナリプロパティにバインドされます。

  5. アダプティブフォームコンテナプロパティの「送信」セクションで、「フォームの添付ファイルを送信」を有効にします。これで、フォーム送信時に、バイナリプロパティフィールド内の添付ファイルがデータソースに送信されます。

ルールを使用したアダプティブフォーム内のサービスの呼び出し invoke-services

フォームデータモデルに基づくアダプティブフォームの場合、ルールを作成して、フォームデータモデル内で設定されているサービスを呼び出すことができます。ルール内の「サービスを起動」操作を実行すると、フォームデータモデル内のすべての有効なサービスが一覧表示され、サービスの入力フィールドと出力フィールドを選択できます。「指定値」というルールタイプを使用してフォームデータモデルサービスを呼び出し、そのサービスから返された出力に対するフィールドの値を設定することもできます。

例えば以下のルールの場合、従業員 ID を入力として使用する Get サービスが呼び出され、このサービスから返された値が、フォーム内の対応する扶養家族 ID フィールド、姓フィールド、名フィールド、性別フィールドに設定されます。

invoke-service

また、guidelib.dataIntegrationUtils.executeOperation API を使用して、ルールエディターのコードエディターで JavaScript を記述することもできます。API について詳しくは、「フォームデータモデルサービスを呼び出すための API」を参照してください。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2