配置数据源 configure-data-sources

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

数据集成

Experience Manager Forms数据集成允许您配置并连接到不同的数据源。 支持开箱即用的以下类型:

  • 关系数据库 — MySQL、Microsoft® SQL Server、IBM® DB2®、postgreSQL和Oracle RDBMS
  • RESTful Web服务
  • 基于SOAP的Web服务
  • OData服务(版本4.0)
  • Microsoft® Dynamics
  • SalesForce
  • Microsoft® Azure Blob存储

数据集成支持现成的OAuth2.0(授权代码客户端凭据)、基本身份验证和API密钥身份验证类型,并允许实施自定义身份验证以访问Web服务。 在Experience Manageras a Cloud Service中配置了RESTful、基于SOAP和OData服务,而在Experience Manager Web控制台中配置了关系数据库的JDBC和Experience Manager用户配置文件的连接器。

配置关系数据库 configure-relational-database

先决条件

在使用Experience Manager Web控制台配置配置关系数据库之前,必须:

配置关系数据库的步骤

可以使用Experience Manager Web控制台配置来配置关系数据库。 执行以下操作:

  1. 转到位于https://server:host/system/console/configMgr的Experience Manager Web控制台。

  2. 找到​ Day Commons JDBC连接池 ​配置。 选择以在编辑模式下打开配置。

    JDBC连接器池

  3. 在配置对话框中,指定要配置的数据库的详细信息,例如:

    • JDBC驱动程序的Java™类名称

    • JDBC连接URI

    • 用于与JDBC驱动程序建立连接的用户名和密码

    • 在​ 验证查询 ​字段中指定SQL SELECT查询以验证来自池的连接。 查询必须至少返回一行。 根据您的数据库,指定以下选项之一:

      • SELECT 1 (MySQL和MS® SQL)
      • 从双选件中选择1(Oracle)
    • 数据源的名称

    用于配置关系数据库的示例字符串:

    code language-text
       "datasource.name": "sqldatasourcename-mysql",
       "jdbc.driver.class": "com.mysql.jdbc.Driver",
       "jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
    
    note note
    NOTE
    有关更多详细信息,请参阅使用JDBC DataSourcePool🔗的SQL连接。
  4. 选择​ 保存 ​以保存配置。

现在,您可以将配置的关系数据库与表单数据模型(FDM)一起使用。

为云服务配置配置文件夹 cloud-folder

配置RESTful、SOAP和OData服务的云服务需要配置云服务文件夹。

Experience Manager中的所有云服务配置都已合并到Experience Manager存储库的/conf文件夹中。 默认情况下,conf文件夹包含global文件夹,您可以在其中创建云服务配置。 但是,必须为云配置手动启用它。 您还可以在conf中创建其他文件夹以创建和组织Cloud Service配置。

要为云服务配置配置文件夹,请执行以下操作:

  1. 转到​ 工具>常规>配置浏览器

  2. 执行以下操作可为云配置启用全局文件夹,或跳过此步骤为云服务配置创建和配置其他文件夹。

    1. 在​ 配置浏览器 ​中,选择global文件夹并选择​ 属性

    2. 在​ 配置属性 ​对话框中,启用​ 云配置

    3. 选择​ 保存并关闭 ​以保存配置并退出对话框。

  3. 在​ 配置浏览器 ​中,选择​ 创建

  4. 在​ 创建配置 ​对话框中,指定文件夹的标题,并启用​ 云配置

  5. 选择​ 创建 ​以创建为云服务配置启用的文件夹。

配置RESTful Web服务 configure-restful-web-services

可在Swagger定义文件中使用JSON或YAML格式的Swagger规范对RESTful Web服务进行描述。 若要在Experience Manageras a Cloud Service中配置RESTful Web服务,请确保您的文件系统上有Swagger文件(Swagger版本2.0)或Swagger文件(Swagger版本3.0),或者托管该文件的URL。

