Show Menu
主题×

Adaptive form fragments

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

创建片段

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

从头开始创建片段

  1. 登录AEM Forms作者实例,网址为https:// #: #/aem/forms.html。
  2. Click Create > Adaptive Form Fragment .
  3. 指定片段的标题、名称、说明和标记。
    确保为片段指定唯一的名称。 如果已存在同名的另一个片段,则无法创建该片段。
  4. 单击以打开“ 表单模型 ”选项卡,然后从“ 从中选择 ”下拉菜单中,为片段选择以下模型之一:
    • :指定从头开始创建片段,而不使用任何表单模型。
    • 表单模板 :指定使用上传到AEM Forms的XDP模板创建片段。 选择适当的XDP模板作为片段的表单模型。
    还会显示在选定表单模板中标记为片段的子表单。 您可以从下拉列表中选择自适应表单片段的子表单。
    此外,您还可以使用未在表单模板中标记为片段的子表单创建自适应表单片段,方法是在下拉框中为子表单指定SOM表达式。
    • XML架构 :指定使用上传到AEM Forms的XML架构创建片段。 您可以上传或从可用的XML架构中选择作为片段的表单模型。
    您还可以通过从下拉框中选择所选架构中存在的complexType来创建自适应表单片段。
  5. 单击 创建 ,然后单击 打开 ,以在编辑模式下使用默认模板打开片段。
在编辑模式下,您可以将任何自适应表单组件从AEM Sidekick拖放到片段上。 有关自适应表单组件的信息,请参 阅创作自适应表单的介绍
此外,如果选择XML架构或XDP表单模板作为片段的表单模型,则内容查找器中将显示一个显示表单模型层次结构的新选项卡。 它允许您将表单模型元素拖放到片段上。 添加的表单模型元素将转换为表单组件,同时保留关联XDP或XSD的原始属性。

将面板另存为片段

  1. 打开一个自适应表单,其中包含要另存为自适应表单片段的面板。
  2. 在面板工具栏中,单击 另存为片段 。 将打开另存为片段对话框。
    如果您另存为片段的面板包含子面板,则生成的片段将包括这些子面板。
  3. 在片段创建对话框中,指定以下信息:
    • 名称 :片段的名称。 默认值是面板的元素名称。 这是必填字段。
      注意​ :确保为片段指定唯一的名称。 如果已存在同名的另一个片段,则无法创建该片段。
    • 标题 :片段的标题。 默认值是面板的标题。
    • 说明 :片段的说明。
    • 标记 :标记片段的元数据。
    • 目标路径 :保存片段的存储库路径。 如果不指定路径,则会在包含自适应表单的节点旁边创建与片段名称相同的节点。 片段保存在此节点中。
    • 表单模型 :根据自适应表单的表单模型,此字段显示“ XML架构 ”、“表单模板 ”或“ ​无” 。 它是不可编辑的字段。
    • 片段模型根 :仅在基于XSD的自适应表单中显示。 它指定片段模型的根。 您可以从 下拉菜单中选择 /或XSD复杂类型。 请注意,只有在选择复杂类型作为片段模型根时,才能在另一个自适应表单中重用片段。
      如果选择 / 作为片段模型根,则根中的完整XSD树将显示在自适应表单数据模型选项卡中。 对于复杂类型片段模型根,只有选定复杂类型的后代在自适应表单数据模型选项卡中可见。
    • XSD参考 :仅在基于XSD的自适应表单中显示。 它显示XML架构的位置。
    • XDP参考 :仅在基于XDP的自适应表单中显示。 它显示XDP表单模板的位置。 ​图:“另存为 片段”对话框
  4. 单击​ 确定
    面板将保存在存储库中的指定位置或默认位置。 在自适应表单中,面板被片段的快照替换。 如下所示,“常规信息”面板及其子面板“个人信息”和“地址”将保存为片段。
    要编辑片段,请单击面 板工具栏中的 “编辑资产”。 片段在编辑模式下的新选项卡或窗口中打开。

使用片段

配置片段外观

