配置数据源 configure-data-sources
Experience Manager Forms 通过数据集成,您可以配置并连接到不同的数据源。 支持开箱即用的以下类型:
- 关系数据库 — MySQL、 Microsoft® SQL Server, IBM® DB2®、 postgreSQL和 Oracle RDBMS
- RESTful Web服务
- 基于SOAP的Web服务
- OData服务(版本4.0)
- Microsoft® Dynamics
- SalesForce
- Microsoft® Azure Blob存储
数据集成支持OAuth2.0(授权码, 客户端凭据)、基本身份验证和API密钥身份验证是现成的类型,允许实施自定义身份验证以访问Web服务。 在中配置RESTful、基于SOAP和OData服务的同时 Experience Manager as a Cloud Service,关系数据库的JDBC和连接器 Experience Manager 用户配置文件配置于 Experience Manager Web控制台。
配置关系数据库 configure-relational-database
前提条件
在使用配置关系数据库之前 Experience Manager Web控制台配置,必须:
- 通过Cloud Manager API启用高级联网,因为默认情况下端口处于禁用状态。
- 在Maven中添加JDBC驱动程序依赖项.
配置关系数据库的步骤
可以使用配置关系数据库 Experience Manager Web控制台配置。 执行以下操作:
-
转到 Experience Manager Web控制台位于
https://server:host/system/console/configMgr
. -
定位 Day Commons JDBC连接池 配置。 选择以在编辑模式下打开配置。
-
在配置对话框中,指定要配置的数据库的详细信息,例如:
-
JDBC驱动程序的Java™类名称
-
JDBC连接URI
-
用于与JDBC驱动程序建立连接的用户名和密码
-
在中指定SQL SELECT查询 验证查询 用于验证池中的连接的字段。 查询必须至少返回一行。 根据您的数据库,指定以下选项之一:
- SELECT 1 (MySQL和MS® SQL)
- 从双选件中选择1(Oracle)
-
数据源的名称
用于配置关系数据库的示例字符串:
code language-text "datasource.name": "sqldatasourcename-mysql", "jdbc.driver.class": "com.mysql.jdbc.Driver", "jdbc.connection.uri": "jdbc:mysql://$[env:AEM_PROXY_HOST;default=proxy.tunnel]:30001/sqldatasourcename"
note note NOTE 请参阅 使用JDBC数据源池的SQL连接 以了解更多详细信息。 -
-
选择 保存 以保存配置。
现在,您可以将配置的关系数据库与表单数据模型结合使用。
为云服务配置配置文件夹 cloud-folder
配置RESTful、SOAP和OData服务的云服务需要配置云服务文件夹。
中的所有云服务配置 Experience Manager 于综合全面收益表内 /conf
文件夹位置 Experience Manager 存储库。 默认情况下, conf
文件夹包含 global
文件夹,您可以在该文件夹中创建云服务配置。 但是,必须为云配置手动启用它。 您还可以创建其他文件夹,位于 conf
创建和组织云服务配置。
要为云服务配置配置文件夹,请执行以下操作:
-
转到 “工具”>“常规”>“配置浏览器”.
- 请参阅 配置浏览器 文档,以了解更多信息。
-
执行以下操作可为云配置启用全局文件夹,或跳过此步骤为云服务配置创建和配置其他文件夹。
-
在 配置浏览器,选择
global
文件夹并选择 属性. -
在 配置属性 对话框,启用 云配置.
-
选择 保存并关闭 保存配置并退出对话框。
-
-
在 配置浏览器,选择 创建.
-
在 创建配置 对话框,为文件夹指定标题,然后启用 云配置.
-
选择 创建 以创建为云服务配置启用的文件夹。
配置RESTful Web服务 configure-restful-web-services
可以使用对RESTful Web服务进行描述 Swagger规范 格式为JSON或YAML,格式为 Swagger 定义文件。 在中配置RESTful Web服务 Experience Manager as a Cloud Service,确保您拥有 Swagger 文件(Swagger版本2.0)或 Swagger 文件(Swagger版本3.0),或者托管文件的URL上。
为Open API规范版本2.0配置RESTful服务 configure-restful-services-open-api-2.0
-
转到 “工具”>“Cloud Service”>“数据源”. 选择以选择要创建云配置的文件夹。
请参阅 为云服务配置配置文件夹 有关为云服务配置创建和配置文件夹的信息。
-
选择 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 RESTful服务 从 服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后选择 下一个.
-
为RESTful服务指定以下详细信息:
-
从中选择URL或文件 Swagger源 下拉列表,并相应地指定 Swagger URL 到 Swagger 定义文件或上传 Swagger 从本地文件系统删除文件。
-
基于 Swagger 源输入。,以下字段已预填充了值:
- 方案:REST API使用的传输协议。 下拉列表中显示的方案类型数取决于中定义的方案 Swagger 源。
- 主机:提供REST API的主机的域名或IP地址。 它是必填字段。
- 基本路径:所有API路径的URL前缀。 它是一个可选字段。
如有必要,请编辑这些字段的预填充值。
-
选择身份验证类型 — 无、OAuth2.0(授权码, 客户端凭据)、基本身份验证、API密钥或自定义身份验证 — 用于访问RESTful服务,并相应地提供身份验证的详细信息。
如果您选择 API密钥 作为身份验证类型,指定API密钥的值。 API密钥可作为请求标头或查询参数发送。 从中选择以下选项之一 位置 下拉列表,并在中指定标头的名称或查询参数 参数名称 字段输入相应的。
-
-
选择 创建 以创建RESTful服务的云配置。
为Open API规范版本3.0配置RESTful服务 configure-restful-services-open-api-3.0
-
转到 “工具”>“Cloud Service”>“数据源”. 选择以选择要创建云配置的文件夹。
请参阅 为云服务配置配置文件夹 有关为云服务配置创建和配置文件夹的信息。
-
选择 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 RESTful服务 从 服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后选择 下一个.
-
为RESTful服务指定以下详细信息:
- 从中选择URL或文件 Swagger源 下拉列表,并相应地指定 Swagger 3.0 URL 到 Swagger 定义文件或上传 Swagger 从本地文件系统删除文件。
- 基于 Swagger 源输入,显示与目标服务器的连接信息。
- 选择身份验证类型 — 无、OAuth2.0(授权码, 客户端凭据)、基本身份验证、API密钥或自定义身份验证 — 用于访问RESTful服务,并相应地提供身份验证的详细信息。
如果您选择 API密钥 作为身份验证类型,指定API密钥的值。 API密钥可作为请求标头或查询参数发送。 从中选择以下选项之一 位置 下拉列表,并在中指定标头的名称或查询参数 参数名称 字段输入相应的。
-
选择 创建 以创建RESTful服务的云配置。
RESTful服务Open API规范版本3.0不支持的一些操作包括:
- 回调
- oneof/anyof
- 远程引用
- 链接
- 针对单次操作的不同MIME类型的不同请求主体
请参阅 OpenAPI 3.0规范 以了解详细信息。
表单数据模型HTTP客户端配置可优化性能 fdm-http-client-configuration
Experience Manager Forms 在与RESTful Web服务集成时形成数据模型,因为数据源包括用于性能优化的HTTP客户端配置。
设置以下属性 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"
}
-
选择 REST数据源的表单数据模型HTTP客户端配置.
-
在 REST数据源的表单数据模型HTTP客户端配置 对话框:
-
在中指定表单数据模型和RESTful Web服务之间允许的最大连接数 连接限制总数 字段。 默认值为20个连接。
-
指定中每个路由允许的最大连接数 每个路由的连接限制 字段。 缺省值为两个连接。
-
指定持续HTTP连接保持活动状态的持续时间,在 保持活动状态 字段。 默认值为15秒。
-
指定持续时间,持续时间为 Experience Manager Forms 服务器等待连接建立,在 连接超时 字段。 默认值为10秒。
-
指定中两个数据包之间不活动的最长时间 套接字超时 字段。 默认值为30秒。
-
配置SOAP Web服务 configure-soap-web-services
使用对基于SOAP的Web服务进行描述 Web服务描述语言(WSDL)规范. Experience Manager Forms 不支持RPC样式的WSDL模型。
在中配置基于SOAP的Web服务 Experience Manager as a Cloud Service,确保您具有Web服务的WSDL URL,并执行以下操作:
-
转到 “工具”>“Cloud Service”>“数据源”. 选择以选择要创建云配置的文件夹。
请参阅 为云服务配置配置文件夹 有关为云服务配置创建和配置文件夹的信息。
-
选择 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 SOAP Web服务 从 服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后选择 下一个.
-
为SOAP Web服务指定以下内容:
-
选择 创建 创建SOAP Web服务的云配置。
在SOAP Web服务WSDL中启用导入语句的使用 enable-import-statements
可以指定用作绝对URL的过滤器的正则表达式,这些绝对URL允许作为SOAP Web服务WSDL中的导入语句。 默认情况下,此字段中没有值。 因此, Experience Manager 阻止WSDL中所有可用的import语句。 如果您指定 .*
作为该字段中的值, Experience Manager 允许所有import语句。
设置 importAllowlistPattern
的属性 列入允许列表表单数据模型SOAP Web服务导入 用于指定正则表达式的配置。 以下JSON文件显示了一个示例:
{
"importAllowlistPattern": ".*"
}
要设置配置的值,请使用 AEM SDK 生成 OSGi 配置,并向 Cloud Service 实例部署配置。
配置OData服务 config-odata
OData服务由其服务根URL标识。 在中配置OData服务 Experience Manager as a Cloud Service,请确保您拥有服务的服务根URL,然后执行以下操作:
-
转到 “工具”>“Cloud Service”>“数据源”. 选择以选择要创建云配置的文件夹。
请参阅 为云服务配置配置文件夹 有关为云服务配置创建和配置文件夹的信息。
-
选择 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 OData服务 从 服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后选择 下一个.
-
为OData服务指定以下详细信息:
- 要配置的OData服务的服务根URL。
- 选择身份验证类型 — 无、OAuth2.0(授权码, 客户端凭据)、基本身份验证、API密钥或自定义身份验证 — 用于访问OData服务,并相应地提供身份验证的详细信息。
如果您选择 API密钥 作为身份验证类型,指定API密钥的值。 API密钥可作为请求标头或查询参数发送。 从中选择以下选项之一 位置 下拉列表,并在中指定标头的名称或查询参数 参数名称 字段输入相应的。
note note NOTE 选择要连接的OAuth 2.0身份验证类型 Microsoft®® Dynamics 使用OData端点作为服务根的服务。 -
选择 创建 以创建OData服务的云配置。
后续步骤 next-steps
您已配置数据源。 接下来,您可以创建一个表单数据模型,或者,如果您已创建没有数据源的表单数据模型,则可以将其与您配置的数据源关联。 请参阅 创建表单数据模型 以了解详细信息。