フォームデータモデルを作成 create-form-data-model
Experience Manager Forms のデータ統合機能には、フォームデータモデルを作成して使用するための直感的なユーザーインターフェイスが用意されています。フォームデータモデルでは、データソースを使用してデータが交換されますが、データソースを使用せずにフォームデータモデルを作成することも、設定済みのデータソースを使用してフォームデータモデルを作成することもできます。フォームデータモデルを作成する方法には、以下の 2 つがあります。データソースが既に設定されているかどうかに応じて、いずれかの方法を選択してください。
-
事前に設定されたデータソースを使用する場合:「データソースの設定」の説明に従ってデータソースが既に設定されている場合は、フォームデータモデルを作成する際に、それらのデータソースを選択できます。この方法の場合、選択したデータソースのすべてのデータモデルオブジェクト、プロパティ、サービスをフォームデータモデル内で使用することができます。
-
データソースなし:フォームデータモデルのデータソースを設定していない場合でも、データソースを持たずにフォームデータモデルを作成することができます。 フォームデータモデルを使用して、アダプティブフォームを作成し、サンプルデータを使用してテストを行うことができます。データソースが使用可能な状態になっている場合は、フォームデータモデルをそのデータソースに連結すると、関連するアダプティブフォーム内でその連結内容が自動的に反映されます。
フォームデータモデルの作成 data-sources
フォームデータモデル内で使用するデータソースが、「データソースの設定」の説明に従って正しく設定されていることを確認してください。設定されているデータソースに基づいてフォームデータモデルを作成するには、以下の手順を実行します。
-
Experience Manager オーサーインスタンスで、フォーム/データ統合 に移動します。
-
作成/フォームデータモデル を選択します。
-
フォームデータモデルの作成ダイアログで、以下の操作を実行します。
- フォームデータモデルの名前を指定します。
- (オプション)フォームデータモデルのタイトル、説明およびタグを指定します。
- (オプション、データソースが設定されている場合のみ適用)「データソース設定」フィールドの横にあるチェックマークアイコンを選択し、使用するデータソース用のクラウドサービスが存在する設定ノードをクリックします。この操作により、選択した設定ノード内の有効なデータソースだけが、以下のページに選択可能なデータソースとして表示されます。ただし、どの Experience Manager ユーザープロファイルのデータソースも、デフォルトで表示されます。設定ノードを選択しない場合は、すべての設定ノードのデータソースが表示されます。
-
「次へ」を選択します。
-
(データソースが既に設定されている場合のみ)データソースを選択 画面に、使用可能なデータソースが表示されます(有効なデータソースが存在する場合)。フォームデータモデルで使用するデータソースを選択します。
-
「作成」を選択し、確認ダイアログで「開く」をクリックして、フォームデータモデルエディターを開きます。
ここで、フォームデータモデルエディターの UI に表示される各種コンポーネントを確認します。
A. データソース フォームデータモデルのデータソースをリストします。データソースを展開すると、データモデルオブジェクトとサービスが表示されます。
B. データソース定義を更新 データソース定義内の変更内容が設定済みデータソースから取得され、フォームデータモデルエディターの「データソース」タブでその変更内容が反映されます。
C. モデル 追加されたデータモデルオブジェクトのコンテンツ領域が表示されます。
D. サービス 追加したデータソースの操作やサービスのコンテンツ領域が表示されます。
E. ツールバー フォームデータモデルを操作するためのツールです。選択したフォームデータモデルのオブジェクトに応じて、追加のオプションがツールバーに表示されます。
F. 選択 選択したデータモデルオブジェクトとサービスをフォームデータモデルに追加します。
フォームデータモデルエディターの詳細と、フォームデータモデルエディターを使用してフォームデータモデルの編集と設定を行う方法については、「フォームデータモデルの操作」を参照してください。
データソースの更新 update
既存のフォームデータモデルにデータソースを追加するには(または、既存のフォームデータモデルのデータソースを更新するには)、以下の手順を実行します。
-
フォーム/データ統合 に移動し、データソースを追加または更新するフォームデータモデルを選択して、「プロパティ」をクリックします。
-
フォームデータモデルのプロパティで、「ソースを更新」タブに移動します。
「ソースを更新」タブで、以下の操作を実行します。
-
「コンテキスト対応設定」フィールドで参照アイコンを選択し、追加するデータソースのクラウド設定が存在する設定ノードを指定します。ノードを選択しなかった場合、「ソースを追加」を選択すると、
global
ノード内のクラウド設定だけが表示されます。 -
新しいデータソースを追加する場合は、「ソースを追加」をクリックし、フォームデータモデルに追加するデータソースを選択します。
global
ノード内で設定されているデータソースと、選択した設定ノード内で構成されているデータソースが、すべて表示されます。 -
既存のデータソースを、同じタイプの別のデータソースで置き換えるには、データソースの「編集」アイコンを選択し、使用可能なデータソースのリストから選択します。
-
既存のデータソースを削除するには、目的のデータソースの「削除」アイコンを選択します。データソース内のデータモデルオブジェクトがフォームデータモデルに追加されている場合、「削除」アイコンは無効になります。
-
-
「保存して閉じる」を選択して、変更内容を保存します。
特定の実行モードのコンテキスト対応設定 runmode-specific-context-aware-config
フォームデータモデルは、Sling のコンテキストに対応した設定を利用して、異なるデータソースパラメーターをサポートし、異なる Experience Manager 実行モードのデータソースと接続します。
フォームデータモデルがクラウド設定を使用してパラメーターを保存する場合、この設定をチェックインしてソース管理(Cloud-Manager GIT リポジトリー)を通じてデプロイすると、すべての実行モード(開発、ステージ、実稼動)で同じパラメーターを持つクラウド設定が作成されます。ただし、テスト環境と実稼動環境で異なるデータセットを使用する必要があるユースケースの場合は、異なる Experience Manager 実行モード用のデータソースパラメーター(データソース URL など)を使用します。
これを行うには、データソースのパラメーターと値のペアを含む OSGi 設定を作成する必要があります。この設定は、実行時にフォームデータモデルクラウド設定の同じペアを上書きします。OSGi 設定はデフォルトでこれらの実行モードをサポートしているので、実行モードに基づいてデータソースパラメーターを異なる値に上書きできます。
フォームデータモデルでデプロイメント固有のクラウド設定を有効にする手順は次のとおりです。
-
開発用ローカルインスタンスにクラウド設定を作成します。詳細な手順については、データソースの設定方法を参照してください。
-
クラウド設定をファイルシステムに保存します。
- フィルター
/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 モジュールを参照してください。このアーキタイププロジェクトを 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 の使用手順は次のとおりです。
- ローカル開発インスタンス
/system/console/configMgr
で、Apache Sling Context-Aware Configuration Override Provider: SGi configuration という名前のファクトリー OSGi 設定を選択します。 - 説明を入力します。
- 「有効」を選択します。
- オーバーライドで、Sling オーバーライド構文の環境に基づいて変更する必要があるフィールドを指定します。詳しくは、Apache Sling Context-Aware Configuration - Override を参照してください。例:
cloudconfigs/fdm/{configName}/url="newURL"
。複数のオーバーライドを追加するには、「+」を選択します。 - 「保存」を選択します。
- OSGi 設定 JSON を取得するには、AEM SDK Quickstart を使用した OSGi 設定の生成の手順に従ってください。
- 前の手順で作成した OSGi Factory Configuration ファイルに JSON を配置します。
- 環境(または実行モード)に基づいて
newURL
の値を変更します。 - 実行モードに応じてシークレット値を変更するには、Cloud Manager API を使用してシークレット変数を作成し、後で OSGi 設定から参照することができます。
このアーキタイププロジェクトが CM パイプラインを通じてデプロイされる場合、オーバーライドは異なる環境(または実行モード)で異なる値を提供します。
note note NOTE サービスパック 6.5.13.0 でコンテキスト対応設定が利用可能になった後、Adobe Managed Service ユーザーは暗号化サポートを使用してシークレットの値を暗号化し(詳細は、設定プロパティの暗号化サポートを参照)、値に暗号化テキストを配置できるようになりました。 - ローカル開発インスタンス
-
-
フォームデータモデルエディターのデータソース定義を更新するオプションを使用してデータソース定義を更新し、FDM UI を通じて FDM キャッシュを更新し、最新の設定を取得します。
次の手順 next-steps
これで、データソースが追加されたフォームデータモデルが作成されました。この状態で、フォームデータモデルを編集してデータモデルオブジェクトとサービスの作成と設定を行ったり、データモデルオブジェクト間の関連付けを行ったり、プロパティを編集したり、カスタムのデータモデルオブジェクトとプロパティを追加したり、サンプルデータを生成したりできます。
詳しくは、「フォームデータモデルの操作」を参照してください。