将自适应Forms与XFA表单模板同步

上次更新: 2023-12-21

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

简介

您可以基于XFA表单模板创建自适应表单( *.XDP 文件)。 通过重复使用,您可以保留在现有XFA表单中的投资。 有关如何使用XFA表单模板创建自适应表单的信息, 基于模板创建自适应表单.

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

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

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

在AEM Forms创作环境中,您可以将字段从XFA表单(左)拖到自适应表单(右)中

前提条件

要使用本文中的信息,建议熟悉以下方面:

要使用文章中提供的资源作为示例,请下载示例包,如下一节中所述, 示例包.

示例包

文章通过一个示例演示了如何将自适应表单与更新的XFA表单模板同步。 示例中使用的资产位于一个包中,该包可从以下位置下载: 下载 部分。

上传包后,您可以在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的标题从 数值字段AF数值字段。
注意

在前面的步骤中,我们覆盖了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的标题 文本字段我的文本字段.

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

如果XDP文件被更新,当您根据XDP文件编辑自适应表单时,会在编辑器中看到一个图标。 此图标表示自适应表单与XDP文件不同步。 在下图中,请参阅侧边栏中的图标。

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

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

下次打开与XDP文件不同步的自适应表单进行创作时,会显示以下消息: 自适应表单的架构/表单模板已更新。 Click Here 以使用新版本进行重设。

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

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

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

更新属性

从XDP文件复制到自适应表单的所有属性都将更新,但作者在自适应表单(从“组件”对话框)中显式覆盖的属性除外。 服务器日志中提供了已更新的属性列表。

要更新自适应表单示例中的属性,请单击链接(标签为 "Click Here")。 TextField1的标题已从 文本字段我的文本字段.

update — 属性

注意

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

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

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

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

XDP文件中已删除字段

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

以下步骤演示了本文中所用示例中资产的此使用流程:

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

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

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

  4. 单击链接(标记为“ Click Here“)中。 此时会显示一条错误消息,指出该字段在XDP文件中不再存在。

删除XDP文件中的元素时看到的错误

已删除的字段还会标记一个图标,以指示字段中存在错误。

字段中的错误图标

注意

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

下载

内容包(适用于本文中的示例)

获取文件

在此页面上