使用XFA表单模板同步自适应Forms

简介

您可以基于XFA表单模板（*.XDP文件）创建自适应表单。 通过这种重复利用，您可以保留对现有XFA表单的投资。 有关如何使用XFA表单模板创建自适应表单的信息，请根据模板创建自适应表单。

您可以在自适应表单中重复使用XDP文件中的字段。 这些字段称为绑定字段。 绑定字段的属性（如脚本、标签和显示格式）将从XDP文件复制。 您还可以选择覆盖其中某些属性的值。

AEM Forms提供了一种方法，可帮助您保持自适应表单的字段与随后对XDP文件中的相应字段所做的任何更改保持同步。 本文介绍如何启用此同步。

您可以将字段从XFA表单拖动到自适应表单

在AEM Forms创作环境中，您可以将字段从XFA表单（左）拖动到自适应表单（右）

前提条件

要使用本文中的信息，建议您熟悉以下方面：

要使用文章中提供的资产作为示例，请按照下一节示例包中所述下载示例包。

示例包

文章使用一个示例来演示如何将自适应表单与更新的XFA表单模板同步。 示例中使用的资产位于包中，可从本文的Downloads部分下载该包。

上传包后，您可以在AEM Forms UI中查看这些资产。

使用包管理器安装包：https://<server>:<port>/crx/packmgr/index.jsp

资源包包含以下资产：

  1. sample-form.xdp:以XFA表单模板为例

  2. sample-xfa-af:基于sample-form.xdp文件的自适应表单。但是，此自适应表单不包含任何字段。 在下一步中，我们将向此自适应表单添加内容。

将内容添加到自适应表单

  1. 导航到https://<server>:<port>/aem/forms.html。 如果有疑问，请输入您的凭据。
  2. 打开sample-af-xfa以在创作模式下进行编辑。
  3. 从侧栏的内容浏览器中，选择数据模型对象选项卡。 将NumericField1和TextField1拖动到自适应表单上。
  4. 将NumericField1的标题从​Numeric Field​更改为​AF Numeric Field.
注意

在上述步骤中，我们覆盖了XDP文件中字段的属性。 因此，如果稍后修改XDP文件中的相应属性，则不会同步此属性。

检测XDP文件中的更改

无论XDP文件或片段中有任何更改，AEM Forms UI都会标记所有基于XDP文件或片段的自适应表单。

更新XDP文件后，您需要在AEM Forms UI中再次上传该文件，以便对要标记的更改进行上传。

例如，让我们使用以下步骤更新sample-form.xdp文件：

  1. 导航至https://<server>:<port>/projects.html.如果出现提示，请输入您的凭据。

  2. 单击左侧的Forms选项卡。

  3. 在本地计算机上下载sample-form.xdp文件。 XDP文件将下载为.zip文件，可使用任何文件解压实用程序来提取该文件。

  4. 打开sample-form.xdp文件，并将字段TextField1的标题从​Text Field​更改为​My Text Field。

  5. 将sample-form.xdp文件上传回AEM Forms UI。

如果XDP文件更新，则在根据XDP文件编辑自适应表单时，您会在编辑器中看到一个图标。 此图标指示自适应表单与XDP文件不同步。 在下图中，查看侧栏中旁边的图标。

用于显示自适应表单与XDP文件不同步的图标

将自适应表单与最新的XDP文件同步

当打开与XDP文件不同步的自适应表单以供下次创作时，将显示以下消息：
自适应表单的架构/表单模板已更新。 Click Here 以使用新版本重新构建基础。

单击消息可将自适应表单中的字段与XDP文件中的相应字段同步。

对于本文中使用的示例，请在创作模式下打开sample-xfa-af。 消息将向自适应表单的底部显示。

提示您将自适应表单与XDP文件同步的消息

更新属性

除了作者在自适应表单（从组件对话框中）中显式覆盖的属性之外，从XDP文件复制到自适应表单的所有属性都将进行更新。 服务器日志中提供了已更新的属性列表。

要更新示例自适应表单中的属性，请单击消息中的链接（标记为"Click Here"）。 TextField1的标题从​Text Field​更改为​My Text Field。

update-property

注意

标签AF数值字段未更改，因为您已从组件属性对话框中覆盖此属性，如向自适应表单添加内容中所述。

将新字段从XDP文件添加到自适应表单  

任何稍后添加到原始XDP文件的字段都会显示在“表单层次结构”选项卡中，您可以将这些新字段拖动到自适应表单。

您无需单击错误消息中的链接，即可更新“表单层次结构”选项卡中的字段。

已删除XDP文件中的字段

如果从XDP文件中删除了之前复制到自适应表单的字段，则创作模式下会显示一条错误消息，指出XDP文件中不存在该字段。 在这种情况下，请手动从自适应表单中删除字段，或在组件对话框中清除bindRef属性。

以下步骤说明了本文所用示例中资产的使用流程：

  1. 更新sample-form.xdp文件并删除NumericField1。

  2. 在AEM Forms UI中上传sample-form.xdp文件

  3. 打开sample-xfa-af自适应表单进行创作。 将显示以下错误消息：自适应表单的架构/表单模板已更新。 Click Here 以使用新版本重新构建基础。

  4. 单击消息中的链接（标记为“ Click Here”）。 将显示一条错误消息，指出XDP文件中不再存在该字段。

删除XDP文件中的元素时出现错误

删除的字段还带有一个图标，用于指示字段中的错误。

字段中的错误图标

注意

自适应表单中绑定不正确的字段（编辑对话框中的值bindRef无效）也被视为已删除的字段。 如果作者未修复这些错误并发布自适应表单，则该字段将被视为普通的未绑定自适应表单字段，并包含在输出XML文件的未绑定部分中。

下载

本文示例的内容包

获取文件

在此页面上