教程：创建表单数据模型 tutorial-create-form-data-model

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

1. MySQL从 下载 http://www.java2s.com/ref/jar/download-orgosgiservicejdbc100jar-file.htmlJDBC 驱动程序 OSGi 捆绑包。

2. 以管理员身份登录AEM Forms创作实例，然后转到AEM Web控制台包。 默认URL为https://localhost:4502/system/console/bundles。

3. 选择​ 安装/更新。 出现上载/安装包对话框。

4. 选择​ 选择文件 ​浏览并选择MySQL JDBC驱动程序OSGi包。 选择​ 启动包 ​和​ 刷新包，然后选择​ 安装或更新。 Oracle Corporation’s确保 的 MySQL JDBC 驱动程序处于活动状态。驱动程序已安装。

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

1. 转到位于 https://localhost:4502/system/console/configMgr🔗 的 AEM Web 控制台。

2. 找到 Apache Sling 连接池数据源 配置。 选择此项可在编辑模式下打开配置。

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

   • 数据源名称： ​您可以指定任意名称。 例如，指定​ WeRetailMySQL。
   • 数据源服务属性名称：指定包含数据源名称的服务属性的名称。 在将数据源实例注册为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

   note note
   NOTE
   MySQL当数据库位于防火墙后面时，数据库主机名不是公共 DNS。必须将数据库的 IP 地址添加到 AEM 主机的 /etc/hosts 文件中。

   • 用户名： ​数据库用户名。 需要启用 JDBC 驱动程序才能与数据库建立连接。
   • 密码： ​数据库的密码。 必须启用JDBC驱动程序才能与数据库建立连接。

   note note
   NOTE
   AEM Forms不支持MySQL的NT身份验证。 转到 https://localhost:4502/system/console/configMgr🔗 的AEM Web控制台，然后搜索“Apache Sling连接池数据源”。对于“JDBC 连接 URI”属性，请将“integratedSecurity”的值设置为 False，并使用创建的用户名和密码与数据库连接 MySQL 。

   • 借用时测试： 启用 借用 时测试选项。

   • 退货时测试： ​启用退货​ ​ ​时测试选项。

   • 验证查询： ​指定SQL SELECT查询以验证池中的连接。 查询必须至少返回一行。 例如，从customerdetails ​中选择*。

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

     保留具有默认值的其他属性并选择​ 保存。

     将创建类似于以下内容的配置。

     

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

选择​ 创建 > 表单数据模型。

在“创建表单数据模型”对话框中，为表单数据模型指定​ 名称。 例如，customer-shipping-billing-details。 选择​ 下一步。

选择数据源屏幕列出了所有已配置的数据源。 选择​ WeRetailMySQL ​数据源，然后选择​ 创建。

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

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

已在表单数据模型中配置所选数据源​ WeRetailMySQL。

展开WeRailMySQL数据源树。 从​ weretail > customerdetails ​架构中选择以下数据模型对象和服务，以便您可以形成数据模型：

• 数据模型对象：

  • id
  • name
  • shippingAddress
  • 城市
  • 州/省
  • 邮政编码

• 服务：

  • get
  • 更新

选择​ 添加选定项 ​以将选定数据模型对象和服务添加到表单数据模型。

配置数据模型对象的读取和写入服务。

1. 选择​ customerdetails ​数据模型对象并选择​ 编辑属性。

2. 从读取服务下拉列表中选择​ get。 将自动添加​ id ​参数，该参数是customerdetails数据模型对象中的主键。 选择 并按如下方式配置参数。

   

3. 同样，选择​ 更新 ​作为写入服务。 customerdetails ​对象会自动添加为参数。 参数的配置如下所示。

   

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

   

4. 选择“完成​ ” ​以保存数据模型对象属性。然后，选择 保存 以保存表单数据模型。

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

   

转到​ 服务 ​选项卡并配置​ get ​和​ 更新 ​服务。

1. 选择​ get ​服务并选择​ 编辑属性。 将打开属性对话框。

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

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

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

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

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

     customerdetail架构

   • 返回数组：禁用​ 返回数组 ​选项。

   • 参数：选择名为​ ID ​的参数。

   选择​ 完成。 用于从MySQL数据库检索客户详细信息的服务已配置。

   

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

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

   • 标题：指定服务的标题。 例如，更新送货地址。

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

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

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

     customerdetail架构

   • 输出类型：选择​ 布尔值。

   • 参数：选择参数名称​ ID ​和​ customerdetails。

   选择​ 完成。 已配置​ 更新 ​服务以更新MySQL数据库中的客户详细信息。

   

转到​ 模型 ​选项卡，选择​ customerdetails ​数据模型对象，然后选择​ 测试模型对象。

在测试模型/服务窗口中，从​ 选择模型/服务 ​下拉列表中选择​ 读取模型对象。

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

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

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

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

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