自适应表单片段 adaptive-form-fragments

版本
文章链接
AEM as a Cloud Service
单击此处
AEM 6.5
本文

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

虽然每个表单都专为特定目的而设计,但大多数表单中都存在一些通用区段,例如提供个人详细信息,如姓名和地址、家庭详细信息和收入详细信息。 每次创建新表单时,表单开发人员都需要创建这些常用区段。

自适应表单提供了一种便捷的机制,只需创建一次表单段(如面板或一组字段),并在自适应表单中重复使用它们。 这些可重复使用的独立片段称为自适应表单片段。

NOTE
您可以使用表单片段组件🔗的“配置”对话框和“设计”对话框轻松地为用户自定义片段体验。

创建片段 create-a-fragment

您可以从头开始创建自适应表单片段,也可以将现有自适应表单中的面板保存为片段。

从头开始创建片段 create-fragment-from-scratch

  1. 在https://登录AEM Forms创作实例​[主机名]:[端口]/aem/forms.html.

  2. 单击 创建>自适应表单片段.

  3. 指定片段的标题、名称、描述和标记。

    note note
    NOTE
    请确保为片段指定唯一的名称。 如果存在另一个同名片段,则创建该片段失败。
  4. 单击以打开 表单模型 选项卡,然后从 选择自 下拉菜单,为片段选择以下模型之一:

    • :指定从头开始创建片段,而不使用任何表单模型。

      note note
      NOTE
      在基于核心组件的自适应Forms中,您可以在表单中多次使用单个表单片段。 它支持基于无和基于架构的表单片段。
    • 表单模板:指定使用上传到AEM Forms的XDP模板创建片段。 选择适当的XDP模板作为片段的表单模型。

    使用表单模板作为模型创建自适应表单

    还会显示选定表单模板中标记为片段的子表单。 您可以从下拉列表中选择自适应表单片段的子表单。

    从指定的表单模板中选择子表单

    此外,您还可以通过在下拉框中指定子表单的SOM表达式,使用在表单模板中未标记为片段的子表单创建自适应表单片段。

    • XML架构:指定使用上载到AEM Forms的XML架构创建片段。 您可以上传或从可用的XML架构中选择作为片段的表单模型。

    创建基于XML架构的自适应表单片段作为模型

    您还可以通过从下拉框中选择所选架构中存在的complexType来创建自适应表单片段。

    从指定的XML架构模型中选择复杂类型

  5. 单击 创建 然后单击 打开 以在编辑模式下使用默认模板打开片段。

在编辑模式下,您可以将任何自适应表单组件从AEM Sidekick拖放到片段上。 有关自适应表单组件的信息,请参阅 自适应表单创作简介.

此外,如果您选择了XML架构或XDP表单模板作为片段的表单模型,则内容查找器中会显示一个显示表单模型层次结构的新选项卡。 它可让您将表单模型元素拖放到片段上。 添加的表单模型元素被转换为表单组件,同时保留关联XDP或XSD的原始属性。

将面板另存为片段 save-panel-as-a-fragment

  1. 打开自适应表单,其中包含要另存为自适应表单片段的面板。

  2. 在面板工具栏中,单击 另存为片段. 另存为片段对话框随即打开。

    note note
    NOTE
    如果要另存为片段的面板包含子面板,则生成的片段将包含这些面板。
  3. 在片段创建对话框中,指定以下信息:

    • 名称:片段的名称。 默认值为面板的元素名称。 它是必填字段。

      note note
      NOTE
      请确保为片段指定唯一的名称。 如果存在另一个同名片段,则创建该片段失败。
    • 标题:片段的标题。 默认值为面板的标题。

    • 描述:片段的描述。

    • 标记:片段的标记元数据。

    • 目标路径:保存片段的存储库路径。 如果不指定路径,则会在包含自适应表单的节点旁边创建与片段名称相同的节点。 片段将保存在此节点中。

    • 表单模型:根据自适应表单的表单模型,此字段显示 XML架构表单模板,或 . 它是不可编辑的字段。

    • 片段模型根:仅在基于XSD的自适应表单中显示。 它指定片段模型的根。 您可以选择 / 或XSD复杂类型。 只有在选择复杂类型作为片段模型根时,才能在另一个自适应表单中重用片段。
      如果您选择 / 作为片段模型根,根中的完整XSD树在自适应表单数据模型选项卡中可见。 对于复杂类型片段模型根,自适应表单数据模型选项卡中仅显示选定复杂类型的后代。 如果您创建片段并选择复杂类型作为 片段模型根,无论在何处使用该复杂类型,您都可以将其用在同一个表单内或跨多个表单使用。

    • XSD参照:仅在基于XSD的自适应表单中显示。 它显示XML方案的位置。

    • XDP参照:仅在基于XDP的自适应表单中显示。 它显示XDP表单模板的位置。

    save-fragment

    “另存为片段”对话框

  4. 单击​ 确定

    面板将保存在存储库中的指定位置或默认位置。 在自适应表单中,面板被片段的快照所取代。 如下所示,“常规信息”面板及其子面板“个人信息和地址”将另存为片段。

    要编辑片段,请单击 编辑资源 在面板工具栏中。 片段在编辑模式下的新选项卡或窗口中打开。

    编辑片段

使用片段 working-with-fragments

配置片段外观 configure-fragment-appearance

您在自适应表单中插入的任何片段都会显示为占位符图像。 占位符在片段中最多显示十个子面板的标题。 您可以将AEM表单配置为显示完整的片段而不是占位符图像。

执行以下步骤,以便您可以在表单中显示完整的片段:

  1. 转到 https:[host:[ port ]]/system/console/configMgr 上的 AEM Web 控制台配置页面。

  2. 搜索并选择自适应表单和交互式通信 Web 渠道配置​ ​在编辑模式下打开它。

  3. 禁用 启用占位符代替片段 复选框,以便您可以显示完整的片段,而不是占位符图像。

在自适应表单中插入片段 insert-a-fragment-in-an-adaptive-form

您创建的自适应表单片段显示在AEM内容查找器的自适应表单片段选项卡中。 要在自适应表单中插入自适应表单片段,请执行以下操作:

  1. 在编辑模式下打开自适应表单,您要在其中插入自适应表单片段。

  2. 单击 资产 assets浏览器 在侧栏中。 在资产浏览器中,选择 自适应表单片段 从下拉菜单中查找。

    您还可以选择显示所有自适应表单片段或根据其表单模型(表单模板、XML架构或基本)进行筛选。

  3. 将自适应表单片段拖放到自适应表单上。

    note note
    NOTE
    自适应表单片段未在自适应表单内进行创作。 此外,在基于JSON的自适应表单中不能以相反的方式使用基于XSD的片段。

自适应表单片段在自适应表单中通过引用插入,并与独立的自适应表单片段同步。 这意味着当您更新自适应表单片段时,更改会反映在使用片段的所有自适应表单中。

在自适应表单中嵌入片段 embed-a-fragment-in-adaptive-form

您可以通过单击 嵌入资源: <fragmentname> 按钮进行添加,如以下示例图像所示。

在自适应表单中嵌入表单片段

NOTE
嵌入的片段不再与独立片段链接。 您可以从自适应表单中编辑嵌入片段中的组件。

在片段中使用片段 using-fragments-within-fragments

您可以创建嵌套的自适应表单片段,这意味着您可以将片段拖放到另一个片段中,并且可以具有嵌套的片段结构。

更改片段 change-fragments

您可以使用替换或更改自适应表单片段 选择片段资源 自适应表单片段面板的“编辑组件”对话框中的属性。

为自适应表单片段生成记录文档 generate-DOR-for-fragments

记录文档(DOR)帮助您以打印或文档格式保留表单信息。 因此,它可以帮助您以后随时跟踪有关客户的信息,您还可以使用记录文档以PDF格式将表单和内容存档在一起。 了解如何为自适应表单片段生成记录文档.

在自适应表单中多次使用表单片段 using-form-fragment-mutiple-times-in-af

您可以在自适应表单中多次使用基于架构的表单片段,以唯一地保存每个表单片段字段的数据。 例如,您可以使用地址表片段收集地址详细信息,以便在贷款申请表中永久性、通信和显示生活地址。

在自适应表单中使用多个片段

NOTE
  • 如果您在自适应表单中多次使用基于无的表单片段,则会在片段的字段之间同步数据。 基于核心组件的表单片段中不会出现数据同步问题,在这种情况下,您可以在表单中多次使用基于架构或基于无的片段。

数据绑定的片段自动映射 auto-mapping-of-fragments-for-data-binding

当您使用XFA表单模板或XSD复杂类型创建自适应表单片段并将片段拖放到自适应表单时,XFA片段或XSD复杂类型会自动替换为相应的自适应表单片段,其片段模型根映射到XFA片段或XSD复杂类型。

您可以通过编辑组件对话框更改片段资源及其绑定。

NOTE
您还可以从AEM内容查找器中的自适应表单片段库拖放绑定的自适应表单片段,并从自适应表单片段面板的“编辑组件”对话框中提供正确的绑定引用。

管理片段 manage-fragments

您可以使用AEM Forms UI对自适应表单片段执行多项操作。

  1. 转到 https://[hostname]:'port'/aem/forms.html.

  2. 单击 选择 在AEM Forms UI工具栏中,选择一个自适应表单片段。 工具栏显示您可以对选定的自适应表单片段执行的以下操作。

操作
描述
打开
在编辑模式下打开选定的自适应表单片段。
查看属性
打开属性面板。 从“属性”面板中,您可以查看和编辑属性、生成预览并上传所选片段的缩略图图像。 有关更多信息,请参阅 管理元数据.
复制
复制选定的片段。 工具栏中会显示“粘贴”按钮。
下载
下载选定的片段。
预览
提供选项,用于将XML文件中的数据与片段合并,以HTML形式预览片段或自定义预览。 有关详细信息,请参阅 预览表单
开始审核/管理审核
允许启动和管理对所选片段的审核。 有关更多信息,请参阅 创建和管理审阅.
创建词典
生成用于本地化所选片段的字典。 有关更多信息,请参阅 本地化自适应表单.
发布/取消发布
发布/取消发布选定的片段。
删除
删除选定的片段。

本地化包含片段的自适应表单 localizing-adaptive-form-containing-fragments

要本地化包含自适应表单片段的自适应表单,必须单独本地化片段和表单。 其思想是将片段本地化一次,并在多个自适应表单中重复使用。

NOTE
片段中的本地化键不会出现在自适应表单的XLIFF文件中。

使用片段时要记住的要点 key-points-to-remember-when-working-with-fragments

  • 确保片段名称是唯一的。 如果存在具有相同名称的现有片段,则创建片段失败。
  • 在基于XDP的自适应表单中,如果您将面板另存为包含其他XDP片段的片段,则生成的片段将自动绑定到子XDP片段。 如果存在基于XSD的自适应表单,则生成的片段将绑定到架构根。
  • 创建自适应表单片段时,会在CRXDE Lite中创建片段节点,该节点与自适应表单的guideContainer节点类似。
  • 不支持使用其他表单数据模型的自适应表单中的片段。 例如,基于XDP的片段在基于XSD的自适应表单中不受支持,反之亦然。
  • 自适应表单片段可通过AEM内容查找器中的自适应表单片段选项卡使用。
  • 通过引用插入或在自适应表单中嵌入独立自适应表单片段中的任何表达式、脚本或样式都会保留。
  • 您无法从自适应表单中编辑通过引用插入的自适应表单片段。 要编辑,请编辑独立的自适应表单片段或将片段嵌入自适应表单中。
  • 发布自适应表单时,必须发布在自适应表单中通过引用插入的独立自适应表单片段。
  • 当您重新发布更新的自适应表单片段时,更改会反映在使用该片段的自适应表单的已发布实例中。
  • 包含验证组件的自适应表单不支持匿名用户。 此外,不建议在自适应表单片段中使用验证组件。
  • 仅限 Mac)为确保表单片段功能在所有场景中都能完美运行,请将以下条目添加到 /private/etc/hosts 文件中:
    127.0.0.1 <Host machine> 主机:部署AEM Forms的Apple Mac计算机。

引用片段 reference-fragments

提供了可用于创建表单的参考自适应表单片段。 有关更多信息,请参阅 引用片段.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2