フォームデータモデル（FDM）の操作
| バージョン | 記事リンク |
|---|---|
| AEM 6.5 | ここをクリックしてください |
| AEM as a Cloud Service | この記事 |
フォームデータモデル（FDM）エディターには、フォームデータモデル（FDM）の編集と設定を行うための直感的なユーザーインターフェイスが用意されています。このエディターを使用すると、フォームデータモデル（FDM）内の関連データソースからデータモデルのオブジェクト、プロパティ、サービスの追加と設定を行うことができます。また、データソースを持っていないデータモデルオブジェクトとプロパティを作成し、後でそれらのオブジェクトとプロパティにデータソースを連結することもできます。さらに、データモデルオブジェクトのプロパティ用にサンプルデータを生成して編集し、これらのプロパティを使用してアダプティブフォームにデータを取り込み、プレビュー表示することもできます。フォームデータモデル（FDM）内で設定したデータモデルのオブジェクトとサービスをテストすることにより、そのフォームデータモデル（FDM）がデータソースと正しく統合されているかどうかを確認できます。
Forms のデータ統合機能を初めて使用する場合や、これまでにデータソースの設定やフォームデータモデル（FDM）の作成を行ったことがない場合は、以下のトピックを参照してください。
ここからは、フォームデータモデルエディターを使用して実行できる様々なタスクや設定について説明します。
メモデータモデルオブジェクトとサービスの追加
データソースを持つフォームデータモデル（FDM）が既に作成されている場合は、フォームデータモデルエディターを使用して、データモデルオブジェクトとサービスの追加、各種プロパティの設定、データモデルオブジェクト間の関連付けの定義、フォームデータモデル（FDM）とサービスのテストを行うことができます。
フォームデータモデル（FDM）内の使用可能なデータソースから、データモデルのオブジェクトとサービスを追加できます。追加したデータモデルオブジェクトは「モデル」タブに表示され、追加したサービスは「サービス」タブに表示されます。
データモデルオブジェクトとサービスを追加するには、以下の手順を実行します。
-
Experience Manager オーサーインスタンスにログインして Forms／データ統合 に移動し、データモデルオブジェクトを追加するフォームデータモデル（FDM）を開きます。
-
データソースペインでデータソースを展開して、使用可能なデータモデルオブジェクトとサービスを表示します。
-
フォームデータモデル（FDM）に追加するデータモデルオブジェクトとサービスを選択して、「選択項目を追加」を選択します。
選択されたデータモデルオブジェクトとサービス
「モデル」タブには、フォームデータモデル（FDM）に追加されたすべてのデータモデルオブジェクトのグラフィカル表現と、それらのオブジェクトのプロパティが表示されます。フォームデータモデル内の各データモデルオブジェクト（FDM）は、ボックスを使用して表現されます。
追加したデータモデルオブジェクトが表示された「モデル」タブ
メモデータモデルオブジェクトのボックスを選択してドラッグすると、コンテンツ領域内にデータモデルオブジェクトを配置できます。フォームデータモデル（FDM）に追加されたデータモデルオブジェクトは、データソースペイン内ではすべてグレーアウトされます。「サービス」タブには、追加されたサービスが一覧表示されます。
データモデルサービスが表示された「サービス」タブ
メモOData サービスのメタデータドキュメントには、データモデルオブジェクトとサービスのほかに、2 つのデータモデルオブジェクト間の関連付けを定義するナビゲーションプロパティが含まれます。詳しくは、OData サービスのナビゲーションプロパティの操作を参照してください。 -
「保存」を選択して、フォームモデルオブジェクトを保存します。
メモアダプティブフォームのルールを使用すると、フォームデータモデル（FDM）の「サービス」タブで設定したサービスを呼び出せます。設定したサービスは、ルールエディターの「サービスを起動」アクションで使用できます。設定したサービスをアダプティブフォームルールで使用する方法については、「ルールエディター」で、「サービスを起動」ルールと「指定値」ルールに関する説明を参照してください。
データモデルオブジェクトと子プロパティの作成
データモデルオブジェクトの作成
設定済みのデータソースからデータモデルオブジェクトを追加できますが、データソースのないデータモデルオブジェクトやデータモデルエンティティを作成することもできます。フォームデータモデル（FDM）でデータソースを設定していない場合は特に便利です。
データソースを使用せずにデータモデルオブジェクトを作成するには：
-
Experience Manager オーサーインスタンスにログインして Forms／データ統合 に移動し、データモデルオブジェクトまたはデータモデルエンティティを作成するフォームデータモデル（FDM）を開きます。
-
「エンティティを作成」を選択します。
-
データモデルを作成ダイアログで、データモデルオブジェクトの名前を指定して「追加」を選択します。データモデルオブジェクトがフォームデータモデル（FDM）に追加されます。以下の図に示すように、新しく追加されたデータモデルオブジェクトは、データソースには連結されません。また、プロパティも設定されません。
次に、バインドされていないデータモデルオブジェクトに子プロパティを追加できます。
子プロパティの追加
フォームデータモデルエディターを使用すると、データモデルオブジェクトで子プロパティを作成できます。作成時のプロパティは、データソース内のどのプロパティにもバインドされません。後で、データモデルオブジェクトを含む別のプロパティにこの子プロパティをバインドできます。
子プロパティを作成するには、以下の手順を実行します。
-
フォームデータモデルでデータモデルオブジェクトを選択して「子プロパティを作成」を選択します。
-
子プロパティを作成 ダイアログで、 プロパティの名前とデータタイプをそれぞれ 名前 フィールドと タイプ フィールドに指定します。必要に応じて、プロパティのタイトルと説明を指定できます。
-
プロパティが計算済みの場合は、「計算済み」を有効にします。計算済みプロパティの値は、ルールまたは式に基づいて評価されます。詳しくは、プロパティの編集を参照してください。
-
データモデルオブジェクトがデータソースにバインドされている場合、追加された子プロパティは、同じ名前とデータタイプを持つ親データモデルオブジェクトのプロパティに自動的にバインドされます。
子プロパティをデータモデルオブジェクトのプロパティに手動で連結するには、「参照をバインド」フィールドの横に表示されている参照アイコンを選択します。オブジェクトの選択 ダイアログには、親データモデルオブジェクトのすべてのプロパティが一覧表示されます。バインドするプロパティを選択し、チェックマークアイコンをクリックします。子プロパティと異なるデータタイプのプロパティを選択することはできません。
-
「完了」を選択して子プロパティを保存し、「保存」を選択してフォームデータモデル（FDM）を保存します。これで、子プロパティがデータモデルオブジェクトに追加されました。
データモデルオブジェクトとプロパティを作成したら、続いて、アダプティブフォームをそのフォームデータモデル（FDM）に基づいて作成できます。データソースの設定が完了した時点で、フォームデータモデル（FDM）をデータソースにバインドできます。関連するアダプティブフォームでは、連結が自動的に更新されます。フォームデータモデル（FDM）を使用してアダプティブフォームを作成する方法については、フォームデータモデルの使用を参照してください。
データモデルオブジェクトとプロパティの連結
フォームデータモデル（FDM）に統合するデータソースが使用可能な状態になったら、データソースの更新に記載されている説明に従い、データソースをフォームデータモデル（FDM）に追加することができます。次に、バインドされていないデータモデルオブジェクトとプロパティを以下の手順でバインドします。
-
フォームデータモデルで、データソースへのバインドの対象となるバインドされていないデータソースを選択します。
-
「プロパティを編集」を選択します。
-
プロパティを編集 ペインで、バインド フィールドの横にある参照アイコンを選択します。フォームデータモデル（FDM）に追加されたデータソースを一覧表示する オブジェクトを選択 ダイアログが開きます。
-
データソースツリーを展開し、連結するデータモデルオブジェクトを選択してチェックマークアイコンを選択します。
-
「完了」を選択してプロパティを保存し、「保存」を選択してフォームデータモデルを保存します。これで、データモデルオブジェクトがデータソースにバインドされました。これ以降は、データモデルオブジェクトに「連結されていない」というテキストが表示されることはありません。
サービスの設定
データモデルオブジェクトのデータの読み取りと書き込みを行うには、以下の手順を実行して、読み取りサービスと書き込みサービスを設定します。
-
データモデルオブジェクト上部のチェックボックスを選択して「プロパティを編集」を選択します。
データモデルオブジェクトの読み取りサービスと書き込みサービスの設定を行う「プロパティを編集」
プロパティを編集ダイアログが表示されます。
プロパティを編集ダイアログ
メモOData サービスのメタデータドキュメントには、データモデルオブジェクトとサービスのほかに、2 つのデータモデルオブジェクト間の関連付けを定義するナビゲーションプロパティが含まれます。OData サービスのデータソースをフォームデータモデル（FDM）に追加すると、データモデルオブジェクト内のすべてのナビゲーションプロパティに対し、フォームデータモデル（FDM）でサービスを使用できます。このサービスを使用して、対応するデータモデルオブジェクトのナビゲーションプロパティを読み取ることができます。このサービスの使用について詳しくは、「OData サービスのナビゲーションプロパティの操作」を参照してください。 -
トップレベルオブジェクト を切り替えて、データモデルオブジェクトを最上位のモデルオブジェクトにするかどうかを指定します。
フォームデータモデル（FDM）で設定したデータモデルオブジェクトは、そのフォームデータモデル（FDM）に基づくアダプティブフォームのコンテンツブラウザーの「データモデルオブジェクト」タブで使用できるようになります。2 つのデータモデルオブジェクト間の関連付けを追加すると、「データモデルオブジェクト」タブで、関連付け先のデータモデルオブジェクトが、関連付け元のデータモデルオブジェクトの下にネストされます。ネストされたデータモデルが最上位のオブジェクトである場合は、「データモデルオブジェクト」タブにもそのデータモデルが個別に表示されます。この場合、ネストされた階層の内側と外側に 1 つずつデータモデルのエントリが表示されるので、フォームの作成者が混乱する可能性があります。関連するデータモデルオブジェクトをネストされた階層内だけで表示するには、そのデータモデルオブジェクトの「トップレベルオブジェクト」プロパティを無効にします。
-
選択したデータモデルオブジェクトの読み取りサービスと書き込みサービスを選択します。サービスの引数が表示されます。
従業員データソースに対して設定されている読み取りサービスと書き込みサービス
-
読み取りサービスの引数に表示されている
-
「完了」を選択して引数を保存し、もう一度「完了」を選択してプロパティを保存します。次に、「保存」を選択してフォームデータモデル（FDM）を保存します。
