Adobe建议使用现代化的、可扩展的数据捕获 核心组件 对象 创建新的自适应Forms 或 将自适应Forms添加到AEM Sites页面. 这些组件在创建自适应Forms方面实现了重大进步,确保了令人印象深刻的用户体验。 本文介绍了使用基础组件创作自适应Forms的旧方法。
版本 | 文章链接 |
---|---|
AEM as a Cloud Service | 单击此处 |
AEM 6.5 | 本文 |
您可以使用现有数据预填自适应表单的字段。 当用户打开表单时,这些字段的值会预先填充。 要在自适应表单中预填充数据,请按照自适应表单预填充数据结构所遵循的格式使用户数据可用作预填充XML/JSON。
自适应表单可以包含绑定字段和未绑定字段的混合。 绑定字段是从“内容查找器”选项卡拖动并包含非空的字段 bindRef
字段编辑对话框中的属性值。 未绑定的字段直接从Sidekick的组件浏览器中拖动,并且为空 bindRef
值。
您可以预填充自适应表单的绑定和未绑定字段。 预填充数据包含afBoundData和afUnBoundData部分,用于预填充自适应表单的绑定和未绑定字段。 此 afBoundData
部分包含绑定字段和面板的预填充数据。 此数据必须符合关联的表单模型架构:
<?xml version="1.0" encoding="UTF-8"?>
<afData>
<afBoundData>
<employeeData>
.
</employeeData>
</afBoundData>
<afUnboundData>
<data>
<textbox>Hello World</textbox>
.
.
<numericbox>12</numericbox>
.
.
</data>
</afUnboundData>
</afData>
{
"afBoundData": {
"employeeData": { }
},
"afUnboundData": {
"data": {
"textbox": "Hello World",
"numericbox": "12"
}
}
}
对于同名的绑定字段或未绑定字段,所有字段中都会填充XML标记或JSON对象中指定的数据。 例如,表单中的两个字段映射到名称 textbox
在预填充数据中。 在运行时,如果第一个文本框字段包含“A”,则“A”会自动填充到第二个文本框中。 此链接称为自适应表单字段的实时链接。
基于XFA的自适应表单的预填充XML和提交的XML的结构如下:
预填充XML结构:基于XFA的自适应表单的预填充XML必须与XFA表单模板的数据架构兼容。 要预填充未绑定的字段,请将预填充XML结构封装到 /afData/afBoundData
标记之前。
已提交的XML结构:当不使用预填充XML时,提交的XML包含中绑定和未绑定字段的数据 afData
包装器标记。 如果使用预填充XML,则提交的XML具有与预填充XML相同的结构。 如果预填充XML以 afData
根标记时,输出XML的格式也相同。 如果预填充XML没有 afData/afBoundData
包装器,而是直接从架构根标记开始,如 employeeData
,提交的XML也以 employeeData
标记之前。
Prefill-Submit-Data-ContentPackage.zip
获取文件
包含预填充数据和已提交数据的示例
基于XML架构的自适应表单预填充XML和提交XML的结构如下:
afData
包装器标记。 如果使用预填充XML,则提交的XML具有与预填充XML相同的结构。 如果预填充XML以 afData
根标记时,输出XML的格式相同。 如果预填充XML没有 afData/afBoundData
包装而不是直接从架构根标记开始,如 employeeData
,提交的XML也以 employeeData
标记之前。<?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>
建议不要在绑定面板(具有非空的面板)中使用未绑定字段 bindRef
(通过从Sidekick或“数据源”选项卡拖动组件而创建)。 它可能会导致这些未绑定字段的数据丢失。 此外,建议整个表单中的字段名称是唯一的,尤其是未绑定的字段。
<?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和提交的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"
}}}
在绑定面板(具有非空bindRef的面板,这些面板是通过从Sidekick或“数据源”选项卡拖动组件创建的)中使用未绑定字段是 非 建议这样做,因为它可能会导致未绑定字段的数据丢失。 建议在表单中保留唯一的字段名称,尤其是未绑定的字段。
对于没有表单模型的自适应表单,所有字段的数据都位于 <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>
要启用预填充服务,请在AEM Web控制台配置中指定默认预填充服务配置。 使用以下步骤配置预填充服务:
预填充服务配置适用于自适应表单、HTML5表单和HTML5表单集。
打开 Adobe Experience Manager Web控制台配置 通过使用URL:
https://<server>:<port>/system/console/configMgr
搜索并打开 默认预填充服务配置.
输入的数据位置或正则表达式 数据文件位置. 有效数据文件位置的示例包括:
默认情况下,所有类型的自适应Forms(XSD、XDP、JSON、FDM和不基于表单模型)都允许通过crx文件预填充。 仅允许对JSON和XML文件使用预填充。
现在已为您的表单配置了预填充服务。
crx协议负责预填充的数据安全性,因此默认情况下允许使用。 使用通用正则表达式通过其他协议进行预填充可能会导致漏洞。 在配置中,指定用于保护数据的安全URL配置。
通常,绑定(表单架构)和未绑定字段以相同的自适应表单创作,但如果绑定可重复,以下是一些例外情况:
根据经验,如果绑定字段和未绑定字段在最终用户填充的数据中相交,请勿将它们混合在一起。 如果可能,您应该修改架构或XFA表单模板,并为未绑定的字段添加一个条目,这样该字段也会绑定,并且其数据就像提交数据中的其他字段一样可用。
使用有效的正则表达式配置时,可以通过以下协议使用预填充数据格式的用户数据预填充自适应表单:
https://localhost:4502/content/forms/af/xml.html?wcmmode=disabled&dataRef=crx:///tmp/fd/af/myassets/sample.xml
指定的节点必须具有名为的属性 jcr:data
保存数据。
https://localhost:4502/content/forms/af/someAF.html?wcmmode=disabled&dataRef=file:///C:/Users/form-user/Downloads/somesamplexml.xml
引用的文件必须位于同一服务器上。
https://localhost:4502/content/forms/af/xml.html?wcmmode=disabled&dataRef=https://localhost:8000/somesamplexmlfile.xml
https://localhost:4502/content/forms/af/abc.html?wcmmode=disabled&dataRef=service://[SERVICE_NAME]/[IDENTIFIER]
不支持传递身份验证参数。
您还可以设置 data
中的属性 slingRequest
,其中 data
attribute是包含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等社交帐户登录时预填充数据。 在这种情况下,您可以在中包含一个简单的JSP header.jsp
,从用户帐户中获取数据并设置数据参数。
预填充页面component.zip
获取文件
页面组件中的prefill.jsp示例
您可以对场景使用自定义预填充服务,在这些场景中,您会不断从预定义的源中读取数据。 预填充服务从定义的数据源中读取数据,并使用预填充数据文件的内容预填充自适应表单的字段。 它还有助于您将预填数据与自适应表单永久关联。
预填充服务是一种OSGi服务,通过OSGi捆绑包进行打包。 您可以创建OSGi捆绑包,将其上传并安装到AEM Forms捆绑包。 开始创建捆绑包之前:
下载样板包
将数据(预填充数据)文件放入crx存储库中。 可以将文件放置在crx-repository的\contents文件夹中的任意位置。
样板包(示例预填充服务包)包含AEM Forms预填充服务的示例实现。 在代码编辑器中打开样板包。 例如,在Eclipse中打开样板项目进行编辑。 在代码编辑器中打开样板包后,请执行以下步骤,以创建该服务。
打开src\main\java\com\adobe\test\Prefill.java文件进行编辑。
在代码中,将值设置为:
nodePath:
指向crx存储库位置的节点路径变量包含数据(预填充)文件的路径。 例如, /content/prefilldata.xmllabel:
label参数指定服务的显示名称。 例如,默认预填充服务保存并关闭 Prefill.java
文件。
添加 AEM Forms Client SDK
包到样板项目的生成路径。
编译项目并为包创建.jar。
要启动预填充服务,请将JAR文件上传到AEM Forms Web控制台,然后激活该服务。 现在,该服务开始出现在自适应表单编辑器中。 要将预填充服务与自适应表单关联,请执行以下操作:
预填自适应表单时,AEM Forms服务器会将数据与自适应表单合并,并将填写的表单交付给您。 默认情况下,数据合并操作在服务器上执行。
您可以将AEM Forms服务器配置为在客户端而不是服务器上执行数据合并操作。 它显着缩短了预填充和渲染自适应表单所需的时间。 默认情况下,该功能处于禁用状态。 您可以从Configuration Manager或命令行启用它。
要从配置管理器启用或禁用,请执行以下操作:
要从命令行启用或禁用,请执行以下操作:
要启用,请运行以下cURL命令:
curl -u admin:admin -X POST -d apply=true \ -d propertylist=af.clientside.datamerge.enabled \ -d af.clientside.datamerge.enabled=true \ http://${crx.host}:${crx.port}/system/console/configMgr/Adaptive%20Form%20and%20Interactive%20Communication%20Web%20Channel%20Configuration
要禁用,请运行以下cURL命令:
curl -u admin:admin -X POST -d apply=true \ -d propertylist=af.clientside.datamerge.enabled \ -d af.clientside.datamerge.enabled=false \ http://${crx.host}:${crx.port}/system/console/configMgr/Adaptive%20Form%20and%20Interactive%20Communication%20Web%20Channel%20Configuration