アダプティブフォームのフィールドの事前入力 prefill-adaptive-form-fields

既存データを使用して、アダプティブフォームのフィールドを事前入力します。

はじめに introduction

既存のデータを使用して、アダプティブフォームのフィールドに事前に値を設定することができます。 ユーザーがフォームを開くと、これらのフィールドの値は事前入力されています。アダプティブフォーム内のデータを事前入力するには、アダプティブフォームの事前入力データ構造に準拠した形式で、ユーザーデータを事前入力 XML/JSON として使用できるようにします。

事前入力データの構造 the-prefill-structure

アダプティブフォームには、連結されたフィールドと連結されていないフィールドが混在している場合があります。連結されたフィールドは、「コンテンツファインダー」タブからドラッグされたフィールドです。フィールドの編集ダイアログには、空ではない bindRef プロパティ値が含まれています。連結されていないフィールドは、サイドキックのコンポーネントブラウザーから直接ドラッグされ、bindRef 値が含まれています。

アダプティブフォームの連結されたフィールドと連結されていないフィールドの両方を事前に入力することができます。 事前入力データには、アダプティブフォームの連結されたフィールドと連結されていないフィールドの両方を事前入力する afBoundData セクションと afUnBoundData セクションが含まれています。 afBoundData セクションには連結されたフィールドとパネルの事前入力データが含まれています。このデータは関連するフォームモデルスキーマに準拠している必要があります。

事前入力 XML 構造のサンプル sample-prefill-xml-structure

<?xml version="1.0" encoding="UTF-8"?>
<afData>
  <afBoundData>
     <employeeData>
        .
     </employeeData>
  </afBoundData>

  <afUnboundData>
    <data>
      <textbox>Hello World</textbox>
         .
         .
      <numericbox>12</numericbox>
         .
         .
    </data>
  </afUnboundData>
</afData>

事前入力 JSON 構造のサンプル sample-prefill-json-structure

{
   "afBoundData": {
      "employeeData": { }
   },
   "afUnboundData": {
      "data": {
         "textbox": "Hello World",
         "numericbox": "12"
      }
   }
}

同じ bindref を持つ連結されているフィールド、または同じ名前を持つ連結されていないフィールドの場合、XML タグまたは JSON オブジェクトで指定したデータがすべてのフィールドに入力されます。例えば、フォーム内の 2 つのフィールドは、事前入力データの名前 textbox にマップされます。ランタイム時、最初のテキストボックスに「A」が含まれる場合、この「A」が 2 番目のテキストボックスに自動的に挿入されます。このリンクは、アダプティブフォームフィールドのライブリンクと呼ばれます。

XFA フォームテンプレートを使用したアダプティブフォーム xfa-based-af

XFA ベースのアダプティブフォームの事前入力 XML と送信済み XML の構造は次のとおりです。

Prefill-Submit-Data-ContentPackage.zip

ファイルを取得
事前入力データと送信済みデータが含まれているサンプル

XML スキーマベースのアダプティブフォーム  xml-schema-af

XML スキーマに基づくアダプティブフォームの事前入力 XML と送信済み XML の構造は、次のとおりです。

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

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

    <xs:complexType name="SampleType">
        <xs:sequence>
            <xs:element name="noOfProjectsAssigned" type="xs:string"/>
        </xs:sequence>
    </xs:complexType>
</xs:schema>

XML スキーマをモデルとするフィールドの場合、以下の XML のサンプルに示すように、afBoundData タグのデータは事前入力されます。これは、1 つ以上の連結されていないテキストフィールドでアダプティブフォームを事前入力する場合に使用できます。

<?xml version="1.0" encoding="UTF-8"?><afData>
  <afUnboundData>
    <data>
      <textbox>Ignorance is bliss :) </textbox>
    </data>
  </afUnboundData>
  <afBoundData>
    <data>
      <noOfProjectsAssigned>twelve</noOfProjectsAssigned>
    </data>
  </afBoundData>
</afData>

afData および afBoundData ラッパーを使用しない例 an-example-without-afdata-and-afbounddata-wrapper

<?xml version="1.0" encoding="UTF-8"?><config>
 <assignmentDetails descriptionOfAssignment="Some Science Project" durationOfAssignment="34" financeRelatedProject="1" name="Lisa" numberOfMentees="1"/>
 <assignmentDetails descriptionOfAssignment="Kidding, right?" durationOfAssignment="4" financeRelatedProject="1" name="House" numberOfMentees="3"/>
</config>

JSON スキーマベースのアダプティブフォーム json-schema-based-adaptive-forms

JSON スキーマに基づくアダプティブフォームの場合、事前入力 JSON と送信済み JSON の構造を以下に示します。 詳しくは、 JSON スキーマを使用したアダプティブフォームの作成.

{
    "id": "https://some.site.somewhere/entry-schema#",
    "$schema": "https://json-schema.org/draft-04/schema#",
    "type": "object",
    "properties": {
        "address": {
            "type": "object",
            "properties": {
    "name": {
     "type": "string"
    },
    "age": {
     "type": "integer"
}}}}}

JSON スキーマモデルを使用するフィールドの場合、以下の JSON のサンプルに示すように、afBoundData オブジェクトのデータは事前入力されます。これは、1 つ以上の連結されていないテキストフィールドでアダプティブフォームを事前入力する場合に使用できます。以下は afData/afBoundData ラッパーが含まれるデータの一例です。

{
  "afData": {
    "afUnboundData": {
      "data": { "textbox": "Ignorance is bliss :) " }
    },
    "afBoundData": {
      "data": { {
   "user": {
    "address": {
     "city": "Noida",
     "country": "India"
}}}}}}}

以下は afData/afBoundData ラッパーが含まれない場合の一例です。

{
 "user": {
  "address": {
   "city": "Noida",
   "country": "India"
}}}

フォームモデルのないアダプティブフォーム adaptive-form-with-no-form-model

フォームモデルが含まれていないアダプティブフォームの場合、すべてのフィールドのデータは、<afUnboundData> tag の <data> タグの下にあります。

また、次の点にも注意してください。

各種フィールドに送信されたユーザーデータのための XML タグは、フィールド名を使用して生成されます。したがって、フィールド名は一意である必要があります。

<?xml version="1.0" encoding="UTF-8"?><afData>
  <afUnboundData>
    <data>
      <radiobutton>2</radiobutton>
      <repeatable_panel_no_form_model>
        <numericbox>12</numericbox>
      </repeatable_panel_no_form_model>
      <repeatable_panel_no_form_model>
        <numericbox>21</numericbox>
      </repeatable_panel_no_form_model>
      <checkbox>2</checkbox>
      <textbox>Nopes</textbox>
    </data>
  </afUnboundData>
  <afBoundData/>
</afData>

設定マネージャーを使用した事前入力サービスの設定 configuring-prefill-service-using-configuration-manager

事前入力サービスを有効にするには、AEM Web コンソール設定で「デフォルトの事前入力サービス設定」を指定する必要があります。次の手順を使用して、事前入力サービスを設定します。

繰り返し可能なパネルの好奇心が強いケース the-curious-case-of-repeatable-panels

通常、連結（フォームスキーマ）フィールドと連結されていないフィールドは、同じアダプティブフォームで作成されますが、連結が繰り返し可能な場合に、次の例外がいくつかあります。

ユーザーデータの事前入力でサポートされるプロトコル supported-protocols-for-prefilling-user-data

有効な正規表現を使用して設定されている場合は、以下のプロトコルを使用して、事前入力データ形式のユーザーデータでアダプティブフォームを事前入力することができます。

The crx:// protocol the-crx-protocol

http://localhost:4502/content/forms/af/xml.html?wcmmode=disabled&dataRef=crx:///tmp/fd/af/myassets/sample.xml

特定のノードには、jcr:data と呼ばれるプロパティがあり、データを保持していなければなりません。

The file:// protocol the-file-protocol-nbsp

http://localhost:4502/content/forms/af/someAF.html?wcmmode=disabled&dataRef=file:///C:/Users/form-user/Downloads/somesamplexml.xml

参照元ファイルは、同じサーバー上になければなりません。

The https:// protocol the-http-protocol

http://localhost:4502/content/forms/af/xml.html?wcmmode=disabled&dataRef=http://localhost:8000/somesamplexmlfile.xml

service:// プロトコル the-service-protocol

http://localhost:4502/content/forms/af/abc.html?wcmmode=disabled&dataRef=service://[SERVICE_NAME]/[IDENTIFIER]

slingRequest でのデータ属性の設定 setting-data-attribute-in-slingrequest

以下のサンプルコードが示すように、data 属性が XML または JSON を含む文字列である、slingRequest の data 属性を設定することもできます（以下は XML が含まれている場合の例です）。

<%
           String dataXML="<afData>" +
                            "<afUnboundData>" +
                                "<data>" +
                                    "<first_name>"+ "Tyler" + "</first_name>" +
                                    "<last_name>"+ "Durden " + "</last_name>" +
                                    "<gender>"+ "Male" + "</gender>" +
                                    "<location>"+ "Texas" + "</location>" +
                                    "</data>" +
                            "</afUnboundData>" +
                        "</afData>";
        slingRequest.setAttribute("data", dataXML);
%>

すべてのデータを含む単純な XML または JSON 文字列を記述し、slingRequest に設定できます。 これは、slingRequest data 属性を設定するページに含むすべてのコンポーネントのレンダラー JSP で、簡単にできます。

例えば、特定のタイプのヘッダーを持つページに特定のデザインを使用する場合などです。 これを達成するには、頁コンポーネントに含んで、header.jsp 属性を設定することができる独自の data を作成します。

例えば、Facebook、Twitter、LinkedIn などのソーシャルアカウントを使用して、ログイン時にデータを事前入力するとします。この場合、header.jspユーザーアカウントからデータを取得し、データパラメーターを設定するに単純な JSP を含めることができます。

prefill-page component.zip

ファイルを取得
ページコンポーネントのサンプル prefill.jsp

AEM Forms カスタム事前入力サービス aem-forms-custom-prefill-service

事前定義されたソースからデータを頻繁に読み取る必要がある場合は、カスタム事前入力サービスを使用できます。事前入力サービスは、定義済みのデータソースからデータを読み取り、事前入力データファイルの内容を使用して、アダプティブフォームのフィールドに事前入力します。 事前入力データをアダプティブフォームと永続的に関連付ける場合にも役立ちます。

事前入力サービスの作成と実行 create-and-run-a-prefill-service

事前入力サービスは OSGi サービスで、OSGi バンドルを使用してパッケージ化します。OSGi バンドルを作成し、アップロードして、AEM Formsバンドルにインストールします。 バンドルの作成を開始する前に、以下を行います。

事前入力サービスの作成 create-a-prefill-service

ボイラープレートパッケージ（サンプルの事前入力サービスパッケージ）には、AEM Forms事前入力サービスのサンプル実装が含まれています。 コードエディターでテンプレートパッケージを開きます。 例えば、Eclipse でテンプレートプロジェクトを開いて編集します。 コードエディターでテンプレートパッケージを開いた後、次の手順を実行してサービスを作成します。

事前入力サービスを開始して使用する start-and-use-the-prefill-service

事前入力サービスを起動するには、JAR ファイルを AEM Forms Web コンソールにアップロードし、サービスをアクティブ化します。これで、変換サービスがアダプティブフォームエディターに表示され始めます。 事前入力サービスをアダプティブフォームに関連付けるには、次の手順を実行します。