Adobe 建议使用现代、可扩展的数据捕获核心组件,以创建新的自适应表单或将自适应表单添加到 AEM Sites 页面。这些组件代表有关创建自适应表单的重大改进,确保实现令人印象深刻的用户体验。本文介绍了使用基础组件创作自适应表单的旧方法。
版本 | 文章链接 |
---|---|
AEM 6.5 | 单击此处 |
AEM as a Cloud Service | 本文 |
填写或提交表单时,您可以以打印或文档格式保留表单记录。 此记录称为记录文档(DoR)。 这是已提交表单的打印版。 您还可以参考记录文档,以了解客户在以后日期填写的信息,或者使用记录文档以PDF格式将表单和内容存档在一起。
要创建记录文档,会将基于XFA或Acroform的模板与通过自适应表单收集的数据合并。 您可以自动或根据需要生成记录文档。
通过“按需”选项,您可以指定基于XFA或Acroform的自定义PDF模板,为记录文档提供自定义外观。
您可以:
在开始学习并准备记录文档所需的资产之前:
基本模板: 在Forms Designer或Acrobat表单(AcroForm)中创建的XFA模板(XDP文件)。 基本模板 用于指定记录文档的样式和品牌信息。 请在之前将XFA模板(XDP文件)上传到您的AEM Forms实例
自适应表单: 要为其生成记录文档的自适应表单。
将XFA模板(XDP文件)上传到AEM Forms实例。 执行以下步骤将自适应表单配置为使用XFA模板(XDP文件)作为记录文档的模板:
您的自适应表单现在配置为使用XDP文件作为记录文档的模板。 下一步是 将自适应表单组件绑定到相应的模板字段.
将Adobe AcrobatPDF(Acroform)上传到AEM Forms实例。 执行以下步骤将自适应表单配置为使用Adobe AcrobatPDF(Acroform)作为记录文档的模板:
您的自适应表单现在配置为使用Acroform作为记录文档的模板。 下一步是 将自适应表单组件绑定到相应的模板字段.
将自适应表单配置为自动生成记录文档时,每次更改表单时,都会立即更新其记录文档。 例如,如果从现有自适应表单中删除某个字段,则相应的字段也会被删除,并且在记录文档中不可见。 自动生成记录文档还有许多其他优势。 :
执行以下步骤来配置自适应表单以自动生成记录文档:
将自适应表单字段与模板字段绑定以在相应的记录文档字段显示捕获的表单数据。 要将自适应表单组件与相应的记录文档模板字段绑定,请执行以下操作:
打开自适应表单,配置为使用自定义表单模板进行编辑。
选择一个自适应表单组件,然后单击打开配置 图标。 它会打开属性浏览器。
在属性浏览器中,浏览并选择字段。
单击保存。
您可以结合使用发送电子邮件、Experience Manager工作流提交操作和 记录文档步骤和其他提交操作 以接收记录文档。
自适应表单和相应的记录文档模板会随着时间的推移而不断变化。 您可以选择向自适应表单或记录文档模板添加、删除或修改字段。
当您更改记录文档模板并将更改的记录文档模板上载到AEM Forms时,自适应Forms编辑器会自动检测更改的绑定,并通知您有关需要新绑定的自适应表单组件。 它允许您对记录文档模板进行增量更新。
例如,组织、 We.Retail,具有基于AcroForm的记录文档模板, we-retail-invoice.pdf. 模板如下所示:
在使用模板一段时间后,组织决定重命名 invoice-number
字段至 bill-number
字段和捕获购买者的电子邮件地址。 开发人员更新以下项目的名称: invoice-number
字段,并将电子邮件字段添加到模板。 他还创建了一个名为的新版本的模板 we-retail-invoice-v2.pdf.
开发人员上传更新后的模板并将其应用于自适应表单。 自适应表单自动检测并显示绑定已更改的字段列表。
表单开发人员将自适应Forms字段绑定到相应的记录文档模板。
现在,在提交自适应表单时,会创建更新的记录文档。
处理自适应Forms的记录文档时,请牢记以下注意事项和限制。
下表介绍了自适应表单组件和相应的XFA组件,以及这些组件是否显示在记录文档中。
自适应表单组件 | 对应的XFA组件 | 默认情况下包含在记录文档模板中? | 注释 |
---|---|---|---|
按钮 | 按钮 | false | |
复选框 | 复选框 | true | |
日期选取器 | 日期/时间字段 | true | |
下拉列表 | 下拉列表 | true | |
潦草签名 | 潦草签名 | true | |
数值框 | 数值字段 | true | |
密码框 | 密码字段 | false | |
单选按钮 | 单选按钮 | true | |
文本框 | 文本字段 | true | |
“重置”按钮 | “重置”按钮 | false | |
“提交”按钮 | 电子邮件提交按钮 HTTP提交按钮 |
false | |
条款和条件 | true | ||
文件附件 | false | 在记录文档模板中不可用。 仅通过附件在记录文档中可用。 |
自适应表单组件 | 对应的XFA组件 | 注释 |
---|---|---|
面板 |
子表单 |
可重复面板映射到可重复的子表单。 |
自适应表单组件 | 对应的XFA组件 | 注释 |
---|---|---|
图像 | 图像 | 除非使用记录文档设置进行排除,否则TextDraw和Image组件(无论已绑定还是未绑定)始终显示在基于XSD的自适应表单的记录文档中。 |
文本 | 文本 |
自适应Forms表组件(如页眉、页脚和行)映射到相应的XFA组件。 可将可重复面板映射到记录文档中的表格。
基本模板为记录文档提供样式和外观信息。 它允许您自定义自动生成记录文档的默认外观。 例如,您可以使用基本模板在记录文档的页眉中添加公司徽标并在页脚中添加版权信息。
基础模板中的母版页用作记录文档模板的母版页。 母版页可以包含可应用于记录文档的页眉、页脚和页码等信息。 您可以使用基本模板将此类信息应用于记录文档,以自动生成记录文档。 使用基本模板可以更改字段的默认属性。
始终关注 基本模板约定 当您设计基础模板时。
基本模板用于定义记录文档的页眉、页脚、样式和外观。 页眉和页脚可以包含公司徽标和版权文本等信息。 基础模板中的第一个母版页被复制并用作记录文档的母版页,该母版页包含页眉、页脚、页码或应在记录文档的所有页面上显示的任何其他信息。 如果使用的基础模板与基础模板约定不符,则基础模板中的第一个母版页仍用于记录文档模板中。 强烈建议您按照其约定设计基础模板,并将其用于自动生成记录文档。
母版页惯例
在基本模板中,将根子表单命名为 AF_METATEMPLATE
并且母版页为 AF_MASTERPAGE
.
具有名称的母版页 AF_MASTERPAGE
位于 AF_METATEMPLATE
根子表单最好用于提取页眉、页脚和样式信息。
如果 AF_MASTERPAGE
不存在,则使用基本模板中存在的第一个母版页。
字段的样式约定
要对记录文档中的字段应用样式,基本模板提供位于 AF_FIELDSSUBFORM
subfrom位于 AF_METATEMPLATE
根子表单。
这些字段的属性应用于记录文档中的字段。 这些字段应遵循 AF_<name of field in all caps>_XFO
命名约定。 例如,复选框的字段名称应为 AF_CHECKBOX_XFO
.
要创建基本模板,请在Forms Designer中执行以下操作。
单击 文件 > 新建.
选择 基于模板 选项。
选择 Forms — 记录文档 类别。
选择 DoR基本模板.
单击 下一个 并提供所需信息。
(可选)修改要应用于记录文档中的字段的样式和外观。
保存表单。
您现在可以将保存的表单用作记录文档的基础模板。 请勿修改或删除基本模板中存在的任何脚本。
修改基本模板
请严格遵循上述约定和说明来设计基本模板。
生成记录文档时,您可以在记录文档选项卡上更改记录文档的品牌信息。 “记录文档”选项卡包括如下选项:徽标、外观、布局、页眉和页脚、免责声明,以及是否包括未选定的复选框和单选按钮选项。
要本地化您在“记录文档”选项卡中输入的品牌信息,请确保正确设置了浏览器的区域设置。 要自定义记录文档的品牌信息,请执行以下步骤:
在记录文档中选择一个面板(根面板),然后选择 .
选择 . 此时将显示记录文档选项卡。
选择用于呈现记录文档的默认模板或自定义模板。 如果选择默认模板,则“模板”下拉菜单下方将显示记录文档的缩略图预览。
根据您选择默认模板还是自定义模板,以下某些属性或所有属性都会显示在“记录文档”选项卡中。 指定以下提及的属性以定义记录文档的外观:
基本属性:
表单字段属性:
母版页属性:
如果您使用的是使用6.3之前的Designer版本创建的自适应表单模板,为了使重音颜色和字体系列属性正常工作,请确保根子表单下的自适应表单模板中存在以下内容:
<proto>
<font typeface="Arial"/>
<fill>
<color value="4,166,203"/>
</fill>
<edge>
<color value="4,166,203"/>
</edge>
</proto>
要保存品牌策略更改,请选择 完成.
您可以配置 记录文档 直接从自适应表单编辑器或自适应表单模板编辑器中访问模板。
从自适应表单编辑器的创作实例中执行以下步骤:
选择自适应表单容器(根)组件。
单击图标来打开自适应表单容器的属性。
打开 记录文档模板 选项卡并从以下选项中进行选择:
无:选中此选项后,否 记录文档 为自适应表单创建的模板。
将表单模板关联为记录文档模板:选择此选项时,XFA表单用作记录文档的模板。
生成记录文档:如果选择此选项,则 记录文档 模板是为您的自适应表单自动生成的。
选择 以保存属性。
时间 记录文档 模板是使用自适应表单模板编辑器创建的,因此下只有两个选项可用 记录文档模板 制表符为 无 和 生成记录文档.
您的自适应表单可能很长,包含多个表单字段。 您可能不希望将记录文档另存为自适应表单的精确副本。 现在,您可以选择表格或列布局,以便在记录文档PDF中保存一个或多个自适应表单面板。
在生成记录文档之前,在面板的设置中,选择该面板的记录文档的布局(表格或列)。 面板中的字段将在记录文档中相应组织。
面板中的字段在记录文档的表格布局中渲染
面板中的字段在记录文档的列布局中渲染
记录文档设置允许您选择要包含在记录文档中的选项。 例如,银行接受表单中的姓名、年龄、社会保险号码和电话号码。 该表单会生成银行帐号和分行详细信息。 您可以选择在记录文档中仅显示名称、社会保险编号、银行帐户和分行详细信息。
记录文档组件的设置可在其属性下使用。 要访问组件的属性,请选择该组件并单击 在覆盖图中。 这些属性列在侧边栏中,您可以在该侧边栏中找到以下设置。
字段级设置
从记录文档排除:将属性设置为true会从记录文档排除字段。 这是名为的可编写脚本的属性 excludeFromDoR
. 其行为取决于 若隐藏自DoR排除栏位 表单级别属性。
将面板显示为表格: 如果面板中的字段少于6个,设置属性会在记录文档中将面板显示为表格。 仅适用于面板。
从记录文档排除标题: 设置属性会从记录文档中排除面板/表的标题。 仅适用于面板和表格。
从记录文档排除描述: 设置属性会从记录文档中排除面板/表的描述。 仅适用于面板和表格。
表单级别设置
XCI文件可帮助您设置文档的各种属性。 Formsas a Cloud Service有一个主XCI文件。 您可以使用自定义XCI文件覆盖主XCI文件中指定的一个或多个默认属性。 例如,您可以选择将字体嵌入文档,或者为所有文档启用标记属性。 下表指定了XCI选项:
XCI选项 | 描述 |
---|---|
config/present/pdf/creator | 使用文档信息词典中的创建者条目标识文档创建者。 有关此词典的信息,请参见 PDF参考指南. |
config/present/pdf/producer | 使用文档信息词典中的制作者条目标识文档制作者。 有关此词典的信息,请参见 PDF参考指南. |
config/present/layout | 控制输出是单个面板还是分页。 |
config/present/pdf/compression/level | 指定生成PDF文档时使用的压缩程度。 |
config/present/pdf/fontInfo/embed | 控制输出文档中的字体嵌入。 |
config/present/pdf/scriptModel | 控制输出PDF文档中是否包含XFA特定的信息。 |
config/present/common/data/adjustData | 控制XFA应用程序在合并后是否调整数据。 |
config/present/pdf/renderPolicy | 控制页面内容的生成是在服务器上完成还是延迟到客户端。 |
config/present/common/locale | 指定输出文档中使用的默认区域设置。 |
config/present/destination | 当由当前元素包含时,指定输出格式。 当由openAction元素包含时,指定在交互式客户端中打开文档时要执行的操作。 |
config/present/output/type | 指定要应用于文件的压缩类型或要生成的输出类型。 |
config/present/common/temp/uri | 指定表单URI。 |
config/present/common/template/base | 在表单设计中提供URI的基本位置。 当此元素不存在或为空时,将使用窗体设计的位置作为基础。 |
config/present/common/log/to | 控制日志数据或输出数据写入的位置。 |
config/present/output/to | 控制日志数据或输出数据写入的位置。 |
config/present/script/currentPage | 指定文档打开时的初始页面。 |
config/present/script/exclude | 通知Formsas a Cloud Service忽略哪些事件。 |
config/present/pdf/linearized | 控制输出PDF文档是否线性化。 |
config/present/script/runScripts | 控制Formsas a Cloud Service执行的脚本集。 |
config/present/pdf/tagged | 控制标签在输出PDF文档中的包含。 在PDF上下文中,标记是文档中包含的其他信息,用于公开文档的逻辑结构。 标记有助于辅助功能和重新设置格式。 例如,页码可能会被标记为工件,这样屏幕阅读器就不会在文本中间朗读它。 虽然标记可以使文档更有用,但它们也会增加文档的大小以及创建文档所需的处理时间。 |
config/present/pdf/fontInfo/alwaysEmbed | 指定嵌入到输出文档中的字体。 |
config/present/pdf/fontInfo/neverEmbed | 指定不得嵌入到输出文档中的字体。 |
config/present/pdf/pdfa/part | 指定文档符合的PDF/A规范的版本号。 |
config/present/pdf/pdfa/amd | 指定PDF/A规范的修订级别。 |
config/present/pdf/pdfa/conformance | 指定PDF/A规范的符合性级别。 |
config/present/pdf/version | 指定要生成的PDF文档的版本 |
config/present/pdf/version/map | 指定文档的回退字体 |
将自定义XCI文件添加到您的开发项目中。
指定以下内容 内联属性:
{
"xciFilePath": "[path of XCI file]"
}
例如,
{
"xciFilePath": "/content/dam/formsanddocuments/customMinionProBoldAndTagged.xci"
}
将项目部署到Cloud Service环境。