使用自适应表单的最佳实践 best-practices-for-working-with-adaptive-forms

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

概述 overview

Adobe Experience Manager(AEM)表单可帮助您将复杂的事务转换为简单、令人愉快的数字体验。 但是,它需要齐心协力来实施、构建、执行和维护一个高效和生产性的AEM Forms生态系统。

本文档提供了管理员、作者和开发人员在使用AEM Forms(特别是自适应表单组件)时可从中受益的准则和建议。 它讨论了从设置表单开发项目到配置、自定义、创作和优化AEM Forms的最佳实践。 这些最佳做法共同促进了AEM Forms生态系统的整体绩效。

此外,以下是一些常规AEM最佳实践的推荐读法:

设置和配置AEM Forms set-up-and-configure-aem-forms

设置表单开发项目 setting-up-forms-development-project

简化和标准化的项目结构可以显着减少开发和维护工作。 Apache Maven是一种构建AEM项目推荐的开源工具。

  • 使用Apache Maven aem-project-archetype 创建和管理AEM项目结构。 它会为您的AEM项目创建推荐的结构和模板。 此外,它还提供构建自动化和更改控制系统以帮助管理项目。

    • 使用maven archetype:generate 命令来生成初始结构。
    • 使用maven eclipse:eclipse 命令生成eclipse项目文件并将项目导入eclipse。

有关更多信息,请参阅 如何使用Apache Maven构建AEM项目.

  • FileVault工具或VLT可帮助您将CRX或AEM实例的内容映射到文件系统。 它提供变更控制管理操作,如AEM项目内容的签入和签出。 请参阅 如何使用VLT工具.

  • 如果您使用Eclipse集成的开发环境,则可以使用AEM开发人员工具将Eclipse IDE与AEM实例无缝集成,以创建AEM应用程序。 有关详细信息,请参阅 AEM for Eclipse开发人员工具.

规划创作环境 planning-for-authoring-environment

设置AEM项目后,定义用于创作和自定义自适应表单模板和组件的策略。

  • 自适应表单模板是一个专用的AEM页面,用于定义自适应表单的结构和页眉和页脚信息。 模板已为自适应表单预配置了布局、样式和基本结构。 AEM Forms提供了现成的模板和组件,您可以使用这些模板和组件创作自适应表单。 但是,您可以根据需要创建自定义模板和组件。 建议收集对自适应表单中所需的其他模板和组件的要求。 有关详细信息,请参阅 自定义自适应表单和组件.

  • AEM Forms允许您根据以下表单模型创建自适应表单。 表单模型充当表单与AEM系统之间数据交换的接口,并为自适应表单内外的数据流提供基于XML的结构。 此外,表单模型以模式和XFA约束的形式对自适应表单施加规则和约束。

    • :使用此选项创建的自适应表单不使用任何表单模型。 从此类表单生成的数据 XML 具有带字段和相应值的平面结构。
    • XML或JSON架构:XML和JSON架构表示组织内的后端系统生成或使用数据的结构。 您可以将架构与自适应表单相关联,并使用其元素向自适应表单添加动态内容。 架构的元素位于内容浏览器的“数据模型对象”选项卡中,用于创作自适应表单。 您可以拖放架构元素以构建表单。
    • XFA表单模板:如果您在基于XFA的HTML5表单中进行了投资,则它是理想的表单模型。 它提供了一种将基于XFA的表单转换为自适应表单的直接方法。 任何现有的XFA规则都将保留在关联的自适应表单中。 生成的自适应表单支持XFA构建,如验证、事件、属性和模式。
    • 表单数据模型:如果您希望集成后端系统(如数据库、Web服务和AEM用户配置文件)以预填充自适应表单并将提交的表单数据写回后端系统,则它是首选的表单模型。 通过表单数据模型编辑器,您可以在表单数据模型中定义和配置实体和服务,以用于创建自适应表单。 有关更多信息,请参阅 AEM Forms数据集成.

请务必仔细选择数据模型,该模型不仅符合您的要求,而且还可扩展您在XFA和XSD资产(如果有)中的现有投资。 建议使用XSD模型创建表单模板,因为生成的XML包含由架构定义的按XPATH定义的数据。 使用XSD模型作为表单数据模型的默认选项也有帮助,因为它可以从处理和使用数据的后端系统中分离表单设计,并且由于表单字段的一对一映射而提高了表单性能。 此外,字段的BindRef可以作为其XML中数据值的XPATH。

