預填最適化表單欄位 prefill-adaptive-form-fields

使用現有資料預填最適化表單的欄位。

簡介 introduction

您可以使用現有資料預先填寫最適化表單的欄位。 使用者開啟表單時，會預填這些欄位的值。 若要在最適化表單中預填資料，請以符合預填適用性表單資料結構的格式，將使用者資料以預填XML/JSON的形式提供。

預填資料的結構 the-prefill-structure

最適化表單可以混合綁定和未綁定欄位。 系結欄位是從「內容尋找器」標籤拖曳而包含非空白的欄位 bindRef 屬性值（在「編輯」欄位中）。 未綁定欄位直接從Sidekick的元件瀏覽器拖動，且為空 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"
      }
   }
}

對於具有相同綁定欄位或具有相同名稱的未綁定欄位，在XML標籤或JSON對象中指定的資料將填充到所有欄位中。 例如，表單中的兩個欄位會對應至名稱 textbox 填入資料。 在執行階段中，如果第一個文字方塊欄位包含「A」，則會自動填入第二個文字方塊中的「A」。 此連結稱為適用性表單欄位的即時連結。

使用XFA表單範本的最適化表單 xfa-based-af

預填XML和針對XFA適用性表單提交的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架構的欄位，資料會預先填入 afBoundData 標籤，如下列範例XML所示。 它可用於使用一個或多個未綁定的文本欄位預先填寫最適化表單。

<?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結構描述模型的欄位，資料會預先填入afBoundData物件，如下方範例JSON所示。 它可用於使用一個或多個未綁定的文本欄位預先填寫最適化表單。 以下是資料的範例，其中 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

若為沒有表單模型的適用性表單，所有欄位的資料位於 <data> 標籤 <afUnboundData> tag.

另外，請注意以下事項：

系統會使用欄位名稱，產生針對針對各種欄位提交之使用者資料的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>

使用Configuration Manager配置預填服務 configuring-prefill-service-using-configuration-manager

若要啟用預填服務，請在AEM Web主控台設定中指定預設預填服務設定。 使用下列步驟來設定預填服務：

可重複面板的奇特案例 the-curious-case-of-repeatable-panels

一般而言，系結（表單結構）和未系結欄位是以相同的最適化表單撰寫，但若系結可重複，以下是幾個例外：

預填使用者資料的支援通訊協定 supported-protocols-for-prefilling-user-data

使用有效的規則運算式設定時，可透過下列通訊協定，以預填資料格式預先填入使用者資料：

crx://協定 the-crx-protocol

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

指定的節點必須具有名為的屬性 jcr:data 並保存資料。

file://協定  the-file-protocol-nbsp

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

引用的檔案必須位於同一伺服器上。

https://協定 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 屬性 slingRequest，其中 data 屬性是包含XML或JSON的字串，如以下范常式式碼所示（範例為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中加以設定。 您可以在任何元件的轉譯器JSP中輕鬆完成這項作業，您可在其中設定slingRequest資料屬性的頁面中納入這些元件。

例如，您想要以特定類型的標題為頁面進行特定設計。 要達到此目的，您可以自行撰寫 header.jsp，您可將其納入頁面元件中，並設定 data 屬性。

另一個好的範例是您想要透過Facebook、Twitter或LinkedIn等社交帳戶預先填入登入資料的使用案例。 在這種情況下，可以在 header.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 Console，然後啟用服務。 現在，服務會開始出現在最適化表單編輯器中。 將預填服務與最適化表單關聯：