为自适应表单生成记录文档 generate-document-of-record-for-adaptive-forms
概述 overview
在提交表单后,您的客户通常希望以打印或文档格式记录他们在表单中填写的信息,以供将来参考。 这称为记录文档。
本文介绍如何为自适应表单生成记录文档。
自适应表单类型及其记录文档 adaptive-form-types-and-their-documents-of-record
创建自适应表单时,可以选择表单模型。 您的选项包括:
选择表单模型时,使用“记录模板配置文档”下提供的选项配置记录文档。 请参阅 记录模板配置文档.
自动生成的记录文档 automatically-generated-document-of-record
记录文档允许您的客户保留已提交表单的副本,以便打印。 当您自动生成记录文档时,每当您更改表单时,其记录文档都会立即更新。 例如,您删除了选择美国作为其国家/地区的客户的年龄字段。 当此类客户生成记录文档时,他们在记录文档中看不到年龄字段。
自动生成的记录文档具有以下优点:
- 它负责数据绑定。
- 它会在提交时自动隐藏标记为从记录文档中排除的字段。 无需额外努力。
- 它为记录模板文档的设计节省了时间。
- 它允许您使用不同的基本模板尝试不同的样式和外观,并为记录文档选择最佳样式和外观。 样式外观是可选的,如果未指定样式,则系统样式将设置为默认样式。
- 它可确保表格的任何更改立即反映在记录文档中。
用于自动生成记录文档的组件 components-to-automatically-generate-a-document-of-record
要为自适应表单生成记录文档,您需要以下组件:
自适应表单 要为其生成记录文档的自适应表单。
基本模板(推荐) 在AEM Designer中创建的XFA模板(XDP文件)。 基本模板用于指定记录模板文档的样式和品牌信息。
请参阅 记录文档的基本模板
记录模板文档 从自适应表单生成的XFA模板(XDP文件)。
请参阅 记录模板配置文档.
表单数据 用户在自适应表单中填写的信息。 它与记录模板文档合并,以生成记录文档。
自适应表单元素的映射 mapping-of-adaptive-form-elements
以下各节介绍自适应表单元素如何显示在记录文档中。
字段 fields
容器 containers
静态组件 static-components
表格 tables
自适应表单表组件(如页眉、页脚和行映射)映射到相应的XFA组件。 您可以将可重复面板映射到记录文档中的表。
记录文档的基本模板 base-template-of-a-document-of-record
基本模板为记录文档提供样式和外观信息。 它允许您自定义自动生成的记录文档的默认外观。 例如,您要在页眉中添加公司徽标,并在记录文档的页脚中添加版权信息。 基本模板中的主控页用作记录模板文档的主控页。 主控页面可以包含可应用于记录文档的页眉、页脚和页码等信息。 您可以使用基本模板将此类信息应用于记录文档,以自动生成记录文档。 使用基本模板可更改字段的默认属性。
请关注 基本模板约定 设计基本模板时。
基本模板约定 base-template-conventions
基本模板用于定义记录文档的页眉、页脚、样式和外观。 页眉和页脚可以包含公司徽标和版权文本等信息。 基本模板中的第一个主控页面将被复制并用作记录文档的主控页面,其中包含页眉、页脚、页码,或记录文档中所有页面中应显示的任何其他信息。 如果您使用的基本模板不符合基本模板惯例,则基本模板中的第一个主控页面仍会在记录模板文档中使用。 强烈建议您按照其惯例设计基本模板,并将其用于自动生成记录文档。
主控页面惯例
-
在基本模板中,您应将根子表单命名为
AF_METATEMPLATE
主控页面为AF_MASTERPAGE
. -
具有名称的主控页面
AF_MASTERPAGE
位于AF_METATEMPLATE
根子表单优先提取页眉、页脚和样式信息。 -
如果
AF_MASTERPAGE
不存在,则使用基础模板中存在的第一个主控页面。
字段的样式约定
-
要对记录文档中的字段应用样式,基本模板会提供位于
AF_FIELDSSUBFORM
从AF_METATEMPLATE
根子表单。 -
这些字段的属性将应用于记录文档中的字段。 这些字段应跟在
AF_<name of field in all caps>_XFO
命名约定。 例如,复选框的字段名称应为AF_CHECKBOX_XFO
.
要创建基本模板,请在AEM Designer中执行以下操作。
-
单击 文件>新建.
-
选择 基于模板 选项。
-
选择 Forms — 记录文档 类别。
-
选择 DoR基模板.
-
单击 下一个 并提供所需信息。
-
(可选)修改要应用于记录文档中字段的字段的样式和外观。
-
保存表单。
现在,您可以将保存的表单用作记录文档的基本模板。
请勿修改或删除基本模板中存在的任何脚本。
修改基本模板
- 如果不对基本模板中的字段应用任何样式,则建议从基本模板中删除这些字段,以便自动选取对基本模板的任何升级。
- 修改基本模板时,请勿删除、添加或修改脚本。
记录文档模板配置 document-of-record-template-configuration
配置表单的记录模板文档,以允许客户下载已提交表单的打印友好副本。 XDP文件用作记录模板的文档。 客户下载的记录文档会根据XDP文件中指定的布局进行格式化。
执行以下步骤来配置自适应表单的记录文档:
-
在AEM创作实例中,单击 Forms > Forms和文档。
-
选择表单,然后单击 查看属性.
-
在属性窗口中,点按 表单模型.
在创建表单时,您还可以选择表单模型。
note note NOTE 在“表单模型”(Form Model)选项卡中,确保选择 架构 或 无 从 选择自 下拉菜单。 基于XFA或以表单模板作为表单模型的自适应表单不支持记录文档。 -
在“表单模型”选项卡的“记录模板配置文档”部分中,选择以下选项之一。
无 如果不想为表单配置记录文档,请选择此选项。
将表单模板关联为记录模板文档 如果有要用作记录文档模板的XDP文件,请选择此选项。 选择此选项后,将显示AEM Forms存储库中可用的所有XDP文件。 选择相应的文件。
选定的XDP文件将与自适应表单关联。
生成记录文档 选择此选项可将XDP文件用作定义记录文档样式和外观的基本模板。 选择此选项后,将显示AEM Forms存储库中可用的所有XDP文件。 选择相应的文件。
选择此选项可将XDP文件用作定义记录文档样式和外观的基本模板。 选择此选项后,将显示AEM Forms存储库中可用的所有XDP文件。 选择相应的文件。
选择“Forms模板”作为生成记录文档的基本模板 选择此选项可将XDP文件用作定义记录文档样式和外观的基本模板。 选择此选项后,将显示AEM Forms存储库中可用的所有XDP文件。 选择相应的文件。
note note NOTE 在以下情况下,请确保用于创建XFA表单的自适应表单和模式(数据模式)的模式相同: - 您的自适应表单基于架构
- 您正在使用 将表单模板关联为记录模板文档 记录文档的选项
-
单击 完成。
自定义记录文档中的品牌信息 customize-the-branding-information-in-document-of-record
在生成记录文档时,您可以在“记录文档”选项卡上更改记录文档的品牌信息。 “记录文档”选项卡包含徽标、外观、布局、页眉和页脚、免责声明,以及是否要包含未选中的复选框和单选按钮选项等选项。
要将您在“记录文档”选项卡中输入的品牌信息本地化,您需要确保正确设置浏览器的区域设置。 要自定义记录文档的品牌信息,请完成以下步骤:
-
在记录文档中选择一个面板(根面板),然后点按 .
-
点按 . 将出现“记录文档”选项卡。
-
选择默认模板或用于呈现记录文档的自定义模板。 如果选择默认模板,则记录文档的缩略图预览将显示在“模板”下拉框的下方。
如果选择选择自定义模板,请在AEM Forms服务器上浏览选择的XDP。 如果要使用AEM Forms服务器上尚未存在的模板,则需要先将XDP上传到AEM Forms服务器。
-
根据您是选择默认模板还是自定义模板,“记录文档”选项卡中将显示以下部分或全部属性。 请相应地指定以下选项:
- 徽标图像:您可以选择使用自适应表单中的徽标图像,从DAM中选择徽标图像,或从计算机上传徽标图像。
- 表单标题
- 标题文本
- 免责声明标签
- 免责声明
- 免责声明文本
- 强调颜色:在文档或记录PDF中呈现标题文本和分隔线的颜色
- 字体系列:记录文档中文本的字体系列PDF
- 对于复选框和单选按钮组件,仅显示选定的值
- 用于多个选定值的分隔符
- 包括未绑定到数据模型的表单对象
- 从记录文档中排除隐藏字段
- 隐藏面板描述
note note NOTE 如果您使用的自适应表单模板是使用Designer版本在6.3之前创建的,要使“强调颜色”和“字体系列”属性正常工作,请确保根子表单下的自适应表单模板中存在以下内容: code language-xml <proto> <font typeface="Arial"/> <fill> <color value="4,166,203"/> </fill> <edge> <color value="4,166,203"/> </edge> </proto>
-
要保存品牌策略更改,请点按完成。
记录文档中面板的表和列布局 table-and-column-layouts-for-panels-in-document-of-record
您的自适应表单可能是一个包含多个表单字段的冗长表单。 您可能不希望将记录文档另存为自适应表单的确切副本。 现在,您可以选择表格或列布局,以在记录PDF文档中保存一个或多个自适应表单面板。
在生成记录文档之前,在面板的设置中,选择“表”或“列”作为该面板的记录文档的布局。 面板中的字段在记录文档中相应地进行组织。
在记录文档的表布局中呈现的面板中的字段
在记录文档的列布局中呈现的面板中的字段
记录文档设置 document-of-record-settings
记录文档设置允许您选择要包含在记录文档中的选项。 例如,银行以表格接受姓名、年龄、社会保障号码和电话号码。 表单会生成银行帐号和分行详细信息。 您可以选择在记录文档中仅显示名称、社会保险号、银行帐户和分行详细信息。
组件的记录设置文档位于其属性下。 要访问组件的属性,请选择该组件并单击 在叠加图中。 侧栏中列出了这些属性,您可以在其中找到以下设置。
字段级别设置
-
从记录文档中排除:将属性设置为true会从记录文档中排除该字段。 这是名为的可脚本属性
excludeFromDoR
. 其行为取决于 隐藏时从DoR中排除字段 表单级别属性。 -
将面板显示为表格: 如果面板中的字段少于6个,则设置属性会将面板显示为记录文档中的表。 仅适用于面板。
-
从记录文档中排除标题: 设置属性会从记录文档中排除面板/表的标题。 仅适用于面板和表。
-
从记录文档中排除说明: 设置属性时,会从记录文档中排除面板/表的说明。 仅适用于面板和表。
表单级别设置
- 在DoR中包含未绑定字段: 设置属性包括记录文档中基于架构的自适应表单中的未绑定字段。 默认情况下,为true。
- 隐藏时从DoR中排除字段: 设置属性会覆盖“从记录文档中排除”字段级别属性(如果不为true)的行为。 如果字段在表单提交时处于隐藏状态,则如果该属性设置为true,则它们将从记录文档中排除,但前提是未设置“从记录文档排除”属性。
使用记录文档时的主要注意事项 key-considerations-when-working-with-document-of-record
处理自适应表单的记录文档时,请记住以下注意事项和限制。
- 记录模板文档不支持富文本。 因此,静态自适应表单或最终用户填写的信息中的任何富文本都会在记录文档中显示为纯文本。
- 自适应表单中的文档片段不会显示在记录文档中。 但是,支持自适应表单片段。
- 记录文档仅用于打印目的。
- 不支持在为基于XML架构的自适应表单生成的记录文档中绑定内容。
- 不支持在为基于XML架构的自适应表单生成的记录文档中绑定内容。
- 当用户请求呈现记录文档时,根据区域设置的要求创建记录文档的本地化版本。 记录文档的本地化与自适应表单的本地化同时发生。 有关记录文档和自适应表单文档本地化的详细信息,请参阅 使用AEM翻译工作流将自适应表单和记录文档本地化.