フォームデータモデルの操作 work-with-form-data-model

AEM オーサーインスタンスにログインして​ フォーム／データ統合 ​に移動し、データモデルオブジェクトを追加するフォームデータモデルを開きます。

データソースペインでデータソースを展開して、使用可能なデータモデルオブジェクトとサービスを表示します。

フォームデータモデルに追加するデータモデルオブジェクトとサービスを選択して、選択項目を追加 ​をタップします。

「モデル」タブには、フォームデータモデルに追加されたすべてのデータモデルオブジェクトのグラフィカル表現と、それらのオブジェクトのプロパティが表示されます。フォームデータモデル内の各データモデルオブジェクトは、ボックスを使用して表現されます。

「サービス」タブには、追加されたサービスが一覧表示されます。

タップ 保存 フォームモデルオブジェクトを保存します。

AEMオーサーインスタンスにログインし、に移動します。 Forms /データ統合 ​をクリックし、データモデルオブジェクトまたはエンティティを作成するフォームデータモデルを開きます。

エンティティを作成 ​をタップします。

データモデルを作成ダイアログで、データモデルオブジェクトの名前を指定して​ 追加 ​をタップします。データモデルオブジェクトがフォームデータモデルに追加されます。新しく追加されたデータモデルオブジェクトは、データソースには連結されないことに注意してください。また、以下の図に示すように、プロパティも設定されません。

フォームデータモデルでデータモデルオブジェクトを選択して「子プロパティを作成」をタップします。

内 子プロパティを作成 ダイアログで、 名前 および タイプ フィールドに設定されます。 オプションで、プロパティのタイトルと説明を指定できます。

プロパティが計算済みプロパティの場合は、「計算済み」を有効にします。 計算済みプロパティの値は、ルールまたは式に基づいて評価されます。 詳しくは、 プロパティを編集.

データモデルオブジェクトがデータソースに連結されている場合、追加された子プロパティは、同じ名前とデータ型を持つ親データモデルオブジェクトのプロパティに自動的に連結されます。

子プロパティをデータモデルオブジェクトプロパティに手動で連結するには、 バインド参照 フィールドに入力します。 この オブジェクトを選択 ダイアログには、親データモデルオブジェクトのすべてのプロパティが一覧表示されます。 バインドするプロパティを選択し、チェックマークアイコンをタップします。 子プロパティと同じデータ型のプロパティのみを選択できます。

タップ 完了 子プロパティを保存してをタップします。 保存 フォームデータモデルを保存するには… これで、子プロパティがデータモデルオブジェクトに追加されました。

フォームデータモデルで、データソースに連結する連結されていないデータソースを選択します。

「プロパティを編集」をタップします。

内 プロパティを編集 ウィンドウで、横の参照アイコンをタップします。 連結 フィールドに入力します。 すると、 オブジェクトを選択 フォームデータモデルに追加されたデータソースを一覧表示するダイアログ。

データソースツリーを展開し、バインドするデータモデルオブジェクトを選択して、チェックマークアイコンをタップします。

タップ 完了 プロパティを保存し、 保存 フォームデータモデルを保存します。 これで、データモデルオブジェクトがデータソースに連結されました。 これ以降は、データモデルオブジェクトに「連結されていない」というテキストが表示されることはありません。

データモデルオブジェクト上部のチェックボックスを選択してをタップします。 プロパティを編集.

データモデルオブジェクトの読み取りサービスと書き込みサービスの設定を行う「プロパティを編集」

プロパティ編集ダイアログが表示されます。

プロパティを編集ダイアログ

切り替え 最上位オブジェクト をクリックして、データモデルオブジェクトが最上位のモデルオブジェクトかどうかを指定します。

フォームデータモデルで設定されたデータモデルオブジェクトは、フォームデータモデルに基づくアダプティブフォームのコンテンツブラウザーの「データモデルオブジェクト」タブで使用できます。 2 つのデータモデルオブジェクト間の関連付けを追加すると、「データモデルオブジェクト」タブで、関連付け先のデータモデルオブジェクトが、関連付け元のデータモデルオブジェクトの下にネストされます。ネストされたデータモデルが最上位のオブジェクトの場合は、「データモデルオブジェクト」タブにも別々に表示されます。 そのため、入れ子になった階層の内側と外側の 2 つのエントリが表示され、フォームの作成者が混乱する可能性があります。 関連するデータモデルオブジェクトをネストされた階層内だけで表示するには、そのデータモデルオブジェクトの「トップレベルオブジェクト」プロパティを無効にします。

選択したデータモデルオブジェクトの読み取りサービスと書き込みサービスを選択します。 サービスの引数が表示されます。

従業員データソースに対して設定されている読み取りサービスと書き込みサービス

