配置数据源

数据集成

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

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

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

配置关系数据库

前提条件

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

配置关系数据库的步骤

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

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

  2. 查找 Day Commons JDBC连接池 配置。 点按以在编辑模式下打开配置。

    JDBC连接器池

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

    • JDBC驱动程序的Java™类名
    • JDBC连接URI
    • 用于与JDBC驱动程序建立连接的用户名和密码
    • 在中指定SQL SELECT查询 验证查询 用于验证池中的连接的字段。 查询必须至少返回一行。 根据您的数据库,指定以下选项之一:
      • SELECT 1 (MySQL和MS SQL)
      • 从双选件中选择1(Oracle)
    • 数据源的名称

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

       "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"
    
    注意

    参考 使用JDBC数据源池的SQL连接 以了解更多详细信息。

  4. 点按 保存 以保存配置。

现在,您可以将配置的关系数据库与表单数据模型结合使用。

为云服务配置配置文件夹

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

中的所有云服务配置 Experience Manager 于综合全面收益表内综合入账。 /conf 文件夹位置 Experience Manager 存储库。 默认情况下, conf 文件夹包含 global 可在其中创建Cloud Service配置的文件夹。 但是,您必须为云配置手动启用它。 您还可以在以下位置创建其他文件夹 conf 创建和组织云服务配置。

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

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

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

    1. 配置浏览器,选择 global 文件夹并点按 属性.

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

    3. 点按 保存并关闭 保存配置并退出对话框。

  3. 配置浏览器,点按 创建.

  4. 创建配置 对话框,指定文件夹的标题,然后启用 云配置.

  5. 点按 创建 以创建为云服务配置启用的文件夹。

配置RESTful Web服务

可以使用对RESTful Web服务进行描述 Swagger规范 JSON或YAML格式的内容 Swagger 定义文件。 在中配置RESTful Web服务 Experience Manager as a Cloud Service,请确保您拥有 Swagger 文件(Swagger版本2.0)或 Swagger 文件(Swagger版本3.0),或托管文件的URL上标记的文件路径。

为Open API规范版本2.0配置RESTful服务

  1. 转到 “工具”>“Cloud Services”>“数据源”. 点按以选择要创建云配置的文件夹。

    参见 为云服务配置配置文件夹 有关为Cloud Service配置创建和配置文件夹的信息。

  2. 点按 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 RESTful服务服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后点按 下一个.

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

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

    • 基于​ Swagger 源输入。则以下字段已预填充了值:

      • 方案: REST API使用的传输协议。 下拉列表中显示的方案类型数取决于 Swagger 源。

      • 主机:提供REST API的主机的域名或IP地址。 它是必填字段。

      • 基本路径:所有API路径的URL前缀。 它是一个可选字段。\

        如有必要,请编辑这些字段的预填充值。

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

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

  4. 点按 创建 为RESTful服务创建云配置。

为Open API规范版本3.0配置RESTful服务

  1. 转到 “工具”>“Cloud Services”>“数据源”. 点按以选择要创建云配置的文件夹。

    参见 为云服务配置配置文件夹 有关为Cloud Service配置创建和配置文件夹的信息。

  2. 点按 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 RESTful服务服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后点按 下一个.

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

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

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

  4. 点按 创建 为RESTful服务创建云配置。

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

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

您可以引用 OpenAPI 3.0规范 以了解详细信息。

表单数据模型HTTP客户端配置以优化性能

Experience Manager Forms 表单数据模型,因为数据源包括用于性能优化的HTTP客户端配置。

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

  • 使用 http.connection.max.per.route 属性,用于设置表单数据模型和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客户端配置 对话框:

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

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

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

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

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

配置SOAP Web服务

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

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

  1. 转到 “工具”>“Cloud Services”>“数据源”. 点按以选择要创建云配置的文件夹。

    参见 为云服务配置配置文件夹 有关为Cloud Service配置创建和配置文件夹的信息。

  2. 点按 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 SOAP Web服务服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后点按 下一个.

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

    • Web服务的WSDL URL。

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

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

  4. 点按 创建 创建SOAP Web服务的云配置。

在SOAP Web服务WSDL中启用导入语句的使用

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

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

{
  "importAllowlistPattern": ".*"
}

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

配置OData服务

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

注意

表单数据模型支持 OData版本4.
有关配置的分步指南 Microsoft® Dynamics 365,在线或内部部署,请参阅 Microsoft® Dynamics OData配置.

  1. 转到 “工具”>“Cloud Services”>“数据源”. 点按以选择要创建云配置的文件夹。

    参见 为云服务配置配置文件夹 有关为Cloud Service配置创建和配置文件夹的信息。

  2. 点按 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 OData服务服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后点按 下一个.

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

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

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

    注意

    您必须选择要连接的OAuth 2.0身份验证类型 Microsoft® Dynamics 使用OData端点作为服务根的服务。

  4. 点按 创建 为OData服务创建云配置。

后续步骤

您已配置数据源。 接下来,您可以创建表单数据模型,或者,如果您已创建没有数据源的表单数据模型,则可以将其与配置的数据源关联。 参见 创建表单数据模型 了解详细信息。

在此页面上