为自适应表单生成记录文档

Adobe 建议使用现代、可扩展的数据捕获核心组件，以创建新的自适应表单或将自适应表单添加到 AEM Sites 页面。这些组件代表有关创建自适应表单的重大改进，确保实现令人印象深刻的用户体验。本文介绍了使用基础组件创作自适应表单的旧方法。

概述

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

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

您可以：

• 生成基于XFA的记录文档
• 生成基于Acroform(Acrobat表单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)。 选择相应的文件。
6. 单击 完成。

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

自动生成记录文档

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

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

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

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

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

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

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

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

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

   • （对于AcroForm模板） 记录文档绑定引用字段 属性。
   • （对于XFA模板） 数据模型绑定引用 属性。

4. 单击​保存。

您可以结合使用发送电子邮件、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的记录文档时，请牢记以下注意事项和限制。

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

自适应表单元素映射

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

字段

容器

静态组件

表

自适应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. 要保存品牌策略更改，请选择 完成.

自适应表单编辑器中的记录文档支持

您可以配置 记录文档 直接从自适应表单编辑器或自适应表单模板编辑器中访问模板。

从自适应表单编辑器的创作实例中执行以下步骤：

1. 选择​自适应表单容器（根）​组件。

2. 单击图标来打开自适应表单容器的​属性。

3. 打开 记录文档模板 选项卡并从以下选项中进行选择：

   • 无：选中此选项后，否 记录文档 为自适应表单创建的模板。

   • 将表单模板关联为记录文档模板：选择此选项时，XFA表单用作记录文档的模板。

   • 生成记录文档：如果选择此选项，则 记录文档 模板是为您的自适应表单自动生成的。

4. 选择 以保存属性。

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

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

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

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

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

记录文档设置

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

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

字段级设置

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

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

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

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

表单级别设置

• 包括DoR中未绑定的字段： 设置属性后，记录文档中包含来自基于架构的自适应表单的未绑定字段。 默认情况下，它为true。
• 若隐藏自DoR排除栏位： 设置属性以在提交表单时从记录文档排除隐藏字段。 当您启用时 在服务器上重新验证，服务器会先重新计算隐藏字段，然后再从记录文档排除这些字段。

使用自定义XCI文件

XCI文件可帮助您设置文档的各种属性。 Formsas a Cloud Service有一个主XCI文件。 您可以使用自定义XCI文件覆盖主XCI文件中指定的一个或多个默认属性。 例如，您可以选择将字体嵌入文档，或者为所有文档启用标记属性。 下表指定了XCI选项：

在您的Formsas a Cloud Service环境中使用自定义XCI文件

1. 将自定义XCI文件添加到您的开发项目中。

2. 指定以下内容 内联属性：

    {
     "xciFilePath": "[path of XCI file]"
    }
   

   例如，

    {
     "xciFilePath": "/content/dam/formsanddocuments/customMinionProBoldAndTagged.xci"
    }
   

3. 将项目部署到Cloud Service环境。

在本地Formsas a Cloud Service开发环境中使用自定义XCI文件

1. 将XCI文件上传到本地开发环境。
2. 打开Cloud ServiceSDK配置管理器。 默认URL为： http://localhost:4502/system/console/configMgr.
3. 找到并打开 自适应Forms和交互式通信Web渠道 配置。
4. 指定XCI文件的路径，然后单击 保存.

另请参阅

• 创建 AEM 自适应表单
• 将 AEM 自适应表单添加到 AEM Sites 页面
• 将主题应用于 AEM 自适应表单
• 将组件添加到 AEM 自适应表单
• 在 AEM 自适应表单中使用 CAPTCHA
• 生成 AEM 自适应表单的 PDF 版本 (DoR)
• 翻译 AEM 自适应表单
• 为自适应表单启用 Adobe Analytics 以跟踪表单使用情况
• 将自适应表单连接到 Microsoft SharePoint
• 将自适应表单连接到 Microsoft Power Automate
• 将自适应表单连接到 Microsoft OneDrive
• 将自适应表单连接到 Microsoft Azure Blob 存储
• 将自适应表单连接到 Salesforce
• 在 AEM 自适应表单中使用 Adobe Sign
• 为自适应表单添加新区域设置
• 将自适应表单数据发送到数据库
• 将自适应表单数据发送到 REST 端点
• 将自适应表单数据发送到 AEM 工作流
• 使用 Forms Portal 在 AEM 网站上列出 AEM 自适应表单