配置数据源 configure-data-sources
通过AEM Forms数据集成,您可以配置并连接到不同的数据源。 支持开箱即用的以下类型。 但是,只需少量自定义,您也可以集成其他数据源。
- 关系数据库 — MySQL、Microsoft SQL Server、IBM DB2、OracleRDBMS、postgreSQL和Sybase
- AEM用户配置文件
- RESTful Web服务
- 基于SOAP的Web服务
- OData服务
数据集成支持现成的OAuth2.0(授权代码、客户端凭据)、基本身份验证和API密钥身份验证类型,并允许实施自定义身份验证以访问Web服务。 虽然在AEMCloud Service中配置了RESTful、基于SOAP和OData服务,但在AEM Web控制台中配置了关系数据库的JDBC和AEM用户配置文件的连接器。
配置关系数据库 configure-relational-database
可以使用AEM Web Console配置来配置关系数据库。 执行以下操作:
-
转到位于
https://server:host/system/console/configMgr
的AEM Web控制台。 -
查找 Apache Sling Connection Pooled DataSource 配置。 选择以在编辑模式下打开配置。
-
在配置对话框中,指定要配置的数据库的详细信息,例如:
- 数据源的名称
- 存储数据源名称的数据源服务属性
- JDBC驱动程序的Java类名
- JDBC连接URI
- 用于与JDBC驱动程序建立连接的用户名和密码
note note NOTE 在配置数据源之前,请确保对密码等敏感信息进行加密。 要加密: - 转到https://'[服务器]:[端口]'/system/console/crypto。
- 在 纯文本 字段中,指定要加密的密码或任何字符串,然后选择 Protect。
加密文本将显示在可在配置中指定的受保护文本字段中。 -
启用 借入时测试 或 返回时测试,以指定在分别从池借入或返回池之前,验证对象。
-
在 验证查询 字段中指定SQL SELECT查询以验证来自池的连接。 查询必须至少返回一行。 根据您的数据库,指定以下选项之一:
- SELECT 1 (MySQL和MS SQL)
- 从双选件中选择1(Oracle)
-
选择 保存 以保存配置。
note note NOTE 如果Forms数据模型包含的对象是关系数据库的保留关键字,则可能会导致数据添加、更新或检索问题。 因此,请避免在表单数据模型中使用此类对象。
配置AEM用户配置文件 configure-aem-user-profile
您可以使用AEM Web Console中的用户配置文件连接器配置来配置AEM用户配置文件。 执行以下操作:
-
转到https://'[server]:[port]'system/console/configMgr上的AEM Web控制台。
-
查找 AEM Forms数据集成 — 用户配置文件连接器配置,然后选择以在编辑模式下打开该配置。
-
在“用户配置文件连接器配置”对话框中,可以添加、删除或更新用户配置文件属性。 指定的属性可用于表单数据模型。 使用以下格式指定用户配置文件属性:
name=[property_name_with_location_in_user_profile],type=[property_type]
示例:
name=profile/phoneNumber,type=string
name=profile/empLocation/*/city,type=string
note note NOTE 上例中的*****表示CRXDE结构中AEM用户配置文件中 profile/empLocation/
节点下的所有节点。 这意味着表单数据模型可以访问profile/empLocation/
节点下的任何节点中存在的类型为string
的city
属性。 但是,包含指定属性的节点必须遵循一致结构。 -
选择 保存 以保存配置。
为云服务配置配置文件夹 cloud-folder
AEM中的所有云服务配置都已合并到AEM存储库的/conf
文件夹中。 默认情况下,conf
文件夹包含global
文件夹,您可以在其中创建云服务配置。 但是,您需要为云配置手动启用它。 您还可以在conf
中创建其他文件夹以创建和组织Cloud Service配置。
要为云服务配置配置文件夹,请执行以下操作:
-
转到 工具>常规>配置浏览器。
- 有关详细信息,请参阅配置浏览器文档。
-
执行以下操作可为云配置启用全局文件夹,或跳过此步骤为云服务配置创建和配置其他文件夹。
-
在 配置浏览器 中,选择
global
文件夹并选择 属性。 -
在 配置属性 对话框中,启用 云配置。
-
选择 保存并关闭 以保存配置并退出对话框。
-
-
在 配置浏览器 中,选择 创建。
-
在 创建配置 对话框中,指定文件夹的标题并启用 云配置。
-
选择 创建 以创建为云服务配置启用的文件夹。
配置RESTful Web服务 configure-restful-web-services
在Swagger定义文件中,可以使用JSON或YAML格式的Swagger规范来描述RESTful Web服务。 要在AEM云服务中配置RESTful Web服务,请确保您的文件系统上有Swagger文件或托管该文件的URL。
执行以下操作以配置RESTful服务:
-
转到 工具>Cloud Service>数据源。 选择以选择要创建云配置的文件夹。
有关为云服务配置创建和配置文件夹的信息,请参阅为云服务配置文件夹。
-
选择 创建 以打开 创建数据Source配置向导。 指定配置的名称和标题,从 服务类型 下拉列表中选择 RESTful服务,浏览并选择配置的缩略图图像,然后选择 下一步。
-
为RESTful服务指定以下详细信息:
-
从Swagger Source下拉列表中选择URL或文件,并相应地指定Swagger定义文件的Swagger URL或从本地文件系统上传Swagger文件。
-
根据Swagger Source输入,以下字段已预填充值:
- 方案:REST API使用的传输协议。 下拉列表中显示的方案类型数取决于Swagger源中定义的方案。
- 主机:提供REST API的主机的域名或IP地址。 它是必填字段。
- 基本路径:所有API路径的URL前缀。 它是一个可选字段。
如有必要,请编辑这些字段的预填充值。
-
选择身份验证类型 — None、OAuth2.0(授权代码、客户端凭据)、基本身份验证、API密钥、自定义身份验证或相互身份验证 — 以访问RESTful服务,并相应地提供身份验证的详细信息。
如果选择 API密钥 作为身份验证类型,请指定API密钥的值。 API密钥可作为请求标头或查询参数发送。 从 位置 下拉列表中选择其中一个选项,并在 参数名称 字段中相应地指定标头名称或查询参数。
如果选择 相互身份验证 作为身份验证类型,请参阅RESTful和SOAP Web服务的基于证书的相互身份验证。
-
-
选择 创建 以创建RESTful服务的云配置。
表单数据模型HTTP客户端配置可优化性能 fdm-http-client-configuration
由于数据源包括用于性能优化的HTTP客户端配置,因此,在与RESTful Web服务集成时,Experience Manager Forms会形成数据模型。
执行以下步骤以配置表单数据模型HTTP客户端:
-
以管理员身份登录到Experience Manager Forms创作实例并转到Experience Manager Web控制台包。 默认URL为https://localhost:4502/system/console/configMgr。
-
为REST数据源 选择 表单数据模型Http客户端配置。
-
在REST数据源的表单数据模型HTTP客户端配置对话框中:
-
在 连接限制的 字段中指定表单数据模型和RESTful Web服务之间允许的连接的最大数目。 默认值为20个连接。
-
在 每个路由的连接限制 字段中为每个路由指定允许的最大连接数。 默认值为2个连接。
-
在 保持活动 字段中指定持续HTTP连接保持活动状态的持续时间。 默认值为15秒。
-
在 连接超时 字段中指定Experience Manager Forms服务器等待连接建立的持续时间。 默认值为10秒。
-
在 套接字超时 字段中指定两个数据包之间的最长不活动时间段。 默认值为30秒。
-
配置SOAP Web服务 configure-soap-web-services
基于SOAP的Web服务使用Web服务描述语言(WSDL)规范进行描述。 要在AEM云服务中配置基于SOAP的Web服务,请确保您具有Web服务的WSDL URL,并执行以下操作:
-
转到 工具>Cloud Service>数据源。 选择以选择要创建云配置的文件夹。
有关为云服务配置创建和配置文件夹的信息,请参阅为云服务配置文件夹。
-
选择 创建 以打开 创建数据Source配置向导。 指定配置的名称和标题,从 服务类型 下拉列表中选择 SOAP Web服务,浏览并选择配置的缩略图图像,然后选择 下一步。
-
为SOAP Web服务指定以下内容:
-
Web服务的WSDL URL。
-
服务端点。 在此字段中指定一个值以覆盖WSDL中提到的服务端点。
-
选择身份验证类型 — None、OAuth2.0(授权代码、客户端凭据)、Basic Authentication、Custom Authentication、X509令牌或Mutual Authentication — 以访问SOAP服务,并相应地提供身份验证的详细信息。
如果选择 X509 Token 作为身份验证类型,请配置X509证书。 有关详细信息,请参阅设置证书。
在 密钥别名 字段中指定X509证书的KeyStore别名。 在 生存时间 字段中指定身份验证请求保持有效的时间(秒)。 (可选)选择对消息正文或时间戳标头签名或同时选择两者。如果选择 相互身份验证 作为身份验证类型,请参阅RESTful和SOAP Web服务的基于证书的相互身份验证。
-
-
选择 创建 以创建SOAP Web服务的云配置。
配置OData服务 config-odata
OData服务由其服务根URL标识。 要在AEM云服务中配置OData服务,请确保您拥有该服务的服务根URL,并执行以下操作:
-
转到 工具>Cloud Service>数据源。 选择以选择要创建云配置的文件夹。
有关为云服务配置创建和配置文件夹的信息,请参阅为云服务配置文件夹。
-
选择 创建 以打开 创建数据Source配置向导。 指定配置的名称和标题,从 服务类型 下拉列表中选择 OData服务,浏览并选择配置的缩略图图像,然后选择 下一步。
-
为OData服务指定以下详细信息:
note note NOTE 选择OAuth 2.0身份验证类型以使用OData端点作为服务根连接到Microsoft Dynamics服务。 -
选择 创建 以创建OData服务的云配置。
RESTful和SOAP Web服务的基于证书的双向身份验证 mutual-authentication
为表单数据模型启用相互身份验证后,数据源和运行表单数据模型的AEM Server在共享任何数据之前都会验证彼此的身份。 您可以对基于REST和SOAP的连接(数据源)使用相互身份验证。 要在AEM Forms环境中为表单数据模型配置双向身份验证,请执行以下操作:
-
将私钥(证书)上载到AEM Forms服务器。 要上传私钥,请执行以下操作:
- 以管理员身份登录AEM Forms服务器。
- 导航到 工具 > 安全性 > 用户。 选择
fd-cloudservice
用户并选择 属性。 - 打开 密钥库 选项卡,展开 从KeyStore文件添加私钥 选项,上传KeyStore文件,指定别名、密码,然后选择 提交。 证书已上传。 私钥别名在证书中提及,并在创建证书时设置。
-
将信任证书上载到全局信任存储区。 要上传证书,请执行以下操作:
- 导航到 工具 > 安全性 > 信任存储区。
- 展开 从CER文件添加证书 选项,选择 选择证书文件,上载证书,然后选择 提交。
-
将SOAP或RESTful Web服务配置为数据源,并选择 相互身份验证 作为身份验证类型。 如果为
fd-cloudservice
用户配置多个自签名证书,请指定证书的密钥别名。
后续步骤 next-steps
您已配置数据源。 接下来,您可以创建一个表单数据模型,或者,如果您已在不使用数据源的情况下创建了表单数据模型,则可以将其与您配置的数据源相关联。 有关详细信息,请参阅创建表单数据模型。