有关更多信息,请参阅 创建自适应表单.

  • 自适应表单中有一些常见部分。 您可以识别它们并定义策略以促进内容重复使用。 自适应表单允许您创建独立的片段并在表单中重复使用。 您还可以将自适应表单中的面板另存为片段。 片段中的任何更改都会反映在所有关联的表单中。 它有助于您缩短创作时间并确保表单之间的一致性。 此外,使用片段使自适应表单变得更加轻巧,从而改善了创作体验,尤其是大型表单的创作体验。 有关更多信息,请参阅 自适应表单片段.

自定义自适应表单和组件 customize-components

  • AEM Forms提供了现成的自适应表单模板,您可以使用这些模板创建自适应表单。 您还可以创建自己的模板。 AEM提供静态和可编辑的模板。

    • 静态模板由开发人员定义和配置。
    • 可编辑的模板由作者使用模板编辑器创建。 利用模板编辑器,可定义模板的基本结构和初始内容。 结构层中的任何修改都会反映在使用该模板的所有表单中。 初始内容可以包括预配置的主题、预填充服务、提交操作等。 但是,可以使用表单编辑器为表单修改这些设置。 有关更多信息,请参阅 自适应表单模板.
  • 要为特定字段或面板实例设置样式,请使用 内嵌样式. 或者,您也可以在CSS文件中定义类,并在组件的CSS类属性中指定类名称。

  • 将客户端库包含在组件中,以便始终如一地在使用该组件的自适应表单或片段中应用样式。 有关更多信息,请参阅 创建自适应表单页面组件.

  • 应用客户端库中定义的样式以选择自适应表单,方法是在自适应表单容器属性的CSS文件路径字段中指定客户端库的路径。

  • 要创建样式的客户端库,您可以在主题编辑器基本clientlib或表单容器属性中配置自定义CSS文件。

  • 自适应表单提供了面板布局(如响应式、选项卡式、折叠式和向导),以控制表单组件在面板中的布局方式。 您可以创建自定义面板布局,并使其可供表单作者使用。 有关更多信息,请参阅 为自适应表单创建自定义布局组件.

  • 您还可以自定义特定的自适应表单组件,如字段和面板布局。

    • 使用 叠加 功能修改组件副本。 不建议修改默认组件。
    • 要在/libs中自定义现成自适应表单组件的布局, 创建自定义布局组件默认布局.
    • 通过创建自定义小组件或外观来引入自定义交互活动。 不建议修改默认组件。 有关更多信息,请参阅 外观框架.
  • 请参阅 处理个人身份信息 以了解有关处理PII数据的建议。

创作自适应表单 author-adaptive-forms

使用触屏优化UI进行创作 using-touch-optimized-ui-for-authoring

  • 在侧栏中使用对象浏览器快速访问表单层次结构中的深层字段。 您可以使用搜索框在表单或对象树中搜索对象,以从一个对象导航到另一个对象。

  • 要在侧栏的组件浏览器中查看和编辑组件的属性,请选择该组件,然后单击 cmppr-1 . 您还可以双击某个组件,以在属性浏览器中查看其属性。

  • 使用键盘快捷键对表单执行快速操作。 请参阅 AEM Forms键盘快捷键.

  • 建议仅在自适应表单页面中使用自适应表单组件。 这些组件依赖于其父层次结构。 因此,请不要在AEM页面中使用它们。

另请参阅 创作自适应表单简介.

在自适应表单中使用规则 using-rules-in-adaptive-forms

AEM Forms提供 规则编辑器 用于创建规则以将动态行为添加到自适应表单组件。 使用这些规则,您可以评估条件并触发对组件的操作,例如显示或隐藏字段、计算值、动态更改下拉列表等。

规则编辑器提供了用于编写规则的可视化编辑器和代码编辑器。 使用代码编辑器模式编写规则时,请考虑以下事项:

  • 为表单字段和组件使用有意义且唯一的名称,以避免在编写规则时出现任何可能的冲突。

  • 使用 this 运算符,以便组件在规则表达式中引用自身。 它可确保即使组件名称发生更改,规则也保持有效。 例如:field1.valueCommit script: this.value > 10

  • 引用其他表单组件时,请使用组件名称。 使用 value 属性来获取字段或组件的值。 例如:field1.value

  • 按相对唯一的层次结构引用组件以避免任何冲突。 例如:parentName.fieldName

  • 在处理复杂或常用的规则时,请考虑将业务逻辑编写为函数,在单独的客户端库中编写,您可以在自适应表单中指定和重复使用这些函数。 客户端库应为自包含库,除jQuery和Underscore.js外,不应有任何外部依赖项。 您还可以使用客户端库来强制执行 服务器端重新验证 已提交表单数据的次数。

  • 自适应表单提供了一组API,您可以使用这些API与自适应表单通信并对自适应表单执行操作。 一些关键API如下所示。 有关更多信息,请参阅 适用于自适应Forms的JavaScript库API引用.

    • guideBridge.reset():重置表单。

    • guideBridge.submit():提交表单。

    • guideBridge.setFocus(somExp, focusOption, runCompletionExp):将焦点设置到字段。

    • guideBridge.validate(errorList, somExpression, focus):验证表单。

    • guideBridge.getDataXML(options):将表单数据作为XML获取。

    • guideBridge.resolveNode(somExpression):获取表单对象。

    • guideBridge.setProperty(somList, propertyName, valueList):设置表单对象的属性。

    • 此外,您还可以使用以下字段属性:

      • field.value 更改字段的值。
      • f ield.enabled 启用/禁用字段。
      • field.visible 更改字段的可见性。
  • 自适应表单作者可能需要编写JavaScript代码以在表单中构建业务逻辑。 尽管JavaScript功能强大且有效,但它可能会损害安全预期。 因此,您必须确保表单作者是可信任的人物,并且在表单投入生产之前,需要先审核和批准JavaScript代码的流程。 管理员可以根据用户组的角色或功能限制对规则编辑器访问权限。 请参阅 为选定用户组授予规则编辑器访问权限.

  • 您可以在规则中使用表达式来使自适应表单动态。 所有表达式都是有效的JavaScript表达式,且使用自适应表单脚本模型API。 这些表达式返回某些类型的值。 有关这些表达式和最佳实践的更多信息,请参阅 自适应表单表达式.

处理主题 working-with-themes

主题自适应允许您创建可在表单中应用的可重用样式,以保持一致的外观和样式。 建议使用主题为表单组件和面板定义样式。 有关主题的一些最佳实践如下:

  • 使用资产库可快速应用文本样式、背景和图像。 在资产库中添加样式后,该样式可用于其他主题和表单编辑器的样式模式。
  • 使用页面级别选择器应用全局设置,如字体和页面背景。
  • 使用客户端库将现有或高级样式导入您的主题。
  • 您可以覆盖表单样式层中特定字段、面板或按钮的样式。
  • 如果主题不符合您的样式要求,您可以使用预定义类(如guideFieldNode、guideFieldLabel、guideFieldWidget和guidePanelNode)来跨表单应用通用样式。

有关更多信息,请参阅 主题.

优化大型复杂表单的性能 optimizing-performance-of-large-and-complex-forms

表单作者和最终用户在创作模式或运行时加载大型表单时通常会遇到性能问题。 随着表单中对象(字段和面板)数量的增加,创作和运行时体验开始降级。 它还可防止多个作者同时协作和创作表单。

请考虑以下最佳实践,以克服大型表单的性能问题:

  • 建议在将XFA转换为自适应表单(如果可能)时,也使用XSD表单数据模型创建自适应表单。

  • 在自适应表单中仅包括那些从用户处捕获信息的字段和面板。 请考虑将静态内容保持为最小,或使用URL在单独的窗口中打开它们。

  • 虽然每个表单都是为特定目的而设计的,但大多数表单中有一些常见的区段。 例如,个人详细信息、地址、雇佣详细信息等。 创建 自适应表单片段 用于常见的表单元素和部分,并在表单中使用它们。 您还可以将现有表单中的面板另存为片段。 片段中的任何更改都会反映在所有关联的自适应表单中。 它促进协作创作,因为多个作者可以同时处理构成表单的不同片段。

    • 与自适应表单类似,建议使用片段容器对话框在客户端库中定义所有特定于片段的样式和自定义脚本。 此外,请尝试创建不依赖外部对象的自足片段。
    • 避免使用跨片段脚本。 如果片段外有您必须引用的任何对象,请尝试将该对象设为父表单的一部分。 如果对象仍必须位于其他片段中,请在脚本中按其名称引用它。
  • 使用自动保存的保存和恢复功能定期保存自适应表单,并允许用户稍后重新访问以完成表单。

  • 配置片段以懒惰加载。 在运行时,标记为懒惰加载的片段仅在需要时才呈现。 它显着缩短了大型表单的加载时间。 片段中还支持使用可重复面板的此功能。 有关更多信息,请参阅 配置延迟加载.

    • 请勿在响应式网格布局或第一个面板中对片段配置延迟加载。
    • 懒散加载的片段不支持文件附件和条款和条件组件。
    • 如果延迟加载面板中的某个值在表单的其他部分中使用,则将该值标记为全局使用值,以便该值在卸载容器面板时可用。
    • 考虑为应根据条件显示或隐藏的片段编写可见性规则。

预填自适应表单 prefilling-adaptive-forms

您可以使用从后端获取的数据预填自适应表单字段,以帮助用户快速填写表单并避免键入错误。

  • AEM Forms提供预填充服务,用于从预定义的数据XML文件中读取数据,并使用预填充XML文件中的内容预填充自适应表单的字段。

  • 预填充数据XML必须与与自适应表单关联的表单模型架构兼容。

  • 包括 afBoundedDataafUnBoundedData 预填充XML中用于以自适应表单预填充绑定和未绑定字段的部分。

  • 对于基于表单数据模型的自适应表单,AEM Forms提供了现成的表单数据模型预填充服务。 预填充服务查询自适应表单中数据模型对象的数据源,并在呈现表单时预填充字段值。

  • 您还可以使用文件、crx、服务或http协议预填自适应表单。

  • AEM Forms支持自定义预填充服务,您可以将这些服务作为OSGi服务插入来预填充自适应表单。

有关更多信息,请参阅 预填自适应表单字段.

签署和提交自适应表单 signing-and-submitting-adaptive-forms

自适应表单需要提交操作才能处理用户指定的数据。 “提交”操作确定使用自适应表单对您提交的数据执行的任务。

  • 自适应表单中有几个现成可用的提交操作。 有关详细信息,请参阅 配置提交操作.
  • 如果默认提交操作不符合您的用例,您可以编写自定义提交操作。 有关更多信息,请参阅 为自适应表单编写自定义提交操作.
  • 包括服务器端验证,以防止提交无效的数据。

您可以在自适应表单中利用Acrobat Sign的多符号体验。 在自适应表单中配置Acrobat Sign时,请考虑以下事项。 有关详细信息,请参阅 在自适应表单中使用Acrobat Sign.

  • 只有在所有签名者都签署了表单后,才会提交启用了Acrobat Sign的自适应表单。 Forms将以“待签名”状态显示,直到表单由所有签名者签名为止。
  • 您可以配置表单内签名体验,或在提交时将签名者重定向到签名页面。
  • 根据需要配置顺序或并行签名体验。

生成记录文档 generating-document-of-record

记录文档(DoR)是可打印、签名或存档的自适应表单的扁平化PDF版本。

  • 根据自适应表单所基于的表单数据模型,您可以按如下方式为DoR配置模板:

    • XFA表单模板:使用关联的XDP文件作为DoR模板。
    • XSD架构:使用与自适应表单使用的相同XML架构的关联XFA模板。
    • :使用自动生成的DoR。
  • 从自适应表单编辑器的“记录文档”选项卡中,直接配置页眉、页脚、图像、颜色、字体等。

  • 使用 DoRService 以编程方式生成DoR。

  • 从DoR中排除隐藏字段。

  • 使用 afAcceptLang 请求参数来查看其他区域设置中的DoR。

调试和测试自适应表单 debugging-and-testing-adaptive-forms

AEM Chrome插件 是适用于Google Chrome的浏览器扩展,提供了用于调试自适应表单的工具。 表单作者和开发人员可以使用这些工具:

  • 找出瓶颈并优化表单渲染的性能
  • 调试表单中的关键词和bindRef错误
  • 启用和配置日志
  • 调试表单中的规则和脚本
  • 探索和了解guideBridge API

有关更多信息,请参阅 AEM Chrome插件 — 自适应表单.

Calvin SDK是一个实用程序API,供自适应Forms开发人员测试自适应Forms。 Calvin SDK是在 Hobbes.js测试框架. 您可以使用框架来测试以下内容:

  • 自适应表单的演绎版体验
  • 自适应表单的预填体验
  • 提交自适应表单的体验
  • 表达式规则
  • 验证
  • 延迟加载

有关更多信息,请参阅 自动测试自适应表单.

在AEM服务器上验证自适应表单 validating-adaptive-forms-on-aem-server

需要进行服务器端验证,以防止任何绕过客户端验证的尝试,以及数据提交和业务规则违规的任何可能危害。 服务器端验证通过加载所需的客户端库来执行。

  • 在客户端库中包含用于验证自适应表单中表达式的函数,并在自适应表单容器对话框中指定客户端库。 有关更多信息,请参阅 服务器端重新验证.
  • 服务器端验证可验证表单模型。 建议为验证创建单独的客户端库,但不要将其与HTML样式和DOM操作等其他内容混合到同一客户端库中。

本地化自适应表单 localizing-adaptive-forms

AEM提供了翻译工作流,您可以使用这些工作流将自适应表单本地化。 有关信息,请参阅 使用AEM翻译工作流将自适应表单本地化.

本地化自适应表单的一些最佳实践如下所示:

  • 将自适应表单片段用于表单中的常见元素,并将片段本地化。 它确保将片段本地化一次,并且它反映在使用本地化片段的所有表单中。

  • 任何修改(如添加新组件或在本地化表单中应用脚本)都不会自动本地化。 因此,您必须在将表单本地化之前完成表单,以避免多次本地化周期。

  • 使用 afAcceptLang 请求参数覆盖浏览器区域设置,并在指定区域设置中呈现表单。 例如,以下URL将强制以日语区域设置呈现表单,而不考虑浏览器设置中指定的区域设置:

    https://[*server*]:[*port*]/<*contextPath*>/<*formFolder*>/<*formName*>.html?wcmmode=disabled&afAcceptLang=ja

  • AEM Forms目前支持以英语(en)、西班牙语(es)、法语(fr)、意大利语(it)、德语(de)、日语(ja)、葡萄牙语 — 巴西语(pt-BR)、中文 — (zh-CN)、中国 — 台湾语(zh-TW)和韩语(ko-KR)区域设置本地化自适应表单内容。 但是,您可以在运行时为自适应表单添加新区域设置支持。 有关更多信息,请参阅 支持自适应表单本地化的新区域设置.

准备用于生产的表单项目 prepare-forms-project-for-production

添加表单处理服务器 adding-forms-processing-server

您可以在安全区域中配置位于防火墙后面的AEM Forms服务器的其他实例。 您可以将此实例用于:

  • 批处理:批量重复或计划但负载较重的作业。 例如,打印语句、生成对应项,以及使用文档服务(如PDF生成器、输出和汇编程序)。
  • 存储PII数据:将PII数据保存到处理服务器。 如果您已使用自定义存储提供程序存储PII数据,则不需要此操作。

将项目移动到其他环境 moving-project-to-another-environment

您通常需要将AEM项目从一个环境移动到另一个环境。 移动时要记住的一些关键事项如下:

  • 备份现有客户端库、自定义代码和配置。
  • 在新环境中按指定顺序手动部署产品包和修补程序。
  • 手动部署特定于项目的代码包和包,并将它们作为单独的包或包部署在新的AEM服务器上。
  • (仅JEE上的AEM Forms)在Forms Workflow服务器上手动部署LCA和DSC。
  • 使用 导出 — 导入 功能将资产移动到新环境。 您还可以配置复制代理和发布资产。

配置AEM configuring-aem

配置AEM以提高整体性能的一些最佳实践如下:

为草稿和提交的表单数据配置外部存储 external-storage

在生产环境中,建议不要将提交的表单数据存储在AEM存储库中。 Forms门户存储、存储内容和存储PDF提交操作的默认实施将表单数据存储在AEM存储库中。 这些提交操作仅用于演示目的。 此外,默认情况下,“保存并恢复”和“自动保存”功能使用门户存储。 因此,请考虑以下建议:

处理个人身份信息 handling-personally-identifiable-information

组织面临的一个关键挑战是如何处理个人身份(PII)数据。 有助于您处理此类数据的一些最佳实践如下:

  • 使用安全的外部存储(如数据库)来存储草稿和提交的表单中的数据。 请参阅 为草稿和提交的表单数据配置外部存储.
  • 使用“条款和条件”表单组件,在启用自动保存之前获得用户的明确同意。 在这种情况下,仅当用户同意“条款”和“条件”组件中的条件时,才启用自动保存。
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da