Tutorial: Create form data model

本教程是创建第一个自 适应表单系列中的一个步骤 。 建议按照时间顺序按照系列来了解、执行和演示完整的教程用例。

关于教程

AEM数 Forms 据集成模块允许您从不同的后端数据源(如AEM用户用户档案、RESTful Web服务、基于SOAP的Web服务、OData服务和关系型数据库)创建表单数据模型。 您可以在表单数据模型中配置数据模型对象和服务，并将其与自适应表单关联。 自适应表单字段绑定到数据模型对象属性。 这些服务使您能够预填自适应表单并将提交的表单数据写入数据模型对象。

有关表单数据集成和表单数据模型的更多信息，请参 阅AEM Forms数据集成。

本教程将指导您逐步准备、创建、配置表单数据模型并将其与自适应表单关联。 在本教程的结尾，您将能够：

• 将MySQL数据库配置为数据源
• 使用MySQL数据库创建表单数据模型
• 配置表单数据模型
• 测试表单数据模型

表单数据模型将类似于：

A.配置 的数 据源 B.数据 源模式 C.Available Services D.Data​​ Model对象E.Configured Services

前提条件

在开始之前，请确保您具有以下各项：

• MySQL 数据库，示例数据如创建第一个自适应表单的“ 先决条件”部分中所述
• 如捆绑JDBC数 MySQL 据库驱动程序中 所述，OSGi bundle for JDBC driver
• 如第一个教程创建自适应表 单中所述

第1步：将MySQL数据库配置为数据源

您可以配置不同类型的数据源以创建表单数据模型。 对于本教程，我们将配置您配置并填充示例数据的MySQL数据库。 有关其他受支持数据源以及如何配置数据源的信息，请参 阅AEM Forms数据集成。

执行以下操作以配置数 MySQL 据库：

1. 将数据库的JDBC驱 MySQL 动程序作为OSGi捆绑包安装：

   1. 以管理员身 Forms 份登录到AEM作者实例，并转到AEM web控制台包。 默认URL为 https://localhost:4502/system/console/bundles。

   2. 点按 安装／更新。 将显 示“上传／安装包 ”对话框。

   3. 点按 选择文件 ，浏览并选择JDBC驱动 MySQL 程序OSGi捆绑包。 选择 开始包 和刷 新包，然后点 按安装或更新。 确保“JDBC Oracle Corporation’s 驱动程序” MySQL 处于活动状态。 已安装驱动程序。

2. 将数 MySQL 据库配置为数据源：

   1. 转到AEM Web控制台，网 址为https://localhost:4502/system/console/configMgr。

   2. 找到 Apache Sling Connection池化DataSource配置 。 点击以在编辑模式下打开配置。

   3. 在配置对话框中，指定以下详细信息：

      • 数据源名称： 您可以指定任何名称。 例如，指定 WeRetailMySQL。

      • DataSource服务属性名称:指定包含DataSource名称的服务属性的名称。 将数据源实例注册为OSGi服务时指定它。 例如， datasource.name。

      • JDBC驱动程序类:指定JDBC驱动程序的Java类名称。 对于 MySQL 数据库， 请指定com.mysql.jdbc.Driver。

      • JDBC连接URI:指定数据库的连接URL。 对于 MySQL 在端口3306和模式weretail上运行的数据库，URL为： jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8

      • 用户名： 数据库的用户名。 需要启用JDBC驱动程序以建立与数据库的连接。

      • 密码： 数据库的口令。 需要启用JDBC驱动程序以建立与数据库的连接。

      • 借阅测试： 启用“ 借阅时测试 ”选项。

      • 返回时测试： 启用“ 返回时测试 ”选项。

      • 验证查询: 指定SQL SELECT查询以验证池中的连接。 查询必须至少返回一行。 例如，从 客户详细信息中选择*。

      • 事务隔离:将该值设 置为READ_COMMITTED。

        保留其他属性并 点按 “保 存”。

        将创建与以下配置类似的配置。

        

Step 2: Create form data model

AEM提 Forms 供直观的用户界面， 用于从配置的数据源创建表 单数据模型。 您可以在表单数据模型中使用多个数据源。 对于我们的用例，我们将使用配置的 MySQL 数据源。

执行以下操作以创建表单数据模型：

1. 在AEM创作实例中，导航到 Forms > 数据集成。

2. Tap Create > Form Data Model.

