配置数据源

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

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

数据集成支持开箱即用的OAuth2.0、基本身份验证和API密钥身份验证类型，并允许实施自定义身份验证以访问Web服务。 虽然在AEM云服务中配置了RESTful、基于SOAP和OData服务，但在AEM Web控制台中配置了关系数据库的JDBC和AEM用户配置文件的连接器。

配置关系数据库

您可以使用AEM Web控制台配置来配置关系数据库。 执行以下操作：

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

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

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

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

    在配置数据源之前，请确保加密密码等敏感信息。 要加密：

    1. 转到https://'[服务器]:[端口]“/system/console/crypto。
1. 在 **纯文本** 字段中，指定要加密和点按的密码或任何字符串 **Protect**.

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

  4. 启用 借用测试 或 在返回时测试 指定在从和向池借用或返回对象之前，对这些对象进行验证。

  5. 在 验证查询 字段来验证池中的连接。 查询必须至少返回一行。 根据您的数据库，指定以下任一项：

    • 选择1（MySQL和MS SQL）
    • 从双(Oracle)中选择1

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

配置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/ 节点。 这意味着表单数据模型可以访问 city 类型属性 string 位于 profile/empLocation/ 节点。 但是，包含指定属性的节点必须遵循一致的结构。

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

为云服务配置配置文件夹

注意

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

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

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

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

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

    1. 在 配置浏览器，选择 global 文件夹，然后点按 属性.

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

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

  3. 在 配置浏览器，点按 创建.

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

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

配置RESTful Web服务

RESTful Web服务可使用 Swagger规范 JSON或YAML格式。 要在AEM云服务中配置RESTful Web服务，请确保您的文件系统上具有Swagger文件，或文件托管位置的URL。

请执行以下操作以配置RESTful服务：

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

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

  2. 点按 创建 打开 创建数据源配置向导. 为配置指定名称和（可选）标题，选择 RESTful服务 从 服务类型 （可选）浏览并选择配置的缩略图，然后点按 下一个.

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

    • 从“Swagger源”下拉列表中选择URL或“文件”，并相应地指定Swagger URL到Swagger定义文件，或从本地文件系统上传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个连接。

    • 在 保持活力 字段。 默认值为15秒。

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

    • 指定 套接字超时 字段。 默认值为30秒。

配置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令牌 对于Authentication类型，配置X509证书。 有关更多信息，请参阅 设置证书.
      在 键别名 字段。 在 生存时间 字段。 （可选）选择对消息正文或时间戳标头进行签名，或选择两者。

      如果您选择 双向身份验证 对于身份验证类型，请参阅 针对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. 配置 SOAP 或 RESTful web服务作为数据源，并选择 相互验证 作为身份验证类型。 如果为配置多个自签名证书 fd-cloudservice 用户，请指定证书的密钥别名。

下面的步骤

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

在此页面上