为Open API规范版本2.0配置RESTful服务 configure-restful-services-open-api-2.0

  1. 转到​ 工具>Cloud Service>数据源。 选择以选择要创建云配置的文件夹。

    有关为云服务配置创建和配置文件夹的信息,请参阅为云服务配置文件夹

  2. 选择​ 创建 ​以打开​ 创建数据Source配置向导。 指定配置的名称和标题,从​ 服务类型 ​下拉列表中选择​ RESTful服务,浏览并选择配置的缩略图图像,然后选择​ 下一步

  3. 为RESTful服务指定以下详细信息:

    • 从Swagger Source下拉列表中选择URL或文件,并相应地指定​ Swagger定义文件的Swagger URL或从本地文件系统上传Swagger文件。

    • 根据​ Swagger Source输入,以下字段已预填充值:

      • 方案:REST API使用的传输协议。 下拉列表中显示的方案类型数取决于Swagger源中定义的方案。
      • 主机:提供REST API的主机的域名或IP地址。 它是必填字段。
      • 基本路径:所有API路径的URL前缀。 它是一个可选字段。
        如有必要,请编辑这些字段的预填充值。
    • 选择身份验证类型 — None、OAuth2.0(授权代码客户端凭据)、基本身份验证、API密钥或自定义身份验证 — 以访问RESTful服务,并相应地提供身份验证的详细信息。

    如果选择​ API密钥 ​作为身份验证类型,请指定API密钥的值。 API密钥可作为请求标头或查询参数发送。 从​ 位置 ​下拉列表中选择其中一个选项,并在​ 参数名称 ​字段中相应地指定标头名称或查询参数。

  4. 选择​ 创建 ​以创建RESTful服务的云配置。

为Open API规范版本3.0配置RESTful服务 configure-restful-services-open-api-3.0

  1. 转到​ 工具>Cloud Service>数据源。 选择以选择要创建云配置的文件夹。

    有关为云服务配置创建和配置文件夹的信息,请参阅为云服务配置文件夹

  2. 选择​ 创建 ​以打开​ 创建数据Source配置向导。 指定配置的名称和标题,从​ 服务类型 ​下拉列表中选择​ RESTful服务,浏览并选择配置的缩略图图像,然后选择​ 下一步

  3. 为RESTful服务指定以下详细信息:

    • 从Swagger Source下拉列表中选择URL或文件,并相应地指定​ Swagger定义文件的Swagger 3.0 URL或从本地文件系统上传Swagger文件。
    • 根据​ Swagger Source输入,显示与目标服务器的连接信息。
    • 选择身份验证类型 — None、OAuth2.0(授权代码客户端凭据)、基本身份验证、API密钥或自定义身份验证 — 以访问RESTful服务,并相应地提供身份验证的详细信息。

    如果选择​ API密钥 ​作为身份验证类型,请指定API密钥的值。 API密钥可作为请求标头或查询参数发送。 从​ 位置 ​下拉列表中选择其中一个选项,并在​ 参数名称 ​字段中相应地指定标头名称或查询参数。

  4. 选择​ 创建 ​以创建RESTful服务的云配置。

RESTful服务Open API规范版本3.0不支持的一些操作包括:

  • 回调
  • oneof/anyof
  • 远程引用
  • 链接
  • 针对单次操作的不同MIME类型的不同请求主体

有关详细信息,请参阅OpenAPI 3.0规范

表单数据模型(FDM) HTTP客户端配置可优化性能 fdm-http-client-configuration

Experience Manager Forms在与RESTful Web服务集成时形成数据模型,因为数据源包括用于性能优化的HTTP客户端配置。

为REST数据源​ 配置设置 ​表单数据模型HTTP客户端配置的以下属性以指定正则表达式:

  • 使用http.connection.max.per.route属性设置表单数据模型(FDM)和RESTful Web服务之间允许的最大连接数。 默认值为20个连接。

  • 使用http.connection.max属性为每个路由指定允许的最大连接数。 默认值为40个连接。

  • 使用http.connection.keep.alive.duration属性指定持久HTTP连接保持活动状态的持续时间。 默认值为15秒。

  • 使用http.connection.timeout属性指定Experience Manager Forms服务器等待建立连接的持续时间。 默认值为10秒。

  • 使用http.socket.timeout属性指定两个数据包之间不活动的最长时间。 默认值为30秒。

以下JSON文件显示了一个示例:

{
   "http.connection.keep.alive.duration":"15",
   "http.connection.max.per.route":"20",
   "http.connection.timeout":"10",
   "http.socket.timeout":"30",
   "http.connection.idle.connection.timeout":"15",
   "http.connection.max":"40"
}
  1. 为REST数据源​ 选择 ​表单数据模型HTTP客户端配置。

  2. 在REST数据源的表单数据模型HTTP客户端配置对话框中:

    • 在​ 连接限制的 ​字段中指定表单数据模型(FDM)和RESTful Web服务之间允许的最大连接数。 默认值为20个连接。

    • 在​ 每个路由的连接限制 ​字段中为每个路由指定允许的最大连接数。 缺省值为两个连接。

    • 在​ 保持活动 ​字段中指定持续HTTP连接保持活动状态的持续时间。 默认值为15秒。

    • 在​ 连接超时 ​字段中指定Experience Manager Forms服务器等待连接建立的持续时间。 默认值为10秒。

    • 在​ 套接字超时 ​字段中指定两个数据包之间的最长不活动时间段。 默认值为30秒。

