预填自适应表单字段 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

基于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架构的字段，数据将预填充到 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>

使用配置管理器配置预填充服务 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，然后激活该服务。 现在，服务开始在自适应表单编辑器中显示。 要将预填充服务与自适应表单关联，请执行以下操作：