配置数据源

数据集成

Experience Manager Forms 数据集成允许您配置不同的数据源并将其连接到不同的数据源。 The following types are supported out-of-the-box. 但是,通过少量自定义,您也可以集成其他数据源。

  • RESTful Web服务
  • 基于SOAP的Web服务
  • OData服务

数据集成支持开箱即用的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 存储库。 By default, the conf folder contains the global folder where you can create cloud service configurations. 但是,您必须为云配置手动启用它。 您还可以在 conf 创建和组织云服务配置。

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

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

  2. Do the following to enable the global folder for cloud configurations or skip this step to create and configure another folder for cloud service configurations.

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

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

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

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

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

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

配置RESTful Web服务

RESTful Web服务可使用 Swagger规范 JSON或YAML格式 Swagger 定义文件。 To configure RESTful web service in Experience Manager as a Cloud Service, ensure that you have either the Swagger file on your file system or the URL where the file is hosted.

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

  1. Go to Tools > Cloud Services > Data Sources. 点按以选择要在其中创建云配置的文件夹。

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

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

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

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

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

      • 方案:REST API使用的传输协议。 The number of scheme types that display in the drop-down list depend on the schemes defined in the Swagger source.

      • Host: The domain name or IP address of the host that serves the REST API. 它是必填字段。

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

        If necessary, edit the pre-populated values for these fields.

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

    如果您选择 API密钥 对于身份验证类型,指定API密钥的值。 API密钥可以作为请求标头或查询参数发送。 Select one of these options from the Location drop-down list and specify the name of the header or the query parameter in the Parameter Name field accordingly.

  4. Tap Create to create the cloud configuration for the RESTful service.

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

Experience Manager Forms 由于数据源包含用于性能优化的HTTP客户端配置,因此在与RESTful Web服务集成时会生成数据模型。
Perform the following steps to configure the form data model HTTP client:

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

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

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

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

    • Specify the maximum number of permitted connections for each route in the Connection limit on per route basis field. 默认值为2个连接。

    • Specify the duration, for which a persistent HTTP connection is kept alive, in the Keep alive field. 默认值为15秒。

    • 指定持续时间,持续时间 Experience Manager Forms 服务器等待连接建立,在 连接超时 字段。 The default value is 10 seconds.

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

配置SOAP Web服务

使用 Web服务描述语言(WSDL)规范. Experience Manager Forms 不支持RPC样式WSDL模型。

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

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

    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.

  2. Tap Create to open the Create Data Source Configuration wizard. 为配置指定名称和(可选)标题,选择 SOAP Web服务服务类型 (可选)浏览并选择配置的缩略图,然后点按 下一个.

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

    • WSDL URL for the web service.

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

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

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

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

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

Set the importAllowlistPattern property of the Form Data Model SOAP Web Services Import Allowlist configuration to specify the regular expression. 以下JSON文件显示一个示例:

{
  "importAllowlistPattern": ".*"
}

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

配置OData服务

An OData service is identified by its service root URL. 在 Experience Manager as a Cloud Service的是,确保您具有服务的服务根URL,并执行以下操作:

注意

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

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

    See Configure folder for cloud service configurations for information about creating and configuring a folder for cloud service configurations.

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

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

    • Service Root URL for the OData service to be configured.
    • Select the authentication type — None, OAuth2.0, Basic Authentication, API Key, or Custom Authentication — to access the OData service, and accordingly provide the details for authentication.

    If you select API Key as the authentication type, specify the value for the API key. The API key can be sent as a request header or as a query parameter. 从 位置 下拉列表中,并在 参数名称 字段中,将会显示相应的内容。

    注意

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

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

下面的步骤

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

在此页面上