配置SOAP Web服务 configure-soap-web-services

基于SOAP的Web服务使用Web服务描述语言(WSDL)规范进行描述。 Experience Manager Forms不支持RPC样式的WSDL模型。

要在Experience Manageras a Cloud Service中配置基于SOAP的Web服务,请确保您拥有该Web服务的WSDL URL,并执行以下操作:

  1. 转到​ 工具>Cloud Service>数据源。 选择以选择要创建云配置的文件夹。

    有关为云服务配置创建和配置文件夹的信息,请参阅为云服务配置文件夹

  2. 选择​ 创建 ​以打开​ 创建数据Source配置向导。 指定配置的名称和标题,从​ 服务类型 ​下拉列表中选择​ SOAP Web服务,浏览并选择配置的缩略图图像,然后选择​ 下一步

  3. 为SOAP Web服务指定以下内容:

    • Web服务的WSDL URL。

    • 服务端点。 在此字段中指定一个值以覆盖WSDL中提到的服务端点。

    • 选择身份验证类型 — None、OAuth2.0(授权代码客户端凭据)、基本身份验证或自定义身份验证 — 以访问SOAP服务,并相应地提供身份验证的详细信息。

  4. 选择​ 创建 ​以创建SOAP Web服务的云配置。

在SOAP Web服务WSDL中启用导入语句 enable-import-statements

可以指定用作绝对URL的过滤器的正则表达式,这些绝对URL允许在SOAP Web服务WSDL中作为import语句。 默认情况下,此字段中没有值。 因此,Experience Manager将阻止WSDL中所有可用的导入语句。 如果在此字段中指定.*作为值,Experience Manager将允许所有import语句。

设置​ 表单数据模型SOAP Web服务导入允许列表 ​配置的importAllowlistPattern属性以指定正则表达式。 以下JSON文件显示了一个示例:

{
  "importAllowlistPattern": ".*"
}

要设置配置的值,请使用 AEM SDK 生成 OSGi 配置,并向 Cloud Service 实例部署配置

配置OData服务 config-odata

OData服务由其服务根URL标识。 要在Experience Manageras a Cloud Service中配置OData服务,请确保您拥有该服务的服务根URL,并执行以下操作:

NOTE
表单数据模型(FDM)支持OData版本4
有关配置Microsoft®® Dynamics 365的分步指南(在线或本地),请参阅Microsoft® Dynamics OData配置
  1. 转到​ 工具>Cloud Service>数据源。 选择以选择要创建云配置的文件夹。

    有关为云服务配置创建和配置文件夹的信息,请参阅为云服务配置文件夹

  2. 选择​ 创建 ​以打开​ 创建数据Source配置向导。 指定配置的名称和标题,从​ 服务类型 ​下拉列表中选择​ OData服务,浏览并选择配置的缩略图图像,然后选择​ 下一步

  3. 为OData服务指定以下详细信息:

    • 要配置的OData服务的服务根URL。
    • 选择身份验证类型 — 无、OAuth2.0(授权代码客户端凭据)、基本身份验证、API密钥或自定义身份验证 — 以访问OData服务,并相应地提供身份验证的详细信息。

    如果选择​ API密钥 ​作为身份验证类型,请指定API密钥的值。 API密钥可作为请求标头或查询参数发送。 从​ 位置 ​下拉列表中选择其中一个选项,并在​ 参数名称 ​字段中相应地指定标头名称或查询参数。

    note note
    NOTE
    选择OAuth 2.0身份验证类型以使用OData端点作为服务根与Microsoft®® Dynamics服务连接。
  4. 选择​ 创建 ​以创建OData服务的云配置。

后续步骤 next-steps

您已配置数据源。 接下来,您可以创建表单数据模型(FDM),或者,如果您已经在不使用数据源的情况下创建了表单数据模型(FDM),则可以将其与配置的数据源关联。 有关详细信息,请参阅创建表单数据模型

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