配置数据源

数据集成

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

  • RESTful Web服务
  • 基于SOAP的Web服务
  • OData服务(版本4.0)
  • Microsoft Dynamics
  • SalesForce
  • Microsoft Azure Blob Storage

数据集成支持开箱即用的OAuth2.0、基本身份验证和API密钥身份验证类型,并允许实施自定义身份验证以访问Web服务。 而RESTful、基于SOAP和OData服务在 Experience Manager as a Cloud Service 和连接器 Experience Manager 用户配置文件配置在 Experience Manager web控制台。

注意

Experience Manager Forms 不支持关系数据库。

为云服务配置配置文件夹

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

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

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

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

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

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

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

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

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

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

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

配置RESTful Web服务

RESTful Web服务可使用 Swagger规范 JSON或YAML格式 Swagger 定义文件。 要在 Experience Manager as a Cloud Service,确保您 Swagger 文件(Swagger版本2.0)或托管文件的URL上。

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

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

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

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

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

    • 从 Swagger源 下拉列表,并相应地指定 Swagger URL 到​ Swagger 定义文件或上传 Swagger 文件。

    • 基于​ Swagger 源输入中,以下字段预填充了值:

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

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

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

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

    • 选择身份验证类型(无、OAuth2.0、基本身份验证、API密钥或自定义身份验证)以访问RESTful服务,并相应地提供身份验证详细信息。

    如果您选择 API密钥 对于身份验证类型,指定API密钥的值。 API密钥可以作为请求标头或查询参数发送。 从 位置 下拉列表中,并在 参数名称 字段中,将会显示相应的内容。

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

形成数据模型HTTP客户端配置以优化性能

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

设置 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"
}

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

执行以下步骤以配置表单数据模型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)规范. Experience Manager Forms 不支持RPC样式WSDL模型。

要在 Experience Manager as a Cloud Service的是,确保您具有Web服务的WSDL URL,并执行以下操作:

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

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

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

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

    • Web服务的WSDL URL。

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

    • 选择身份验证类型(无、OAuth2.0、基本身份验证或自定义身份验证)以访问SOAP服务,并相应地提供身份验证的详细信息。

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

允许在SOAP Web服务WSDL中使用import语句

可以指定一个正则表达式作为绝对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标识。 在 Experience Manager as a Cloud Service的是,确保您具有服务的服务根URL,并执行以下操作:

注意

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

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

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

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

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

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

    如果您选择 API密钥 对于身份验证类型,指定API密钥的值。 API密钥可以作为请求标头或查询参数发送。 从 位置 下拉列表中,并在 参数名称 字段中,将会显示相应的内容。

    注意

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

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

下面的步骤

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

在此页面上