3. 在“创建表单数据模型”对话框中， 指定表 单数据模型的名称。 例如， customer-shipping-billing-details。 点按 下一步。

4. 选择数据源屏幕列表所有已配置的数据源。 选择 WeRetailMySQL 数据源并点按 创建。

   

将创 建客户——发运——结帐——详细 -表单数据模型。

第3步：配置表单数据模型

配置表单数据模型涉及：

• 添加数据模型对象和服务
• 为数据模型对象配置读写服务

执行以下操作以配置表单数据模型：

1. 在AEM创作实例上，导航到 Forms > 数据集成。 默认URL为 https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm。

2. 此处 列出您之前创建的 customer-shipping-billing-details表单数据模型。 在编辑模式下打开它。

   所选数据源 WeRetailMySQL 是在表单数据模型中配置的。

   

3. 展开WeRailMySQL数据源树。 从Weretail > Customerdetails模式中选择以 下数据模型 对 象和服务 ，以形成数据模型：

   • 数据模型对象:

     • id
     • 名称
     • shippingAddress
     • 城市
     • 状态
     • zipcode

   • 服务:

     • 获取
     • 更新

   点按 添加选定 ，以将选定数据模型对象和服务添加到表单数据模型。

   

   注意

   JDBC数据源的默认get、update和insert服务是随附表单数据模型的现成提供。

4. 为数据模型对象配置读和写服务。

   1. 选择客 户详细信 息数据模型对象，然后点 按编辑属性。

   2. 从 读取 服务下拉菜单中选择获取。 将自 动添加 id参数，该参数是customerdetails数据模型对象中的主键。 点 ，然后按如下配置参数。

      

   3. 同样，选 择 “更新”作为“写入服务”。 customerdetails 对象将 作为参数自动添加。 参数配置如下。

      

      按如下方式添 加和 配置id参数。

      

   4. 点按 完成 ，以保存数据模型对象属性。 然后，点按 保存 ，以保存表单数据模型。

      get 和 update服 ​​务将作为数据模型对象的默认服务添加。

      

5. 转到“服 务 ”选项卡， 配置 get ​​和update services。

   1. 选择get服 务 ，然后点 按编辑属性。 属性对话框打开。

   2. 在“编辑属性”对话框中指定以下内容：

      • 标题:指定服务的标题。 例如：检索送货地址。

      • 描述:指定包含服务的详细功能的说明。 例如：

        此服务从数据库检索发运地址和其他客户详细 MySQL 信息

      • 输出模型对象:选择包含客户数据的模式。 例如：

        客户详细信息模式

      • 返回数组:禁用“ 返回数组 ”选项。

      • 参数:选择名为 ID的参数。

      点按​完成。已配置从MySQL数据库检索客户详细信息的服务。

      

   3. 选择更新 服务 ，然后点 按编辑属性。 属性对话框打开。

   4. 在“编辑属性”对 话框中指定 :

      • 标题:指定服务的标题。 例如，更新发运地址。

      • 描述:指定包含服务的详细功能的说明。 例如：

        此服务更新MySQL数据库中的送货地址和相关字段

      • 输入模型对象:选择包含客户数据的模式。 例如：

        客户详细信息模式

      • 输出类型:选择 布尔。

      • 参数:选择名为ID 和 customerdetails 的参数。

      点按​完成。已配 置用于 更新数据库中客户详细信息 MySQL 的更新服务。

      

配置表单数据模型中的数据模型对象和服务。 您现在可以测试表单数据模型。

Step 4: Test form data model

您可以测试数据模型对象和服务，以验证表单数据模型配置是否正确。

执行以下操作以运行测试：

1. 转到“模 型 ”选项卡，选择 customerdetails 数据模型对象，然 后点按测试模型对象。

2. 在“测 试模型／服务 ”窗口中，从“选 择模型／服务” 下拉菜单中选择“读取模型对象 ​​”。

3. 在customerdetails 部分 ，为已配置数据库中 存在的 id参数指定一个值， MySQL 然后点按 测试。

   将提取与指定ID关联的客户详细信息并在“输 出 ”部分中显示，如下所示。

   

4. 同样，您也可以测试Write模型对象和服务。

   在以下示例中，更新服务成功更新数据库中id 7102715的地址详细信息。

   

   现在，如果您再次测试id 7107215的读取模型服务，它将获取并显示更新的客户详细信息，如下所示。