読み取りサービスの引数に表示されている をタップして、ユーザープロファイル属性、リクエスト属性またはリテラル値にその引数を連結し、連結値を指定します。これにより、指定したバインド属性またはリテラル値にサービスの引数がバインドされ、それが引数としてサービスに渡され、指定した値に関連付けられている詳細情報がデータソースから取得されます。

この例では、 id 引数は empid ユーザープロファイルの属性を設定し、それを引数として読み取りサービスに渡します。 関連するプロパティの値を employee 指定したのデータモデルオブジェクト empid. この場合、00250を empid 読み取りサービスは、フォームの「 」フィールドで、従業員 id が00250の従業員の詳細を読み取ります。

さらに、引数を必須またはオプションにすることができます。

id 引数をAEMユーザープロファイルの empid 属性にバインドする

「完了」をタップして引数を保存し、もう一度「完了」をタップしてプロパティを保存します。次に、「保存」をタップしてフォームデータモデルを保存します。

データモデルオブジェクト上部のチェックボックスを選択してをタップします。 関連付けを追加. 関連付けを追加ダイアログが表示されます。

関連付けを追加ダイアログが表示されます。

関連付けを追加ダイアログ

関連付けを追加ウィンドウで、以下の操作を実行します。

• 関連付けのタイトルを指定します。
• 関連付けのタイプ（「1 対 1」または「1 対多」）を選択します。
• 関連付けるデータモデルオブジェクトを選択します。
• 選択したモデルオブジェクトからデータを読み取る読み取りサービスを選択します。 読み取りサービスの引数が表示されます。 必要に応じて、引数を変更し、関連付けるデータモデルオブジェクトのプロパティにバインドするには、編集します。

以下に示す例では、「扶養家族」データモデルオブジェクトの読み取りサービスのデフォルト引数が dependentid になっています。

「扶養家族」読み取りサービスのデフォルト引数が dependentid になっている

ただし、この引数は、関連付けるデータモデルオブジェクト間の共通プロパティ（この例の場合は Employeeid）でなければなりません。そのため、Employeeid 引数を「従業員」データモデルオブジェクトの id プロパティにバインドして、関連付けられている扶養家族の詳細情報を「扶養家族」データモデルオブジェクトから取得する必要があります。

更新された引数と連結

タップ 完了 をクリックして、引数を保存します。

タップ 完了 関連付けを保存し、 保存 フォームデータモデルを保存します。

必要に応じて、さらに関連付けを作成するには、手順を繰り返します。

フォームデータモデル内のデータモデルオブジェクト、プロパティ、またはサービスの横にあるチェックボックスをオンにします。

「プロパティを編集」をタップします。この プロパティを編集 選択したモデルオブジェクト、プロパティ、またはサービスのペインが開きます。

• データモデルオブジェクト:読み取りサービスと書き込みサービスを指定し、引数を編集します。
• プロパティ:プロパティのタイプ、サブタイプ、形式を指定します。 また、選択したプロパティがデータモデルオブジェクトのプライマリキーかどうかを指定することもできます。
• サービス:サービスの入力モデルオブジェクト、出力タイプ、および引数を指定します。 Get サービスの場合は、配列を返すかどうかを指定できます。

get サービスのプロパティを編集ダイアログ

タップ 完了 プロパティを保存してから 保存 フォームデータモデルを保存します。

FullName という名前の新しいプロパティを作成し、データタイプとして String を設定します。

「計算済み」を有効にし、「完了」をタップしてプロパティを作成します。

FullName 計算済みプロパティが作成されます。 計算済みプロパティを表すためのプロパティの横のアイコンに注意してください。

FullName プロパティを選択し、をタップします。 ルールを編集. ルールエディターウィンドウが開きます。

ルールエディターウィンドウで、「 作成. A 値を設定 ルールウィンドウが開きます。

オプション選択ドロップダウンで、「数式」を選択します。その他の使用可能なオプションは次のとおりです。 フォームデータモデルオブジェクト および 文字列.

数式で、「 名 および 姓 を、それぞれ第 1 および第 2 のオブジェクトに設定します。 演算子として「プラス」を選択します。

「完了」、「閉じる」の順に選択して、ルールエディターウィンドウを閉じます。ルールは以下のようになります。

フォームデータモデルで、 保存. 計算済みプロパティが設定されます。

フォームデータモデルを開き、 サンプルデータを編集. サンプルデータが生成され、サンプルデータ編集ウィンドウに表示されます。

「サンプルデータを編集」ウィンドウでデータを編集して「保存」をタップします。

フォームデータモデル内のデータモデルオブジェクトまたはサービスを選択してをタップします。 モデルオブジェクトのテスト または テストサービス、それぞれ。

フォームデータモデルをテストウィンドウが表示されます。

フォームデータモデルをテストウィンドウの入力ペインで、テストするデータモデルオブジェクトまたはサービスを選択します。

テストコードで引数の値を指定し、をタップします。 テスト. テストが成功すると、出力が出力ペインに返されます。