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

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

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

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

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

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

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

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

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

• 静态模板由开发人员定义和配置。
• 可编辑的模板由作者使用模板编辑器创建。 利用模板编辑器，可定义模板的基本结构和初始内容。 结构层中的任何修改都会反映在使用该模板的所有表单中。 初始内容可以包括预配置的主题、预填充服务、提交操作等。 但是，可以使用表单编辑器为表单修改这些设置。 有关更多信息，请参阅 自适应表单模板.

要为特定字段或面板实例设置样式，请使用 内嵌样式. 或者，您也可以在CSS文件中定义类，并在组件的CSS类属性中指定类名称。

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

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

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

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

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

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

请参阅 处理个人身份信息 以了解有关处理PII数据的建议。

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

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

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

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

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

使用 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。 这些表达式返回某些类型的值。 有关这些表达式和最佳实践的更多信息，请参阅 自适应表单表达式.

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

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

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

• 与自适应表单类似，建议使用片段容器对话框在客户端库中定义所有特定于片段的样式和自定义脚本。 此外，请尝试创建不依赖外部对象的自足片段。
• 避免使用跨片段脚本。 如果片段外有您必须引用的任何对象，请尝试将该对象设为父表单的一部分。 如果对象仍必须位于其他片段中，请在脚本中按其名称引用它。

使用自动保存的保存和恢复功能定期保存自适应表单，并允许用户稍后重新访问以完成表单。

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

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

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

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

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

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

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

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

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

• XFA表单模板:使用关联的XDP文件作为DoR模板。
• XSD架构:使用与自适应表单使用的相同XML架构的关联XFA模板。
• 无:使用自动生成的DoR。

从自适应表单编辑器的“记录文档”选项卡中，直接配置页眉、页脚、图像、颜色、字体等。

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

从DoR中排除隐藏字段。

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

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

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

使用 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)区域设置本地化自适应表单内容。 但是，您可以在运行时为自适应表单添加新区域设置支持。 有关更多信息，请参阅 支持自适应表单本地化的新区域设置.

从Felix控制台中启用HTML客户端库JavaScript和CSS压缩。

在 /etc.clientlibs/fd 以及AEM dispatcher上的任何其他自定义客户端库，以提高已发布表单的响应性和安全性。 有关更多信息，请参阅 Dispatcher.

不缓存 /content/forms/af/ 和 /content/dam/formsanddocuments/* 路径。 有关配置自适应表单缓存的详细信息，请参阅 缓存自适应表单.

通过Web服务器压缩模块启用HTML。 有关更多信息，请参阅 AEM Forms服务器的性能优化.

为大型表单增加每个请求配置的调用数。 请参阅 优化大型复杂表单的性能.

创建 错误处理程序显示的自定义错误页面.

安全的AEM Forms服务器。

• 使用 nosamplecontent 运行模式以确保生产服务器上没有部署示例内容和示例用户。 请参阅 在生产就绪模式下运行AEM.

将堆大小保持为最小8 GB。 有关其他设置，请参阅 AEM Forms服务器的性能优化.

使用服务用户会话而不是管理员会话来执行服务级别任务。 有关更多信息，请参阅 服务身份验证.

存储草稿数据:如果您使用自适应表单的草稿功能，则应该实施自定义服务提供接口(SPI)，以将草稿数据存储在更安全的存储中，如数据库。 有关更多信息，请参阅 将草稿和提交组件与数据库集成的示例.

存储提交数据:如果您使用表单门户提交存储，则应该实施自定义SPI以将提交数据存储在数据库中。 请参阅 将草稿和提交组件与数据库集成的示例 ，以查看示例集成。

您还可以编写自定义提交操作，将表单数据和附件存储在安全存储中。 请参阅 为自适应表单编写自定义提交操作 以了解更多信息。