插入自适应表单的任何片段都显示为占位符图像。 占位符显示片段中最多十个子面板的标题。 您可以配置AEM Forms以显示完整的片段而不是占位符图像。
执行以下步骤以在表单中显示完整的片段:
  1. 转到AEM web控制台配置页,其​ #: #:port/system/console/configMgr。
  2. 搜索并单击“ 自适应表单配置服务 ”以在编辑模式下打开它。
  3. 禁用 启用占位符代替片段复选框 ,以显示完整片段而非占位符图像。

在自适应表单中插入片段

您创建的自适应表单片段显示在AEM内容查找器的自适应表单片段选项卡中。 要在自适应表单中插入自适应表单片段,请执行以下操作:
  1. 在编辑模式下打开自适应表单,您要在其中插入自适应表单片段。
  2. 单击 提要栏 中的Assets -assets-browser。 在资产浏览器中,从下 拉菜单中选择自适应表单片段
    您还可以选择根据表单模型显示所有自适应表单片段或过滤器——表单模板、XML架构或基本。
  3. 将自适应表单片段拖放到自适应表单上。
    自适应表单片段未启用以在自适应表单中进行创作。 此外,不能在基于JSON的自适应表单中使用基于XSD的片段,而不能以相反的方式使用。
自适应表单片段通过引用插入到自适应表单中,并与独立的自适应表单片段同步。 这意味着,当您更新自适应表单片段时,这些更改会反映在使用片段的所有自适应表单中。

在自适应表单中嵌入片段

您可以通过单击嵌入资产来选择在自适应表单中嵌入自适应表 单片段:如​*下图像所示​* ,添加的片段的面板工具栏上的fragmentName按钮。
嵌入的片段不再与独立片段链接。 您可以从自适应表单中编辑嵌入片段中的组件。

在片段中使用片段

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

更改片段

您可以使用自适应表单片段面板的编辑组件对话框中的选择片段资源 ​,将自适应表单片段替换或更改为另一个片段。

用于数据绑定的片段的自动映射

当您使用XFA表单模板或XSD复杂类型创建自适应表单片段并将片段拖放到自适应表单时,XFA片段或XSD复杂类型将自动替换为相应的自适应表单片段,其片段模型根映射到XFA片段或XSD复杂类型。
您可以从编辑组件对话框中更改片段资产及其绑定。
您还可以从AEM内容查找器中的自适应表单片段库拖放绑定的自适应表单片段,并从自适应表单片段面板的编辑组件对话框中提供正确的绑定引用。

管理片段

您可以使用AEM表单UI对自适应表单片段执行多个操作。
  1. 转到 https://[hostname]:[port]/aem/forms.html .
  2. 单击 AEM Forms UI工具栏中的选择,然后选择自适应表单片段。 工具栏显示以下操作,您可以对选定的自适应表单片段执行这些操作。
操作
描述
打开
在编辑模式下打开选定的自适应表单片段。
查看属性
打开“属性”面板。 从“属性”面板中,您可以查看和编辑属性,生成预览,以及上传选定片段的缩略图。 有关详细信息,请参阅 管理元数据 。
复制
复制所选片段。 “粘贴”按钮显示在工具栏中。
下载
下载所选片段。
预览
提供选项以将XML文件中的数据与片段合并为HTML或自定义预览形式预览片段。 有关详细信息,请参 阅预览表单 。
开始审阅/管理审阅
允许启动和管理选定片段的审阅。 有关详细信息,请参 阅创建和管理审阅 。
创建词典
生成用于定位所选片段的词典。 有关详细信息,请参阅将自 适应表单本地化 。
发布/取消发布
发布/取消发布所选片段。
删除
删除所选片段。

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

要本地化包含自适应表单片段的自适应表单,您需要分别本地化片段和表单。 其思想是将片段本地化一次,然后在多个自适应表单中重复使用它。
片段中的本地化键不会显示在自适应表单的XLIFF文件中。

处理片段时要记住的要点

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

引用片段

可以使用引用自适应表单片段来创建表单。 有关详细信息,请参阅 引用片段