配置数据源

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

数据集成

通过AEM Forms数据集成,您可以配置并连接到不同的数据源。 支持开箱即用的以下类型。 但是,只需少量自定义,您也可以集成其他数据源。

  • 关系数据库 — MySQL、Microsoft SQL Server、IBM DB2、OracleRDBMS和Sybase
  • AEM用户配置文件
  • RESTful Web服务
  • 基于SOAP的Web服务
  • OData服务

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

配置关系数据库

可以使用AEM Web Console配置来配置关系数据库。 执行以下操作:

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

  2. 查找 Apache Sling连接池化数据源 配置。 点按以在编辑模式下打开配置。

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

    • 数据源的名称
    • 存储数据源名称的数据源服务属性
    • JDBC驱动程序的Java类名
    • JDBC连接URI
    • 用于与JDBC驱动程序建立连接的用户名和密码
    注意

    在配置数据源之前,请确保对密码等敏感信息进行加密。 要加密:

    1. 转到https://'[服务器]:[端口]'/system/console/crypto.
    2. 纯文本 字段,指定要加密的密码或任何字符串,然后点击 Protect.

    加密文本将显示在可在配置中指定的受保护文本字段中。

  4. 启用 借阅测试回访时测试 指定在将对象从池中借入或返回池之前,对其进行验证。

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

    • SELECT 1 (MySQL和MS SQL)
    • 从双选件中选择1(Oracle)
  6. 点按 保存 以保存配置。

    注意

    如果Forms数据模型包含的对象是关系数据库的保留关键字,则可能会导致数据添加、更新或检索问题。 因此,请避免在表单数据模型中使用此类对象。

配置AEM用户配置文件

您可以使用AEM Web Console中的用户配置文件连接器配置来配置AEM用户配置文件。 执行以下操作:

  1. 转到AEM Web控制台,网址为https://'[服务器]:[端口]'system/console/configMgr.

  2. 查找 AEM Forms数据集成 — 用户配置文件连接器配置 并点按以在编辑模式下打开配置。

  3. 在“用户配置文件连接器配置”对话框中,可以添加、删除或更新用户配置文件属性。 指定的属性可用于表单数据模型。 使用以下格式指定用户配置文件属性:

    name=[property_name_with_location_in_user_profile],type=[property_type]

    示例:

    • name=profile/phoneNumber,type=string
    • name=profile/empLocation/*/city,type=string
    注意

    * 上例中,表示 profile/empLocation/ CRXDE结构的AEM用户配置文件中的节点。 这意味着表单数据模型可以访问 city 类型的属性 string 出现在下的任何节点中 profile/empLocation/ 节点。 但是,包含指定属性的节点必须遵循一致结构。

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

为云服务配置配置文件夹

注意

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

AEM中的所有云服务配置都整合到中 /conf AEM存储库中的文件夹。 默认情况下, conf 文件夹包含 global 文件夹,您可以在该文件夹中创建云服务配置。 但是,您需要为云配置手动启用它。 您还可以创建其他文件夹,位于 conf 创建和组织云服务配置。

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

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

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

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

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

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

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

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

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

配置RESTful Web服务

可以使用对RESTful Web服务进行描述 Swagger规范 JSON或YAML格式的XML文档。 要在AEM云服务中配置RESTful Web服务,请确保您的文件系统上有Swagger文件或托管该文件的URL。

执行以下操作以配置RESTful服务:

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

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

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

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

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

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

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

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

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

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

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

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

    如果您选择 相互认证 对于身份验证类型,请参阅 RESTful和SOAP Web服务的基于证书的双向身份验证.

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

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

Experience Manager Forms 由于数据源包括用于性能优化的HTTP客户端配置,因此,在与RESTful Web服务集成时会生成数据模型。
执行以下步骤以配置表单数据模型HTTP客户端:

  1. 登录 Experience Manager Forms 以管理员身份创作实例并转到 Experience Manager Web控制台包。 默认URL为 https://localhost:4502/system/console/configMgr.

  2. 点按 REST数据源的表单数据模型Http客户端配置.

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

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

    • 指定中每个路由允许的最大连接数 每个路由的连接限制 字段。 默认值为2个连接。

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

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

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

配置SOAP Web服务

使用对基于SOAP的Web服务进行描述 Web服务描述语言(WSDL)规范. 要在AEM云服务中配置基于SOAP的Web服务,请确保您拥有该Web服务的WSDL URL,并执行以下操作:

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

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

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

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

    • Web服务的WSDL URL。

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

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

      如果您选择 X509令牌 对于身份验证类型,请配置X509证书。 有关更多信息,请参阅 设置证书.
      在中指定X509证书的KeyStore别名 密钥别名 字段。 指定身份验证请求保持有效的时间(秒),在 存留时间 字段。 (可选)选择对消息正文或时间戳标头签名或同时选择两者。

      如果您选择 相互认证 对于身份验证类型,请参阅 RESTful和SOAP Web服务的基于证书的双向身份验证.

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

配置OData服务

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

注意

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

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

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

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

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

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

    必须选择OAuth 2.0身份验证类型才能使用OData端点作为服务根连接到Microsoft Dynamics服务。

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

RESTful和SOAP Web服务的基于证书的双向身份验证

为表单数据模型启用相互身份验证后,数据源和运行表单数据模型的AEM Server在共享任何数据之前都会验证彼此的身份。 可以对基于REST和SOAP的连接(数据源)使用相互身份验证。 要在AEM Forms环境中为表单数据模型配置双向身份验证,请执行以下操作:

  1. 将私钥(证书)上传到 AEM Forms 服务器。 要上传私钥,请执行以下操作:
    1. 登录 AEM Forms 服务器作为管理员。
    2. 导航到 工具 > 安全性 > 用户. 选择 fd-cloudservice 用户和点按 属性.
    3. 打开 密钥库 选项卡,展开 从KeyStore文件添加私钥 选项,上传KeyStore文件,指定别名、密码,然后点击 提交. 证书已上传。 私钥别名在证书中提及,并在创建证书时设置。
  2. 将信任证书上载到全局信任存储区。 要上传证书,请执行以下操作:
    1. 导航到 工具 > 安全性 > 信任存储区.
    2. 展开 从CER文件添加证书 选项,点按 选择证书文件,上传证书,然后点击 提交.
  3. 配置 SOAPRESTful 将Web服务作为数据源,然后选择 相互认证 作为身份验证类型。 如果为配置多个自签名证书 fd-cloudservice 用户,指定证书的密钥别名。

后续步骤

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

在此页面上