生成自适应Forms记录文档(核心组件)

上次更新: 2023-12-12

概述

填写或提交表单时,您可以保留表单的记录(打印或文档格式)。 此记录称为记录文档(DoR)。 这是已提交表单的打印版。 您还可以参考记录文档,以了解客户在以后日期填写的信息,或者使用记录文档以PDF格式将表单和内容存档在一起。

记录文档

要创建记录文档,会将基于XFA或Acroform的模板与通过自适应表单收集的数据合并。 您可以自动或根据需要生成记录文档。 通过“按需”选项,您可以指定基于XFA或Acroform的自定义PDF模板,为记录文档提供自定义外观。

您可以:

开始之前

在开始学习并准备记录文档所需的资产之前:

基本模板: 在Forms Designer或Acrobat表单(AcroForm)中创建的XFA模板(XDP文件)。 基本模板 用于指定记录文档的样式和品牌信息。 之前需将XFA模板(XDP文件)上传到AEM Forms实例。

自适应表单: 要为其生成记录文档的自适应表单。

生成基于XFA的记录文档

将XFA模板(XDP文件)上传到AEM Forms实例。 执行以下步骤将自适应表单配置为使用XFA模板(XDP文件)作为记录文档的模板:

  1. 在Experience Manager创作实例中,单击 Forms > Forms和文档.
  2. 选择表单或创建自适应表单,然后单击 属性.
  3. 在“属性”窗口中,选择 表单模型.
  4. 表单模型 选项卡,在 选择自 下拉列表,选择 表单数据模型架构. 您还可以在创建表单时选择表单模型。
  5. 在表单模型选项卡的记录文档模板配置部分中,选择 将表单模板关联为记录文档模板. 选择此选项时,将显示计算机上可用的所有XFA模板(XDP文件)。 选择相应的文件。 此外,请确保自适应表单和选定的XFA模板(XDP文件)使用相同的架构(数据架构)。
  6. 单击 完成。

您的自适应表单现在配置为使用XDP文件作为记录文档的模板。 下一步是 将自适应表单组件绑定到相应的模板字段.

生成基于Acroform的记录文档

将Adobe AcrobatPDF(Acroform)上传到AEM Forms实例。 执行以下步骤将自适应表单配置为使用Adobe AcrobatPDF(Acroform)作为记录文档的模板:

  1. 在Experience Manager创作实例中,单击 Forms > Forms和文档.
  2. 选择表单或 创建自适应表单,然后单击 属性.
  3. 在“属性”窗口中,选择 表单模型.
  4. 表单模型 选项卡,在 选择自 下拉列表,选择 表单数据模型架构. 您还可以在创建表单时选择表单模型。
  5. 在表单模型选项卡的记录文档模板配置部分中,选择 将表单模板关联为记录文档模板. 选择此选项时,将显示计算机上可用的所有AcrobatPDF(Acroform)。 选择要使用的Acroform。
  6. 单击 完成。

您的自适应表单现在配置为使用Acroform作为记录文档的模板。 下一步是 将自适应表单组件绑定到相应的模板字段.

自动生成记录文档

将自适应表单配置为自动生成记录文档时,每次更改表单时,都会立即更新其记录文档。 例如,如果从现有自适应表单中删除某个字段,则相应的字段也会被删除,并且在记录文档中不可见。 自动生成记录文档还有许多其他优势:

  • 表单开发人员不必手动维护数据绑定。 自动生成的记录文档负责数据绑定相关更新。
  • 表单开发人员不必手动隐藏标记为从记录文档排除的字段。 自动生成的记录文档预配置为排除此类字段。
  • 自动生成的记录文档选项节省了为记录文档创建表单模板所需的时间。
  • 通过自动生成的“记录文档”选项,您可以使用不同的基本模板来使用不同的样式和外观。 它有助于为您的组织的记录文档选择最佳样式和外观。 如果未指定样式,系统样式将设置为默认样式。
  • 自动生成的记录文档可确保表单中的任何更改立即反映在记录文档中。

执行以下步骤来配置自适应表单以自动生成记录文档:

  1. 在Experience Manager创作实例中,单击 Forms > Forms和文档.
  2. 选择表单或创建自适应表单,然后单击 属性.
  3. 在“属性”窗口中,选择 表单模型.
  4. 表单模型 选项卡,在 选择自 下拉列表,选择 表单数据模型架构. 您还可以在创建表单时选择表单模型。
  5. 在表单模型选项卡的记录文档模板配置部分中,选择 生成记录文档.
  6. 单击 完成。

将自适应表单组件与模板字段绑定

将自适应表单字段与模板字段绑定以在相应的记录文档字段显示捕获的表单数据。 要将自适应表单组件与相应的记录文档模板字段绑定,请执行以下操作:

  1. 打开自适应表单,配置为使用自定义表单模板进行编辑。

  2. 选择一个自适应表单组件,然后单击打开配置 配置 图标。 它会打开属性浏览器。

  3. 在属性浏览器中,浏览并选择字段。

    • (对于AcroForm模板) 记录文档绑定引用字段 属性。
    • (对于XFA模板) 数据模型绑定引用 属性。
  4. 单击​保存

您可以使用提交操作,如“发送电子邮件”、“调用AEM工作流”、“调用Power Automate流”等 提交操作 以接收记录文档。
图像提交操作

记录文档模板的增量更新

自适应表单和相应的记录文档模板会随着时间的推移而不断变化。 您可以选择向自适应表单或记录文档模板添加、删除或修改字段。

当您更改记录文档模板并将更改的记录文档模板上载到AEM Forms时,自适应Forms编辑器会自动检测更改的绑定,并通知您有关需要新绑定的自适应表单组件。 它允许您对记录文档模板进行增量更新。

例如,组织、 We.Retail,具有基于AcroForm的记录文档模板, we-retail-invoice.pdf. 模板如下所示:

原始模板

在使用模板一段时间后,组织决定重命名 invoice-number 字段至 bill-number 字段和捕获购买者的电子邮件地址。 开发人员更新以下项目的名称: invoice-number 字段,并将电子邮件字段添加到模板。 他还创建模板的新版本,名为 we-retail-invoice-v2.pdf.

已更新模板

现在,当提交自适应表单时,会生成更新的记录文档。

已更新 —

使用记录文档时的主要注意事项

处理自适应Forms的记录文档时,请牢记以下注意事项和限制。

  • 记录文档模板不支持富文本。 因此,静态自适应表单中或用户填写的信息中的任何富文本都会在记录文档中显示为纯文本。
  • 自适应表单中的文档片段未出现在记录文档中。 但是,支持自适应表单片段。
  • 不支持为基于XML架构的自适应表单生成的记录文档中的内容绑定。
  • 当用户请求呈现记录文档时,记录文档的本地化版本是应区域设置的要求创建的。 记录文档的本地化与自适应表单的本地化同时发生。

自适应表单元素映射

下表介绍了自适应表单组件和相应的XFA组件,以及这些组件是否显示在记录文档中。

字段

自适应表单组件 对应的XFA组件 默认情况下包含在记录文档模板中? 注释
按钮 按钮 false
复选框 复选框 true
日期选取器 日期/时间字段 true
下拉列表 下拉列表 true
数值框 数值字段 true
单选按钮 单选按钮 true
文本框 文本字段 true
“重置”按钮 “重置”按钮 false
“提交”按钮

电子邮件提交按钮

HTTP提交按钮

false
文件附件 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中执行以下操作。

  1. 单击 文件 > 新建.

  2. 选择 基于模板 选项。

  3. 选择 Forms — 记录文档 类别。

  4. 选择 DoR基本模板.

  5. 单击 下一个 并提供所需信息。

  6. (可选)修改要应用于记录文档中的字段的样式和外观。

  7. 保存表单。
    基本属性

您现在可以将保存的表单用作记录文档的基础模板。 请勿修改或删除基本模板中存在的任何脚本。

修改基本模板

  • 不要对基本模板中的字段应用任何样式,最好从基本模板中删除这些字段,以便自动选取对基本模板的任何升级。
  • 修改基本模板时,请勿删除、添加或修改脚本。

请严格遵循上述约定和说明来设计基本模板。

自定义记录文档中的品牌信息

生成记录文档时,您可以在记录文档选项卡上更改记录文档的品牌信息。 “记录文档”选项卡包括如下选项:徽标、外观、布局、页眉和页脚、免责声明,以及是否包括未选定的复选框和单选按钮选项。

要本地化您在“记录文档”选项卡中输入的品牌信息,请确保正确设置了浏览器的区域设置。 要自定义记录文档的品牌信息,请执行以下步骤:

  1. 在记录文档中选择一个面板(根面板),然后选择 配置.

  2. 选择 多塔布. 此时将显示记录文档选项卡。

  3. 选择用于呈现记录文档的默认模板或自定义模板。 如果选择默认模板,则“模板”下拉菜单下方将显示记录文档的缩略图预览。

  4. 根据您选择默认模板还是自定义模板,以下某些属性或所有属性都会显示在“记录文档”选项卡中。 指定以下提及的属性以定义记录文档的外观:

    1. 基本属性

      • 模板:如果要选择自定义模板,请浏览并在中选择XDP AEM Forms 服务器。 如果您要使用的模板在您的 AEM Forms 服务器,您应该首先将XDP上传到 AEM Forms 服务器。

      • 重点颜色:标题文本和分隔行在记录文档PDF中呈现的颜色。

      • 字体系列:记录文档PDF中文本的字体系列。

      • 包括未绑定到数据模型的表单对象:设置属性后,记录文档中包含来自基于架构的自适应表单的未绑定字段。

      • 隐藏面板描述:设置属性可从记录文档中排除面板/表的描述。 适用于面板和表格。
    2. 表单字段属性

      • 对于复选框和单选按钮组件,仅显示选定值:设置属性时,将仅显示中复选框和单选按钮的选定值 记录文档.
      • 用于多个值的分隔符:您可以选择任意分隔符,如逗号或换行符,以显示多个值。
      • 选项对齐方式:您可以选择所需的对齐方式(水平、垂直、与自适应表单相同)来设置要显示的复选框或单选按钮等字段的对齐方式 记录文档. 默认情况下,中的字段会设置垂直对齐方式 记录文档. 从设置属性 表单字段属性 的URL会覆盖 项目对齐方式 用于自适应表单上的字段。 如果是,请选择 与自适应表单相同 选项,自适应表单创作实例中配置的对齐方式用于 记录文档 字段。
      • 水平对齐选项的数量:您可以为水平对齐设置要在记录文档上显示的选项数量。
    3. 母版页属性

      • 徽标图像:您可以选择使用自适应表单中的徽标图像,从DAM中选择徽标图像,或从计算机上传徽标图像。
      • 表单标题:记录文件的标题。
      • 标题文本:在记录文档的标题部分显示的文本。
      • 免责声明标签:免责声明的标签。
      • 免责声明:指定记录文档上权利和义务范围的文本。
      • 免责声明文本:免责声明文本。

      母版页属性

    注意

    如果您使用的是使用6.3之前的Designer版本创建的自适应表单模板,为了使重音颜色和字体系列属性正常工作,请确保根子表单下的自适应表单模板中存在以下内容:

    <proto>
    <font typeface="Arial"/>
    <fill>
    <color value="4,166,203"/>
    </fill>
    <edge>
    <color value="4,166,203"/>
    </edge>
    </proto>
    
  5. 要保存品牌策略更改,请选择 完成.

记录文档中面板的表格和列布局

您的自适应表单可能很长,包含多个表单字段。 您可能不希望将记录文档另存为自适应表单的精确副本。 现在,您可以选择表格或列布局,以便在记录文档PDF中保存一个或多个自适应表单面板。

在生成记录文档之前,在面板的设置中,选择该面板的记录文档的布局(表格或列)。 面板中的字段将在记录文档中相应组织。

面板中的字段在记录文档的表格布局中渲染

面板中的字段在记录文档的表格布局中渲染

面板中的字段在记录文档的列布局中渲染

面板中的字段在记录文档的列布局中渲染

记录文档设置

记录文档设置允许您选择要包含在记录文档中的选项。 例如,银行接受表单中的姓名、年龄、社会保险号码和电话号码。 该表单会生成银行帐号和分行详细信息。 您可以选择在记录文档中仅显示名称、社会保险编号、银行帐户和分行详细信息。

记录文档组件的设置可在其属性下使用。 要访问组件的属性,请选择该组件并单击 cmppr 在覆盖图中。 这些属性列在侧边栏中,您可以在该侧边栏中找到以下设置。

字段级设置

  • 从记录文档排除:将属性设置为true会从记录文档排除字段。 这是名为的可编写脚本的属性 excludeFromDoR. 其行为取决于 若隐藏自DoR排除栏位 表单级别属性。

  • 将面板显示为表格: 如果面板中的字段少于6个,设置属性会在记录文档中将面板显示为表格。 仅适用于面板。

  • 从记录文档排除标题: 设置属性会从记录文档中排除面板/表的标题。 仅适用于面板和表格。

  • 从记录文档排除描述: 设置属性会从记录文档中排除面板/表的描述。 仅适用于面板和表格。

表单级别设置

  • 包括DoR中未绑定的字段: 设置属性后,记录文档中包含来自基于架构的自适应表单的未绑定字段。 默认情况下,它为true。

另请参阅

在此页面上