使用表单数据模型(FDM) use-form-data-model

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

数据集成

Experience Manager Forms数据集成允许您使用不同的后端数据源来创建表单数据模型(FDM),以将其用作各种自适应Forms 工作流中的架构。 它需要配置数据源并根据数据源中可用的数据模型对象和服务创建表单数据模型(FDM)。 有关更多信息,请参阅以下内容:

表单数据模型(FDM)是JSON架构的扩展,可用于执行以下操作:

创建自适应Forms和片段 create-af

您可以基于表单数据模型(FDM)创建自适应Forms和自适应表单片段。 创建自适应表单或自适应表单片段时,请执行以下操作以使用表单数据模型(FDM):

  1. 在“添加属性”屏幕上的“表单模型”选项卡中,从​ ​选择下拉列表中选择​ 表单数据模型

    create-af-1-1

  2. 选择以展开​ 选择表单数据模型。 列出所有可用的表单数据模型(FDM)。

    从数据模型中选择。

    create-af-2-1

  3. 仅限自适应表单片段)您可以仅基于表单数据模型(FDM)中的一个数据模型对象创建自适应表单片段。 展开​ 表单数据模型定义 ​下拉列表。 它列出了指定表单数据模型(FDM)中的所有数据模型对象。 从列表中选择数据模型对象。

    create-af-3

    创建基于表单数据模型(FDM)的自适应表单或自适应表单片段后,表单数据模型对象会显示在自适应表单编辑器中的内容浏览器的​ 数据源 ​选项卡中。

    note note
    NOTE
    对于自适应表单片段,只有创作时选择的数据模型对象及其关联的数据模型对象会显示在数据源选项卡中。

    data-model-objects-tab

    您可以将数据模型对象拖放到自适应表单或片段上以添加表单字段。 添加的表单字段保留元数据属性,并与数据模型对象属性绑定。 绑定可确保字段值在表单提交时在相应的数据源中更新,并在表单呈现时预填充。

使用示例数据预览 preview-ic

表单数据模型编辑器允许您为表单数据模型(FDM)中的数据模型对象生成和编辑示例数据。 您可以使用此数据预览和测试自适应Forms。 您必须在预览之前生成样本数据,如使用表单数据模型中所述。

若要预览包含示例数据的自适应表单,请在创作模式下打开该自适应表单,然后选择​ 预览

使用表单数据模型服务预填充 prefill

Experience Manager Forms提供现成的表单数据模型预填充服务,您可以为基于表单数据模型(FDM)的自适应Forms 启用该服务。 预填充服务查询自适应表单中数据模型对象的数据源,并在呈现表单或通信时相应地预填充数据。

要为自适应表单启用表单数据模型预填充服务,请打开自适应表单容器属性,然后从“基本”折叠面板的​ 预填充服务 ​下拉列表中选择​ 表单数据模型预填充服务。 然后,保存属性。

预填充服务

将提交的自适应表单数据写入数据源 write-af

当用户提交基于表单数据模型(FDM)的表单时,您可以配置表单以将数据模型对象的已提交数据写入其数据源。 为了达到此用例,Experience Manager Forms提供了表单数据模型提交操作,该操作仅可用于基于表单数据模型(FDM)的自适应Forms。 它将为数据模型对象提交的数据写入其数据源。

要配置表单数据模型提交操作,请执行以下操作:

  1. 打开内容浏览器,然后选择自适应表单的​ 指南容器 ​组件。

  2. 单击指南容器属性 指南属性 图标。这将打开“自适应表单容器”对话框。

  3. 单击​ 提交 ​选项卡。

  4. 从​ 提交操作 ​下拉列表中,选择​ 使用表单数据模型提交

    操作配置

  5. 指定要提交的​ 数据模型

  6. 单击​ 完成

在表单提交时,将配置数据模型对象的数据写入各自的数据源。 此外,您可以使用表单数据模型(FDM)和记录文档(DoR)将表单附件提交到数据源。 有关表单数据模型(FDM)的信息,请参阅AEM Forms 数据集成

NOTE
AEM as a Cloud Service提供了多种现成的提交操作来处理表单提交。 您可以在自适应表单提交操作文章中了解有关这些选项的更多信息。

您还可以使用二进制数据模型对象属性将表单附件提交到数据源。 执行以下操作以将附件提交到JDBC数据源:

  1. 将包含二进制属性的数据模型对象添加到表单数据模型(FDM)。

  2. 在自适应表单中,将​ 文件附件 ​组件从组件浏览器拖放到自适应表单上。

  3. 选择以选择添加的组件,然后选择 settings_icon 以打开该组件的“属性”浏览器。

  4. 在“绑定引用”字段中,选择 foldersearch_18 ,然后导航以选择您在表单数据模型(FDM)中添加的二进制属性。 根据需要配置其他属性。

    选择 check-button 以保存属性。 附件字段现在绑定到表单数据模型(FDM)的二进制属性。

  5. 在自适应表单容器属性的提交部分中,启用​ 提交表单附件。 在提交表单时,它将二进制属性字段中的附件提交到数据源。

使用规则在自适应Forms中调用服务 invoke-services

在基于表单数据模型(FDM)的自适应表单中,您可以创建规则以调用在表单数据模型(FDM)中配置的服务。 规则中的​ 调用服务 ​操作列出了表单数据模型(FDM)中的所有可用服务,并允许您选择服务的输入和输出字段。 您还可以使用​ 设置值 ​规则类型来调用表单数据模型服务,并将字段的值设置为服务返回的输出。

例如,以下规则调用一个将Employee ID作为输入的get服务,返回的值将填充到表单中对应的Dependent ID、Last Name、First Name和Gender字段中。

调用服务

此外,您可以使用guidelib.dataIntegrationUtils.executeOperation API在规则编辑器的代码编辑器中编写JavaScript。

使用自定义函数调用表单数据模型(FDM) invoke-form-data-model-using-custom-functions

您可以使用自定义函数🔗从规则编辑器调用表单数据模型。 列入允许列表要调用表单数据模型(FDM),请将表单数据模型添加到。 要将表单数据模型添加到允许列表,请执行以下操作:

  1. 转到https://server:host/system/console/configMgr上的Experience ManagerWeb控制台。
  2. 找到​ 用于服务调用的自适应表单级表单数据模型白名单 — 配置工厂
  3. 单击 加号图标 图标以添加配置。
  4. 添加​ 内容路径模式 ​以指定自适应Forms的位置。 默认情况下,该值是/content/forms/af/(.*),其中包括所有自适应Forms。 您还可以指定特定自适应表单的路径。
  5. 添加​ 表单数据模型路径模式 ​以指定表单数据模型(FDM)的位置。 默认情况下,值为/content/dams/formsanddocuments-fdm/(.*),其中包括所有表单数据模型(FDM)。 您还可以指定特定表单数据模型(FDM)的路径。
  6. 保存设置。

添加的配置保存在用于服务调用的表单数据模型的​ 自适应表单级白名单中 — 配置工厂 ​选项。

NOTE
要通过AEM原型项目使用自定义函数从规则编辑器调用表单数据模型(FDM),请执行以下操作:
  1. 创建配置文件
  2. 设置getContentPathPattern和getFormDataModelPathPattern的属性。
  3. 部署项目。

相关文章

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab