アダプティブフォームで推奨される、データソースベースの事前入力ワークフローと送信ワークフロー

最終更新日： 2023-07-24

トピック：
Adaptive Forms
このトピックの詳細を表示

作成対象：
Beginner

Intermediate

Admin

Developer

自動フォーム変換サービスを使用して変換されたアダプティブフォームでは、以下に示すいずれかのデータソースを使用することができます。

フォームデータモデル、OData、その他のサードパーティ製サービス
JSON スキーマ
XSD スキーマ

データソースに基づいて、データモデルを使用してアダプティブフォームを生成することも、データモデルを使用せずにアダプティブフォームを生成することもできます。

この記事では、データソースを選択し、変換サービスを使用してアダプティブフォームを生成してから、フィールド値を事前入力するための推奨ワークフローについて説明します。また、推奨される送信方法についても説明します。

データソース	推奨ワークフロー
フォームデータモデル、OData、その他のサードパーティ製サービス	方法 1：データソースとして、フォームデータモデル、OData、またはその他のサードパーティ製サービスを選択します。次に、自動フォーム変換サービスを使用して、データバインディングがないアダプティブフォームを生成します。次に、アダプティブフォームの各フィールドをデータモデルの各エンティティに手動でバインドし、「フォームデータモデルの事前入力サービス」オプションを使用して、フィールド値の事前入力を行います。次に、「フォームデータモデルを使用して送信」オプションを使用して、アダプティブフォームを送信します。
	方法 2：データソースとして、フォームデータモデル、OData、またはその他のサードパーティ製サービスを選択します。次に、自動フォーム変換サービスを使用して、データバインディングがないアダプティブフォームを生成します。次に、ルールエディターを使用してアダプティブフォームフィールドをバインドし、フィールド値の事前入力を行います。次に、必要に応じてフィールド値を変更し、crx-repository にデータを送信します。
	これらのワークフローの詳細な手順については、「データベース、OData、またはその他のサードパーティ製サービスをデータソースとして使用する」を参照してください。
JSON スキーマ	データソースとして JSON スキーマを選択します。選択したデータソースに応じて、以下のいずれかの方法を選択します。
	方法 1：自動フォーム変換サービスを使用して、データバインディングがないアダプティブフォームを生成し、JSON スキーマをデータソースとして設定します。次に、アダプティブフォームの各フィールドを JSON スキーマに手動でバインドし、サポートされているいずれかのプロトコルを使用して、フィールド値の事前入力を行います。次に、必要に応じてフィールド値を変更し、crx-repository にデータを送信します。
	このワークフローの詳細な手順については、次のセクションを参照してください：JSON スキーマをデータソースとして使用する
	方法 2：自動フォーム変換サービスを使用して、JSON データバインディングを持つアダプティブフォームを生成します。事前入力サービスとフォーム送信機能がシームレスに連携します。設定手順を実行する必要はありません。
	このワークフローの詳細な手順については、「JSON スキーマをデータソースとして使用する」を参照してください。
XSD スキーマ	データソースとして XSD スキーマを選択します。選択したデータソースに応じて、自動フォーム変換サービスを使用してデータバインディングがないアダプティブフォームを生成し、XSD スキーマをデータソースとして設定します。次に、アダプティブフォームの各フィールドを XSD スキーマに手動でバインドし、サポートされているいずれかのプロトコルを使用して、フィールド値の事前入力を行います。次に、必要に応じてフィールド値を変更し、crx-repository にデータを送信します。
	このワークフローの詳しい手順については、「XSD スキーマをデータソースとして使用する」を参照してください。

自動フォーム変換サービスについて詳しくは、以下の記事を参照してください。

この記事は、アダプティブフォームに関する基礎的な概念を理解している読者を対象としています。

前提条件

AEM オーサーインスタンスを設定する
AEM オーサーインスタンス上で自動フォーム変換サービスを設定する

サンプルのアダプティブフォーム

アダプティブフォームフィールドに事前に値を入力してデータソースに送信するというユースケースを実行するには、以下のサンプル PDF ファイルをダウンロードする必要があります。

サンプルのローン申し込みフォーム

ファイルを入手

この PDF ファイルは、自動フォーム変換サービスの入力データとして機能します。自動フォーム変換サービスを実行すると、このファイルがアダプティブフォームに変換されます。以下の画像は、PDF 形式のサンプルのローン申し込みフォームです。

サンプルのローン申し込みフォーム

フォームモデルのデータを準備する

AEM Forms のデータ統合機能により、複数の異なるデータソースを設定して接続することができます。変換サービスを使用してアダプティブフォームを生成したら、使用するデータモデル（XSD スキーマまたは JSON スキーマ）に応じてフォームモデルを定義します。データベース、Microsoft Dynamics、またはその他のサードパーティ製サービスを使用して、フォームデータモデルを作成することができます。

このチュートリアルでは、MySQL データベースをデータソースとして使用してフォームデータモデルを作成します。アダプティブフォーム内の有効なフィールドに基づいて、データベース内に loanapplication というスキーマを作成し、このスキーマに applicant というテーブルを追加します。

サンプルの mysql データ

以下の DDL ステートメントを使用して、データベース内に applicant というテーブルを作成します。

CREATE TABLE `applicant` (
   `name` varchar(45) DEFAULT NULL,
   `address` varchar(45) DEFAULT NULL,
   `phonenumber` int(11) NOT NULL,
   `email` varchar(45) DEFAULT NULL,
   `occupation` varchar(45) DEFAULT NULL,
   `annualsalary` varchar(45) DEFAULT NULL,
   `familymembers` int(11) DEFAULT NULL,
   PRIMARY KEY (`phonenumber`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

XSD スキーマをフォームモデルとして使用してこのユースケースを実行する場合は、以下のコードが記述された XSD ファイルを作成します。

<?xml version="1.0" encoding="utf-8" ?>
    <xs:schema targetNamespace="http://adobe.com/sample.xsd"
                    xmlns="http://adobe.com/sample.xsd"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="sample" type="SampleType"/>

  <xs:complexType name="SampleType">
    <xs:sequence>
      <xs:element name="name" type="xs:string"/>
   <xs:element name="address" type="xs:string"/>
   <xs:element name="phonenumber" type="xs:int"/>
   <xs:element name="email" type="xs:string"/>
   <xs:element name="occupation" type="xs:string"/>
   <xs:element name="annualsalary" type="xs:string"/>
   <xs:element name="familymembers" type="xs:string"/>
 </xs:sequence>
  </xs:complexType>

  </xs:schema>

または、ローカルのファイルシステムに XSD スキーマをダウンロードします。

サンプルのローン申し込み XSD スキーマ

ファイルを入手

アダプティブフォーム内で XSD スキーマをフォームモデルとして使用する方法については、「XML スキーマを使用してアダプティブフォームを作成する」を参照してください。

JSON スキーマをフォームモデルとして使用してこのユースケースを実行する場合は、以下のコードが記述された JSON ファイルを作成します。

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "definitions": {
        "loanapplication": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "address": {
                    "type": "string"
                },
    "phonenumber": {
                    "type": "number"
                },
    "email": {
                    "type": "string"
                },
    "occupation": {
                    "type": "string"
                },
    "annualsalary": {
                    "type": "string"
                },
    "familymembers": {
                    "type": "number"
                }
            }
        }
 },
 "type": "object",
    "properties": {
        "employee": {
            "$ref": "#/definitions/loanapplication"
        }
    }
}

または、ローカルのファイルシステムに JSON スキーマをダウンロードします。

サンプルのローン申し込み JSON スキーマ

ファイルを入手

アダプティブフォーム内で JSON スキーマをフォームモデルとして使用する方法については、「JSON スキーマを使用してアダプティブフォームを作成する」を参照してください。

データバインディングがないアダプティブフォームを生成する

自動フォーム変換サービスを使用して、サンプルのローン申し込みフォームをデータバインディングがないアダプティブフォームに変換します。データバインディングがないアダプティブフォームを生成するには、「データバインディングがないアダプティブフォームを生成」チェックボックスを選択します。

データバインディングがないアダプティブフォーム

データバインディングがないアダプティブフォームを生成したら、アダプティブフォームのデータソースを選択します。

データベース、OData、またはその他のサードパーティ製サービス
JSON スキーマ
XSD スキーマ

メモ

自動フォーム変換サービスを使用して生成されたアダプティブフォームに、同じ名前のフィールドが複数含まれている場合は、フォームの送信時にデータが失われる可能性があるため、必ずこれらのフィールドをデータソースエンティティにバインドしてください。

データベース、OData、またはその他のサードパーティ製サービスをデータソースとして使用する

ユースケース：自動フォーム変換サービスを使用して、データバインディングがないアダプティブフォームを生成し、MYSQL データベースをデータソースとして設定します。次に、アダプティブフォームの各フィールドをデータモデルの各エンティティに手動でバインドし、「フォームデータモデルの事前入力サービス」オプションを使用して、フィールド値の事前入力を行います。次に、「フォームデータモデルを使用して送信」オプションを使用して、アダプティブフォームを送信します。

このユースケースを実行する前に、以下の処理を行う必要があります。

このユースケースでは、loanapplication というフォームデータモデルを作成し、read サービス引数を Literal 値にバインドします。電話番号のリテラル値は、MySQL データベースの applicant スキーマ内で設定されているいずれかのレコードと一致している必要があります。変換サービスは、この値を引数として使用して、データソースから詳細データをフェッチします。「バインド先」ドロップダウンリストで「ユーザプロファイル属性または要求属性」を選択することもできます。

フォームデータモデルを設定する

メモ

このユースケースを実行する前に、get サービスと insert サービスをフォームデータモデルに追加し、これらのサービスの設定とテストを行ってください。

以下の手順を実行します。

変換後のサンプルのローン申し込みフォームを output フォルダーで選択して「プロパティ」をタップします。
「フォームモデル」タブをタップし、「選択」ドロップダウンリストで「フォームデータモデル」を選択します。次に、「フォームデータモデルを選択」タブをタップし、データモデルで「loanapplication」を選択します。「保存して終了」をタップしてフォームを保存します。
サンプルのローン申し込みフォームを選択して「編集」をタップします。
「コンテンツ」タブで、以下の設定アイコンをタップします。
1. 「基本」セクションの「事前入力サービス」ドロップダウンリストで「フォームデータモデル事前入力サービス」を選択します。
2. 「送信」セクションの「送信アクション」ドロップダウンリストで「フォームデータモデルを使用して送信」を選択します。
3. 「送信するデータモデル」フィールドでデータモデルを選択します。
4. をタップしてプロパティを保存します。
「申込者名」テキストボックスをタップして設定アイコン（）を選択します。
1. 「バインド参照」フィールドで申込者／名前を選択し、をタップしてプロパティを保存します。同様に、フォームデータモデルエンティティを使用して、「住所」、「電話番号」、「メール」、「職業」、「年収（ドル）」、「扶養家族の数」フィールドのデータバインディングを作成します。
「プレビュー」をタップして、事前入力されたアダプティブフォームフィールドの値を確認します。
必要に応じてフィールド値を変更し、アダプティブフォームを送信します。フィールド値が MySQL データベースに送信されます。データベースで applicant テーブルを更新すると、このテーブル内の更新後の値が表示されます。

ユースケース：自動フォーム変換サービスを使用して、データバインディングがないアダプティブフォームを生成し、MYSQL データベースをデータソースとして設定します。次に、ルールエディターを使用してアダプティブフォームフィールドをバインドし、フィールド値の事前入力を行います。次に、必要に応じてフィールド値を変更し、crx-repository にデータを送信します。

ルールエディターを使用してフォームデータモデルサービスを呼び出し、アダプティブフォーム内のフィールドのバインドと値の事前入力を行うには、以下の手順を実行します。

サンプルのローン申し込みフォームを output フォルダーで選択して「編集」をタップします。
「コンテンツ」タブで、以下の設定アイコンをタップします。

「基本」セクションの「事前入力サービス」ドロップダウンリストで「フォームデータモデル事前入力サービス」を選択します。
「申込者名」テキストボックスをタップしてから「ルールを編集」をタップします。
ルールエディターページで「作成」をタップします。
ルールエディターページで以下の手順を実行します。
1. 「申込者名」テキストボックスで状態を選択します。例えば、状態として「初期化された」を選択した場合、「プレビュー」モードでフォームをレンダリングすると、「Then」条件が実行されます。
2. 「Then」セクションの「アクションの選択」ドロップダウンリストで「サービスの呼び出し」を選択します。Forms インスタンス上のすべてのサービスがドロップダウンリストに表示されます。
3. フォームデータモデルが一覧表示されているセクションで「Get」サービスを選択します。「入力」セクションに「phonenumber」が表示されます。これは、applicant データモデル用に定義されたプライマリーキーです。このフィールドに基づいて、「出力」セクションのアダプティブフォームフィールド値が事前入力されます。
4. 「出力」セクションのフォームデータモデルエンティティを使用して、アダプティブフォームフィールドのデータバインディングを作成します。例えば、アダプティブフォームの「申込者名」フィールドを「name」エンティティにバインドします。
5. 「完了」をタップします。ルールエディターページで、もう一度「完了」をタップします。
「プレビュー」をタップして、事前入力されたアダプティブフォームフィールドの値を確認します。

メモ

アダプティブフォームに関連付けられているフォームデータモデルの get サービスプロパティに対して、「配列を返す」プロパティがオフに設定されていることを確認してください。
必要に応じてフィールド値を変更し、アダプティブフォームを送信します。送信後のデータは、crx-repository の以下の場所に保存されます。

http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

JSON スキーマをデータソースとして使用する

ユースケース：自動フォーム変換サービスを使用して、データバインディングがないアダプティブフォームを生成し、JSON スキーマをデータソースとして設定します。次に、アダプティブフォームの各フィールドを JSON スキーマに手動でバインドし、「データを使用してプレビュー」オプションを使用して、フィールド値の事前入力を行います。次に、必要に応じてフィールド値を変更し、crx-repository にデータを送信します。

このユースケースを実行する前に、以下を確認する必要があります。

正しい JSON スキーマが JSON スキーマ構造に対応していること
データバインディングがないアダプティブフォームが生成されていること

以下の手順を実行します。

変換後のサンプルのローン申し込みフォームを output フォルダーで選択して「プロパティ」をタップします。
「フォームモデル」タブの「選択」ドロップダウンリストで「スキーマ」を選択し、「スキーマを選択」をタップして、ローカルファイルシステムに保存されている demo.schema という JSON スキーマをアップロードします。「保存して終了」をタップしてフォームを保存します。
サンプルのローン申し込みフォームを選択して「編集」をタップします。
「申込者名」テキストボックスをタップして設定アイコン（）を選択します。

「バインド参照」フィールドで申込者／名前を選択し、をタップしてプロパティを保存します。同様に、JSON スキーマエンティティを使用して、「住所」、「電話番号」、「メール」、「職業」、「年収（ドル）」、「扶養家族の数」フィールドのデータバインディングを作成します。
変換後のサンプルのローン申し込みフォームを output フォルダーで選択し、プレビュー／データを使用してプレビューを選択します。

以下のリンクでサンプルデータファイルをダウンロードしてください：

ファイルを入手
必要に応じてフィールド値を変更し、アダプティブフォームを送信します。送信後のデータは、crx-repository の以下の場所に保存されます。

http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

XSD スキーマをデータソースとして使用する

ユースケース：自動フォーム変換サービスを使用して、データバインディングがないアダプティブフォームを生成し、XSD スキーマをデータソースとして設定します。次に、アダプティブフォームの各フィールドを XSD スキーマに手動でバインドし、「データを使用してプレビュー」オプションを使用して、フィールド値の事前入力を行います。次に、必要に応じてフィールド値を変更し、crx-repository にデータを送信します。

このユースケースを実行する前に、以下を確認する必要があります。

正しい XSD スキーマが XML スキーマ構造に対応していること
データバインディングがないアダプティブフォームが生成されていること

以下の手順を実行します。

変換後のサンプルのローン申し込みフォームを output フォルダーで選択して「プロパティ」をタップします。
「フォームモデル」タブの「選択」ドロップダウンリストで「スキーマ」を選択し、「スキーマを選択」をタップして、ローカルファイルシステムに保存されている loanapplication という XSD スキーマをアップロードします。次に、XSD スキーマのルート要素を選択し、「保存して終了」をタップしてフォームを保存します。
サンプルのローン申し込みフォームを選択して「編集」をタップします。
「申込者名」テキストボックスをタップして設定アイコン（）を選択します。
「バインド参照」フィールドで申込者／名前を選択し、をタップしてプロパティを保存します。同様に、XSD スキーマエンティティを使用して、「住所」、「電話番号」、「メール」、「職業」、「年収（ドル）」、「扶養家族の数」フィールドのデータバインディングを作成します。
変換後のサンプルのローン申し込みフォームを output フォルダーで選択し、プレビュー／データを使用してプレビューを選択します。

以下のリンクでサンプルデータファイルをダウンロードしてください：

ファイルを入手
必要に応じてフィールド値を変更し、アダプティブフォームを送信します。送信後のデータは、crx-repository の以下の場所に保存されます。

http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

JSON バインディングを持つアダプティブフォームを生成する

自動フォーム変換サービスを使用して、サンプルのローン申し込みフォームを、データバインディングを持つアダプティブフォームに変換します。アダプティブフォームを生成する際に、「データバインディングがないアダプティブフォームを生成」チェックボックスが無効になっていることを確認してください。

JSON バインディングを持つアダプティブフォーム

JSON スキーマをデータソースとして使用する

ユースケース：自動フォーム変換サービスを使用して、JSON データバインディングを持つアダプティブフォームを生成します。事前入力サービスとフォーム送信機能がシームレスに連携します。設定手順を実行する必要はありません。

以下の手順を実行する前に、データバインディングを持つアダプティブフォームが生成されていることを確認してください。

以下の手順を実行します。

変換後のサンプルのローン申し込みフォームを output フォルダーで選択し、プレビュー／データを使用してプレビューを選択します。

以下のリンクでサンプルデータファイルをダウンロードしてください：

ファイルを入手
必要に応じてフィールド値を変更し、アダプティブフォームを送信します。送信後のデータは、crx-repository の以下の場所に保存されます。

http://host name:port/crx/de/index.jsp#/content/forms/fp/admin/submit/data/latest file available in the folder

送信後のアダプティブフォームの JSON データを XML 形式に変換する

アダプティブフォームのフィールドに値を入力してフォームを送信すると、そのデータが crx-repository 内で JSON 形式に変換されます。 JSON データを XML 形式に変換するには、org.apache.sling.commons.json.xml という API を使用するか、以下のサンプルコードを使用します。

import org.apache.sling.commons.json.JSONException;
import org.apache.sling.commons.json.JSONObject;
import org.apache.sling.commons.json.xml.XML;

public class ConversionUtils {

    public static String jsonToXML(String jsonString) throws JSONException {
        //https://sling.apache.org/apidocs/sling5/org/apache/sling/commons/json/xml/XML.html#toString(java.lang.Object)
        //jar - http://maven.ibiblio.org/maven2/org/apache/sling/org.apache.sling.commons.json/2.0.18/
        //Note: Need to extract boundData part before converting to XML
        return XML.toString(new JSONObject(jsonString));
    }
}

アダプティブフォームで推奨される、データソースベースの事前入力ワークフローと送信ワークフロー

前提条件

サンプルのアダプティブフォーム

フォームモデルのデータを準備する

データバインディングがないアダプティブフォームを生成する

データベース、OData、またはその他のサードパーティ製サービスをデータソースとして使用する

JSON スキーマをデータソースとして使用する

XSD スキーマをデータソースとして使用する

JSON バインディングを持つアダプティブフォームを生成する

JSON スキーマをデータソースとして使用する

送信後のアダプティブフォームの JSON データを XML 形式に変換する

このページ

次を表示：

学習

ドキュメント

コミュニティ

サポート

リソース

アドビアカウント

Adobe