配置数据源

AEM Forms数据集成允许您配置和连接到不同的数据源。 现成支持以下类型。 但是,只需少量自定义,您也可以集成其他数据源。

  • 关系数据库 — MySQL、Microsoft SQL Server、IBM DB2和Oracle RDBMS。
  • AEM用户用户档案
  • REST风格的Web服务
  • 基于SOAP的Web服务
  • OData服务

数据集成支持OAuth2.0、基本身份验证和API密钥现成身份验证类型,并允许为访问Web服务实施自定义身份验证。 在AEM Cloud Services中配置RESTful、基于SOAP和OData服务时,在AEM Web控制台中配置关系数据库的JDBC和AEM用户用户档案的连接器。

配置关系数据库

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

  1. 转到AEM Web控制台(https://server:host/system/console/configMgr)。

  2. 查找​Apache Sling Connection Pooled DataSource​配置。 点按可在编辑模式下打开配置。

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

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

    请确保在配置数据源之前加密敏感信息,如口令。 要加密:

    1. 转到https://'[server]:[port]'/system/console/crypto。
    2. 在​纯文本​字段中,指定要加密的密码或任何字符串,然后点按​Protect

    加密的文本将显示在“受保护文本”字段中,您可以在配置中指定该字段。

  4. 启用​“借取时测试”​或“返回时测试”,以指定在从池借取对象或将对象返回池之前,验证对象。

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

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

配置AEM用户用户档案

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

  1. 转到AEM Web控制台,网址为:https://'[server]:[port]'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
    注意

    上例中的​**​***​表示CRXDE结构中AEM用户用户档案中profile/empLocation/节点下的所有节点。 这意味着表单数据模型可以访问profile/empLocation/节点下任何节点中存在的string类型的city属性。 但是,包含指定属性的节点必须采用一致的结构。

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

为云服务配置配置文件夹

注意

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

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

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

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

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

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

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

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

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

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

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

配置RESTful Web服务

RESTful Web服务可在Swagger定义文件中使用JSON格式的Swagger规范或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 当与RESTful web服务集成作为数据源时,表单数据模型包括用于性能优化的HTTP客户端配置。请执行以下步骤来配置表单数据模型HTTP客户端:

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

  2. 点按​表单数据模型Http客户端配置以获取REST数据源

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

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

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

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

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

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

配置SOAP Web服务

使用Web服务描述语言(WSDL)规范描述基于SOAP的Web服务。 要在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别名。 在​“Time To Live”字段中指定验证请求保持有效的时间(以秒为单位)。 (可选)选择对邮件正文或时间戳标题进行签名,或者同时对两者进行签名。

      如果选择​相互身份验证​作为身份验证类型,请参阅针对RESTful和SOAP Web服务的基于证书的相互身份验证。

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

配置OData服务

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

注意

有关配置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服务器在共享任何数据之前都会相互验证其身份。 可以对基于REST和SOAP的连接(数据源)使用相互身份验证。 要在AEM Forms环境上为表单数据模型配置相互身份验证,请执行以下操作:

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

后续步骤

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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now