アダプティブフォームのセットを使用したアダプティブフォームの作成 create-an-adaptive-form-using-a-set-of-adaptive-forms

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

ユーザー
開発者

アダプティブフォームの新規作成または AEM Sites ページへのアダプティブフォームの追加には、最新の拡張可能なデータキャプチャコアコンポーネントを使用することをお勧めします。これらのコンポーネントは、アダプティブフォームの作成における大幅な進歩を表し、ユーザーエクスペリエンスの向上を実現します。この記事では、基盤コンポーネントを使用してアダプティブフォームを作成する古い方法について説明します。

概要 overview

銀行口座の開設の申し込みなどのワークフローでは、ユーザーは複数のフォームに記入します。一連のフォームに記入してもらう代わりに、フォームを積み重ねて大きなフォーム（親フォーム）を作成できます。大きなフォームにアダプティブフォームを追加すると、パネル（子フォーム）として追加されます。一連の子フォームを追加して、親フォームを作成します。ユーザーの入力に基づいて、パネルの表示と非表示を切り替えることができます。親フォームのボタン（送信やリセットなど）は、子フォームのボタンを上書きします。親フォームにアダプティブフォームを追加するには、アダプティブフォームを（アダプティブフォームフラグメントと同様に）アセットブラウザーからドラッグ＆ドロップします。

使用できる機能は、次のとおりです。

独立オーサリング
適切なフォームの表示／非表示
遅延読み込み

独立オーサリングや遅延読み込みなどの機能を使用すると、個々のコンポーネントを使用して親フォームを作成する場合のパフォーマンスが向上します。

NOTE

XFA ベースのアダプティブフォームやフラグメントは、子フォームまたは親フォームとして使用することはできません。

機能の仕組み behind-the-scenes

親フォームに XSD ベースのアダプティブフォームとフラグメントを追加できます。親フォームの構造は任意のアダプティブフォームと同様です。アダプティブフォームを子フォームとして追加すると、親フォームのパネルとして追加されます。バインドされた子フォームのデータは、親フォームの XML スキーマの afBoundData セクションの data ルートに保存されます。

例えば、顧客がアプリケーションフォームに入力するとします。フォームの最初の 2 つのフィールドは、名前と ID です。XML は次のようになります。

<afData>
    <afUnboundData>
        <data />
    </afUnboundData>
    <afBoundData>
        <data xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
            <applicantName>Sarah Rose</applicantName>
            <applicantId>1234</applicantId>
        </data>
    </afBoundData>
</afData>

顧客がオフィスの住所を入力できるフォームをアプリケーションに追加します。子フォームのスキーマのルートは officeAddress です。bindref、/application/officeAddress または /officeAddress を適用します。bindref がない場合、子フォームが officeAddress サブツリーとして追加されます。以下のフォームの XML を参照してください。

<afData>
    <afUnboundData>
        <data />
    </afUnboundData>
    <afBoundData>
        <data xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
            <applicantName>Sarah Rose</applicantName>
            <applicantId>1234</applicantId>
            <officeAddress>
                <addressLine>1, Geometrixx City</addressLine>
                <zip>11111</zip>
            </officeAddress>
        </data>
    </afBoundData>
</afData>

顧客が住所を入力できる別のフォームを挿入する場合は、bindref /application/houseAddress or /houseAddress.を適用すると、XML は次のようになります。

<afData>
    <afUnboundData>
        <data />
    </afUnboundData>
    <afBoundData>
        <data xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
            <applicantName>Sarah Rose</applicantName>
            <applicantId>1234</applicantId>
            <officeAddress>
                <addressLine>1, Geometrixx City</addressLine>
                <zip>11111</zip>
            </officeAddress>
            <houseAddress>
                <addressLine>2, Geometrixx City</addressLine>
                <zip>11111</zip>
            </houseAddress>
        </data>
    </afBoundData>
</afData>

スキーマのルートと同じサブルート名にするには、（この例ではAddress ）、インデックス付きの bindref を使用します。

例えば、bindref /application/address[1] または /address[1] および /application/address[2] または /address[2] を適用します。このフォームの XML は、以下のようになります。

<afData>
    <afUnboundData>
        <data />
    </afUnboundData>
    <afBoundData>
        <data xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
            <applicantName>Sarah Rose</applicantName>
            <applicantId>1234</applicantId>
            <address>
                <addressLine>1, Geometrixx City</addressLine>
                <zip>11111</zip>
            </address>
            <address>
                <addressLine>2, Geometrixx City</addressLine>
                <zip>11111</zip>
            </address>
        </data>
    </afBoundData>
</afData>

bindRef プロパティを使用して、フォームまたはフラグメントのデフォルトサブツリーを変更することができます。bindRef プロパティにより、XML スキーマのツリー構造における位置を示すパスを指定できます。

バインドされていない子フォームのデータは、親フォームの XML スキーマの afUnboundData セクションの data ルートに保存されます。

アダプティブフォームを子フォームとして、複数回追加できます。bindRef が正しく修正されて、アダプティブフォームの各使用済みインスタンスが、データルート上で異なるサブルートを指定するようにします。

NOTE

異なるフォームやフラグメントが同じサブルートにマッピングされている場合、データは上書きされます。