フォームとフォームデータモデル(FDM)の統合

FDM を使用してフォームをバックエンドデータソースに接続し、データ連結、検証、送信のワークフローを有効にします。

前提条件

FDM をフォームに統合する前に、次の手順を完了します。

  1. データソースを設定:バックエンド接続を設定します
  2. フォームデータモデルを作成:データ構造とサービスを定義します
  3. データモデルオブジェクトを設定:データ関係をマッピングします

考慮事項

ユニバーサルエディターインターフェイスの「データソース」アイコンや、右側のプロパティパネルの​ 連結参照 ​プロパティが表示されない場合は、Extension Manager で​ データソース ​拡張機能を有効にします。

フォーム統合に有効にできるデータソース拡張機能など、使用できる拡張機能を示すユニバーサルエディター Extension Manager インターフェイスのスクリーンショット

ユニバーサルエディターで拡張機能を有効または無効にする方法については、Extension Manager 機能のハイライトの記事を参照してください。

フォームタイプの選択

ユニバーサルエディターは、次の 2 つのフォーム作成アプローチをサポートします。

項目
スキーマベースのフォーム
スキーマベース以外のフォーム
設定の複雑さ
シンプル(自動連結)
手動(フィールド単位の連結)
ユースケース
データ構造が定義された新しいフォーム
既存のフォームまたは柔軟な要件
データソース
作成時に必須
後で追加可能
連結
自動フィールド連結
フィールドごとの手動連結

ユニバーサルエディターのフォームのタイプ {align="center" width="50%"}

スキーマベースのフォーム

スキーマベースのフォームでは、データソースを自動的に設定し、フォームフィールドをデータに連結します。このアプローチは、データ構造が明確に定義された新しいフォームに最適です。

スキーマベースのフォームの作成

  1. フォームコンソールにアクセス

    • Experience Manager Forms オーサーインスタンスにログインします
    • Adobe Experience ManagerFormsフォームとドキュメント ​に移動します
  2. フォーム作成を開始

    • 作成アダプティブフォーム ​を選択します
    • Edge Delivery Services テンプレートを選択します
    • 有効な場合は、「作成」をクリックします

    Edge Delivery Services テンプレート

  3. データモデルを設定

    • データ」タブに移動します
    • 複数のデータソースの場合は「フォームデータモデル(FDM)」を選択し、単一のバックエンドシステムの場合は「JSON スキーマ」を選択します
    • 作成した FDM(例:ペットのフォームデータモデル)を選択します

    フォームデータモデルを選択

  4. フォーム設定を完了

    • 名前 ​と​ タイトル ​を入力します
    • GitHub URL を指定します(例:https://github.com/wkndforms/edsforms
    • 作成」をクリックします。

    スキーマベースのフォームを作成

スキーマベースのフォームの検証

フォームは、事前設定済みのデータ連結を使用してユニバーサルエディターで開きます。

事前入力されたフォームフィールドを持つスキーマベースのフォームと、使用可能なデータソース要素を表示するコンテンツブラウザーを示すユニバーサルエディターのスクリーンショット

自動データ連結

スキーマベース以外のフォーム

スキーマ以外のフォームでは、データソース設定とフィールド連結を手動で行う必要があります。 このアプローチは、既存のフォームや複雑な要件に対して柔軟性を提供します。

スキーマベース以外のフォームの作成

  1. フォームプロパティにアクセス

    • Experience Manager Forms オーサーインスタンスにログインします
    • Adobe Experience ManagerFormsフォームとドキュメント ​に移動します
    • フォームを選択し、「プロパティ」をクリックします

    フォームのプロパティを開く

  2. フォームモデルを設定

    • フォームモデル」タブを開きます
    • 選択元 ​ドロップダウンから「フォームデータモデル(FDM)」を選択します
    • リストから FDM を選択します

    「フォームモデル」タブを選択

    FDM を選択

  3. 設定を確認

    • 警告ダイアログで「OK」をクリックします
    • 保存して閉じる」をクリックします。

    フォームモデルウィザード

データ要素の追加

  1. フォームを編集用に開く

    • ユニバーサルエディターでフォームが開きます

    スキーマベース以外のフォームオーサリング

  2. データソース要素にアクセス

    • コンテンツブラウザー ​の「データソース」タブに移動します
    • FDM から使用可能なデータ要素を表示します

    フォームデータソース

  3. フォームに要素を追加

    • データ要素を選択し、「追加」をクリックします
    • または、要素をドラッグ&ドロップしてフォームを作成します

    データ要素の追加

    「データソース」タブからフォーム構造にデータ要素をドラッグ&ドロップしてスキーマ以外のフォームを作成しているユニバーサルエディターを示すスクリーンショット

手動データ連結の追加

既存のフォームフィールドの場合は、バインド参照 ​プロパティを使用してデータ連結を追加します。

  1. フィールドのプロパティを開く

    • 連結用のフォームフィールドを選択します
    • プロパティパネルを開きます
  2. 連結参照を設定

    • 連結参照 ​プロパティに移動します
    • 参照 ​アイコンをクリックします

    フォームフィールドのデータ連結を手動で追加

  3. データ要素を選択

    • 連結参照を選択 ​ウィザードでデータソースツリーから選択します
    • 目的のデータ要素を選択し、「選択」をクリックします

    データ連結参照を選択

    データ要素を選択

  4. 連結を検証

    • これで、フォームフィールドがデータ要素に連結されます
    • 連結が​ 連結参照 ​プロパティに表示されます

    自動データ連結

統合の検証

統合が完了したら、次の手順を実行します。

  1. データ連結をテスト:フォームフィールドに正しいデータが表示されていることを検証します
  2. 送信を検証:データが設定されたソースに保存されていることを確認します
  3. エラー処理を確認:無効なデータシナリオでテストします

次の手順

送信アクションを設定して、フォームワークフローを完了します。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab