在自适应表单中创建和使用自适应Forms片段

上次更新: 2023-12-12
版本 文章链接
AEM 6.5 单击此处
AEM as a Cloud Service 本文

虽然每个表单都针对特定目的而设计,但大多数表单中都存在一些通用区段,例如提供个人详细信息,如姓名和地址、家庭详细信息、收入详细信息等。 每次创建新表单时,表单开发人员都需要创建这些常用区段。 自适应Forms提供了一种便捷的机制,只需像创建面板或一组字段一样创建表单片段一次,即可在自适应Forms中重复使用。 这些可重用的独立区段称为自适应表单片段。

创建片段

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

从头开始创建片段

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

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

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

    注意

    请确保为片段指定唯一的名称。 如果已存在另一个同名片段,则创建片段失败。

  4. 单击以打开 表单模型 选项卡,然后从 选择自 下拉菜单,为片段选择以下模型之一:

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

      注意

      在自适应Forms中,您可以在表单中多次使用单个表单片段(基于核心组件)。 它支持基于无和模式的表单片段。

    • 表单模板 :指定使用上载到 AEM Forms 的模板 XDP 创建片段。 选择相应的 XDP 模板作为片段的表单模型。

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

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

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

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

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

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

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

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

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

在编辑模式下,您可以将任何自适应表单组件从AEM Sidekick拖放到片段上。

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

作为片段的保存面板

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

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

    注意

    如果要另存为片段的面板包含子面板,则生成的片段将包含这些子面板。

  3. 在片段创建对话框中,指定以下信息:

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

      注意

      请确保为片段指定唯一的名称。 如果已存在另一个同名片段,则创建片段失败。

    • 标题:片段的标题。 默认值为面板的标题。

    • 描述:片段的描述。

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

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

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

    • 片段模型根 :仅在基于 XSD 的自适应 Forms 中显示。 它指定片段模型的根。 您可以从下拉菜单中选择 / 或 XSD 复杂类型。 只有在选择复杂类型作为片段模型根时,才能在另一个自适应表单中重用片段。
      如果您选择 / 作为片段模型根,根中的完整XSD树在自适应表单数据模型选项卡中可见。 对于复杂类型片段模型根,自适应表单数据模型选项卡中仅显示选定复杂类型的后代。

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

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

    save-fragment

    “另存为片段”对话框

  4. 单击​确定

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

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

    编辑片段

使用片段

配置片段外观

您在Adaptive Forms中插入的任何片段都显示为占位符图像。 占位符在片段中最多显示十个子面板的标题。 您可以配置 AEM Forms 用于显示完整片段而不是占位符图像。

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

  1. 转到AEM Web控制台配置页面,网址为https:[主机]:[端口]/system/console/configMgr。

  2. 搜索并单击 自适应表单配置服务 以在编辑模式下将其打开。

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

在自适应表单中插入片段

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

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

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

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

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

    注意

    不能从自适应表单中进行创作,而是启用自适应表单片段。 此外,您无法在基于 JSON 的自适应表单和相反的方式下使用基于 XSD 的片段。

自适应表单片段按引用方式插入到了最适色彩表单中,并与独立的自适应表单片段同步。 这意味着当您更新自适应表单片段时,这些更改会在使用该片段的所有自适应 Forms 中反映出来。

在自适应表单中嵌入片段

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

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

注意

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

在片段中使用片段

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

更改片段

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

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

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

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

注意

如果您在自适应表单中多次使用非基于无格式的表单片段,则会发生片段字段之间的数据同步问题。 您可以使用 不与任何表单数据模型绑定的基于核心组件的表单片段 ,而不会出现数据同步问题。

数据绑定自动片段映射

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

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

注意

您也可以从自适应表单片段面板的自适应表单片段 Libraries 内容 AEM 中拖放绑定的适应性表单片段,并提供正确的绑定编辑引用。

管理片段

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

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

  2. 单击 选择 在 AEM Forms 用户界面工具栏并选择自适应表单片段。 工具栏显示您可以对选定的自适应表单片段执行的以下操作。

操作

描述

打开

在编辑模式下打开选定的自适应表单片段。

查看属性

打开属性面板。 从“属性”面板中,您可以查看和编辑属性、生成预览并上传所选片段的缩略图图像。 有关详细信息,请参阅 管理元数据

复制

复制选定的片段。 工具栏中会显示“粘贴”按钮。

下载

下载选定的片段。

预览

提供选项,用于将XML文件中的数据与片段合并,以HTML形式预览片段或自定义预览。

开始审核/管理审核

允许启动和管理对所选片段的审核。

创建词典

生成用于本地化所选片段的字典。

发布/取消发布

发布/取消发布选定的片段。

删除

删除选定的片段。

本地化包含片段的自适应表单

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

注意

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

使用片段时要记住的要点

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

在此页面上