[AEM Forms]{class="badge positive" title="AEM Formsに適用）。"}
フォームデータモデル（FDM）の作成 create-form-data-model
Experience Manager Formsの フォームデータモデル（FDM） は、フォームとバックエンドシステム間でデータがどのように構造化および交換されるかを定義します。 Experience Manager Forms のデータ統合機能には、フォームデータモデルを作成して使用するための直感的なユーザーインターフェイスが用意されています。 フォームデータモデル （FDM）は、データの交換にデータソースに依存していますが、データソース の有無にかかわらずフォームデータモデル （FDM）を作成できます。 この柔軟性により、バックエンドの接続が利用可能になる前からフォームの設計とテストを開始し、モデルを再構築することなく、後でデータソースをバインドすることができます。
フォームデータモデル（FDM）を作成する方法は、データソースが設定されているかどうかに応じて、2つあります。
-
事前設定済みのデータソースを使用: データソースの設定で説明されているようにデータソースを設定している場合、フォームデータモデル（FDM）の作成中にそれらを選択できます。 設定されたデータソースを選択すると、選択したデータソースからすべてのデータモデルオブジェクト、プロパティ、サービスが、フォームデータモデル（FDM）で使用できるようになります。 このアプローチは、統合エンドポイントが既に確立されており、これらのシステムのライブスキーマ、オペレーション、サービスをFDMに反映させたい場合に最適です。
-
データソースなし：フォームデータモデル（FDM）のデータソースを設定していない場合でも、データソースなしでフォームデータモデル（FDM）を作成できます。 フォームデータモデル（FDM）を使用してアダプティブ Formsを作成し、サンプルデータを使用してテストできます。 データソースが利用可能になると、フォームデータモデル（FDM）をデータソースにバインドすることができ、このバインディングは関連するアダプティブFormsに自動的に反映されます。したがって、サンプルデータに対して構築されたフォームは、実際のバックエンド接続が追加されると引き続き機能します。
フォームデータモデル（FDM）の作成 data-sources
フォームデータモデル（FDM）を作成する前に、 データソースの設定で説明されているように、フォームデータモデル（FDM）で使用するデータソースを設定していることを確認してください。 フォームデータモデル（FDM）は、Adobe Experience Manager Formsを1つ以上の設定済みデータソースに接続する統合レイヤーを提供し、フォームフィールドをバックエンドデータにバインドしてデータソースサービスを呼び出せるようにします。 設定されているデータソースに基づいてフォームデータモデル（FDM）を作成するには、以下の手順を実行します。
-
Experience Manager オーサーインスタンスで、Forms > Data Integrationsに移動します。
-
作成／フォームデータモデルを選択します。
-
フォームデータモデルの作成ダイアログで、以下の操作を実行します。
- フォームデータモデル（FDM）の名前を指定します。
- （オプション） フォームデータモデル （FDM）のタイトル、説明、タグを指定します。
- （オプション、データソースが既に設定されている場合のみ）「データソース設定」フィールドの横にあるチェックマークアイコンを選択し、使用するデータソース用のクラウドサービスが存在する設定ノードを選択します。 その結果、次のページで選択できるデータソースのリストは、選択した設定ノードで使用できるデータソースに制限されます。 ただし、どの Experience Manager ユーザープロファイルのデータソースも、デフォルトで表示されます。 設定ノードを選択しない場合は、すべての設定ノードのデータソースが表示されます。
-
「次へ」を選択します。
-
（データソースが設定されている場合にのみ適用可能） データソースの選択画面に、使用可能なデータソースが一覧表示されます。 フォームデータモデルで使用するデータソースを選択します。
-
作成を選択し、確認ダイアログで「開く」を選択して、フォームデータモデルエディターを開きます。
フォームデータモデルエディターUIには、次のコンポーネントが含まれます。
A. データソース フォームデータモデル内のデータソースを一覧表示します。 データソースを展開すると、データモデルオブジェクトとサービスが表示されます。
B. データの更新Source定義設定されたデータソースからデータソース定義の変更を取得し、フォームデータモデルエディターの「データソース」タブで更新します。 これにより、接続されたデータソースの現状がモデルに反映されます。
C. モデル 追加されたデータモデルオブジェクトのコンテンツ領域が表示されます。
D. サービス 追加したデータソースの操作やサービスのコンテンツ領域が表示されます。
E. ツールバー フォームデータモデル（FDM）を操作するためのツール。 ツールバーには、フォームデータモデル（FDM）で選択したオブジェクトに応じて、より多くのオプションが表示されます。
F. 選択項目を追加選択したデータモデルオブジェクトとサービスをフォームデータモデルに追加します。
フォームデータモデルエディターの詳細と、フォームデータモデル（FDM）を編集および設定する方法については、 フォームデータモデルの操作を参照してください。
データソースの更新 update
Adobe Experience Manager Formsの既存の フォームデータモデル （FDM） のデータソースを追加、置換、または削除するには、次の手順に従います。 データソースを最新の状態に保つことで、モデル上に構築されたアダプティブ Formsが正しいシステムに対して引き続き読み取りと書き込みを行うことができます。
-
Forms/Data Integrationsに移動し、データソースを追加または更新する フォームデータモデル（FDM） を選択し、プロパティを選択します。
-
フォームデータモデルのプロパティで、「ソースを更新」タブに移動します。
「Sourceを更新」タブで、設定コンテキストを選択し、データソースを追加、置換、または削除できます。
-
設定コンテキストを選択： 「コンテキストに応じた設定」フィールドで参照アイコンを選択し、追加するデータソースのクラウド設定が存在する設定ノードを選択します。 これにより、表示されるクラウド設定が決まります。 ノードを選択しなかった場合、「ソースを追加」を選択すると、
globalノード内のクラウド設定だけが表示されます。 -
新しいデータソースを追加： ソースを追加を選択し、フォームデータモデル（FDM）に追加するデータソースを選択します。
globalに設定され、選択した設定ノードに設定されているすべてのデータソースが表示されます（存在する場合）。 これにより、選択したデータソースが追加され、データモデルオブジェクトがモデル内でバインドできるようになります。 -
既存のデータソースを置き換える：既存のデータソースを同じタイプの別のデータソースに置き換えるには、データソースの編集 アイコンを選択し、使用可能なデータソースのリストから選択します。 同じタイプのソースに置き換えると、既存のデータモデル構造が保持されるため、依存するバインディングは有効なままになります。
-
既存のデータソースを削除：既存のデータソースを削除するには、データソースの削除 アイコンを選択します。 そのデータソースのデータモデルオブジェクトが既に追加され、フォームデータモデル（FDM）で使用中であるため、削除アイコンは無効になっています。これにより、参照されている依存関係を削除できません。
-
-
「保存して閉じる」を選択して、更新内容を保存します。
特定の実行モードのコンテキスト対応設定 runmode-specific-context-aware-config
フォームデータモデル（FDM） は、Sling コンテキストに応じた設定を使用して、様々なデータソースパラメーターを提供し、Experience Manager実行モードによって異なるデータソースへの接続を可能にします。 この機能を使用すると、開発、ステージ、実稼動のいずれで実行されているかに応じて、単一のデプロイメントで個別のエンドポイントをターゲットにすることができます。
フォームデータモデル （FDM） がクラウド設定を使用してパラメーターを保存する場合、これらのパラメーターは、ソースコントロール （Cloud-Manager GIT リポジトリ）を使用してチェックインおよびデプロイされた際に、すべての実行モード （開発、ステージ、実稼動）で同じパラメーターを使用する単一のクラウド設定を作成します。 ユースケースでテスト環境と実稼動環境に異なるデータセットが必要な場合は、各Experience Manager実行モードに固有のデータソースパラメーター（データソース URLなど）を使用します。
これを実現するには、データソースパラメーターと値のペアを含む OSGi設定 を作成します。 これにより、OSGi値が優先され、実行時に フォームデータモデル（FDM） クラウド設定から同じペアが上書きされます。 OSGi設定ではデフォルトでこれらの実行モードがサポートされるので、実行モードに基づいてデータソースパラメーターを別の値に上書きして、各環境が独自のエンドポイントに解決できるようにすることができます。
フォームデータモデル（FDM）でデプロイメント固有のクラウド設定を有効にするには：
-
開発用ローカルインスタンスにクラウド設定を作成します。 詳細な手順については、データソースの設定方法を参照してください。
-
クラウド設定をファイルシステムに保存します。
- フィルター
/conf/{foldername}/settings/cloudconfigs/fdmを使用してパッケージを作成します。 手順 1 と同じ{foldername}を使用します。 Azure ストレージ設定用に、fdmをazurestorageで置き換えます。 - パッケージを構築してダウンロードします。 詳しくは、パッケージのアクションを参照してください。
- フィルター
-
クラウド設定を Experience Manager アーキタイププロジェクトに統合します。
- ダウンロードしたパッケージを解凍します。
jcr_rootフォルダーをコピーして、ui.content／src／main／contentに置きます。ui.content／src／main／content／META-INF／vault／filter.xmlを更新して、フィルター/conf/{foldername}/settings/cloudconfigs/fdmを含めます。 詳しくは、AEM プロジェクトアーキタイプの ui.content モジュールを参照してください。 このアーキタイププロジェクトがCloud Manager（CM）パイプラインを介してデプロイされる場合、同じクラウド設定がすべての環境（または実行モード）にインストールされます。 環境に基づいてクラウド設定のフィールド（URL など）の値を変更するには、次の手順で説明する OSGi 設定を使用します。
-
Apache Sling のコンテキスト対応設定を作成します。 OSGI 設定の作成手順は次のとおりです。
-
アーキタイププロジェクトの OSGi 設定ファイルをセットアップExperience Managerします。
PIDorg.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProviderを持つOSGi ファクトリ設定ファイルを作成します。 実行モードごとに値を変更する必要がある各実行モードフォルダーに、同じ名前のファイルを作成します。 これにより、各実行モードに独自の上書き値が適用されます。 詳しくは、 Adobe Experience Manager の OSGi の設定を参照してください。 -
OSGi設定JSONを設定します。 環境固有の値がデプロイメント時に自動的に適用されるように、Apache Sling Context-Aware Configuration Override Providerを設定します。 Apache Sling コンテキストに応じた設定オーバーライドプロバイダーを使用するには：
- ローカル開発インスタンス
/system/console/configMgrで、Apache Sling Context-Aware Configuration Override Provider: OSGi configurationという名前の出荷時のOSGi設定を選択します。 - 説明を入力してください。
- 「有効」を選択します。
- 「上書き」で、Slingの上書き構文の環境に基づいて変更する必要があるフィールドを指定します。 詳しくは、Apache Sling Context-Aware Configuration - Override を参照してください。 例：
cloudconfigs/fdm/{configName}/url="newURL"。
+を選択して、複数の上書きを追加します。 - 「保存」を選択します。
- OSGi設定JSONを取得するには、AEM SDK クイックスタートを使用したOSGi設定の生成の手順に従います。
- 前の手順で作成したOSGi ファクトリ設定ファイルにJSONを配置します。
- オーバーライド設定の
newURLの値を各環境（または実行モード）の正しいターゲット値に変更して、各環境が独自のURLに解決されるようにします。 - 実行モードに基づいて秘密値を変更するには、Cloud Manager （CM） APIを使用して秘密変数を作成し、後でOSGi Configurationで参照します。
このアーキタイププロジェクトがCloud Manager（CM）パイプラインを通じてデプロイされる場合、オーバーライドによって異なる環境（または実行モード）に異なる値が提供されます。 その結果、単一のコードベースは、実行時に環境固有の設定に解決されます。 これにより、開発、ステージング、実稼動インスタンスのそれぞれが、手動でコードを変更することなく、正しいURLと秘密鍵の値を受け取ることができます。
note NOTE Adobe Managed Service ユーザーは、暗号化サポートを使用して秘密値を暗号化できます。 詳しくは、設定プロパティの暗号化サポート を参照してください。また、 コンテキストに応じた設定がサービスパック 6.5.13.0で使用可能になった後、暗号化されたテキストを値に配置してください。 - ローカル開発インスタンス
-
-
オプションを使用してデータソース定義を更新し、 フォームデータモデルエディターでデータソース定義を更新して、FDM ユーザーインターフェイス（UI）を介してフォームデータモデル（FDM）キャッシュを更新し、最新の設定を取得します。 これにより、FDM キャッシュに新しく適用されたオーバーライド値が反映されます。
次の手順 next-steps
データソースが追加された フォームデータモデル（FDM） が作成されました。 データソースが接続されている場合、次の段階では、フォームデータモデル（FDM）を改良および拡張して、フォームが取得および処理する必要のあるデータを正確に表します。
フォームデータモデル（FDM）を編集して、次のタスクを実行します。
- データモデルオブジェクトとサービスの追加と設定。
- データモデルオブジェクト間に関連付けを追加して、関連するデータがどのように関連付けられるかを定義します。
- 既存のデータモデルオブジェクトのプロパティを編集します。
- カスタムデータモデルオブジェクトとプロパティを、接続されたデータソースで使用できないモデルデータに追加します。
- サンプルデータを生成して、フォームデータモデルの動作をテストおよびプレビューします。
これらの設定手順を使用すると、フォームにバインドする前に、特定のビジネス要件に合わせて フォームデータモデル（FDM） をカスタマイズできます。
詳しくは、フォームデータモデルの操作を参照してください。