版本 | 文章链接 |
---|---|
AEM as a Cloud Service | 单击此处 |
AEM 6.5 | 本文 |
通过AEM Forms数据集成,您可以配置并连接到不同的数据源。 支持开箱即用的以下类型。 但是,只需少量自定义,您也可以集成其他数据源。
数据集成支持OAuth2.0(授权码, 客户端凭据)、基本身份验证和API密钥身份验证是现成的类型,允许实施自定义身份验证以访问Web服务。 虽然在AEMCloud Service中配置了RESTful、基于SOAP和OData服务,但在AEM Web控制台中配置了关系数据库的JDBC和AEM用户配置文件的连接器。
可以使用AEM Web Console配置来配置关系数据库。 执行以下操作:
转到位于的AEM Web控制台 https://server:host/system/console/configMgr
.
查找 Apache Sling连接池化数据源 配置。 点按以在编辑模式下打开配置。
在配置对话框中,指定要配置的数据库的详细信息,例如:
在配置数据源之前,请确保对密码等敏感信息进行加密。 要加密:
加密文本将显示在可在配置中指定的受保护文本字段中。
启用 借阅测试 或 回访时测试 指定在将对象从池中借入或返回池之前,对其进行验证。
在中指定SQL SELECT查询 验证查询 用于验证池中的连接的字段。 查询必须至少返回一行。 根据您的数据库,指定以下选项之一:
点按 保存 以保存配置。
如果Forms数据模型包含的对象是关系数据库的保留关键字,则可能会导致数据添加、更新或检索问题。 因此,请避免在表单数据模型中使用此类对象。
您可以使用AEM Web Console中的用户配置文件连接器配置来配置AEM用户配置文件。 执行以下操作:
转到AEM Web控制台,网址为https://'[服务器]:[端口]'system/console/configMgr.
查找 AEM Forms数据集成 — 用户配置文件连接器配置 并点按以在编辑模式下打开配置。
在“用户配置文件连接器配置”对话框中,可以添加、删除或更新用户配置文件属性。 指定的属性可用于表单数据模型。 使用以下格式指定用户配置文件属性:
name=[property_name_with_location_in_user_profile],type=[property_type]
示例:
name=profile/phoneNumber,type=string
name=profile/empLocation/*/city,type=string
此 * 上例中,表示 profile/empLocation/
CRXDE结构的AEM用户配置文件中的节点。 这意味着表单数据模型可以访问 city
类型的属性 string
出现在下的任何节点中 profile/empLocation/
节点。 但是,包含指定属性的节点必须遵循一致结构。
点按 保存 以保存配置。
配置RESTful、SOAP和OData服务的云服务需要配置云服务文件夹。
AEM中的所有云服务配置都整合到中 /conf
AEM存储库中的文件夹。 默认情况下, conf
文件夹包含 global
文件夹,您可以在该文件夹中创建云服务配置。 但是,您需要为云配置手动启用它。 您还可以创建其他文件夹,位于 conf
创建和组织云服务配置。
要为云服务配置配置文件夹,请执行以下操作:
转到 “工具”>“常规”>“配置浏览器”.
执行以下操作可为云配置启用全局文件夹,或跳过此步骤为云服务配置创建和配置其他文件夹。
在 配置浏览器,选择 global
文件夹并点按 属性.
在 配置属性 对话框,启用 云配置.
点按 保存并关闭 保存配置并退出对话框。
在 配置浏览器,点按 创建.
在 创建配置 对话框,为文件夹指定标题并启用 云配置.
点按 创建 以创建为云服务配置启用的文件夹。
可以使用对RESTful Web服务进行描述 Swagger规范 JSON或YAML格式的XML文档。 要在AEM云服务中配置RESTful Web服务,请确保您的文件系统上有Swagger文件或托管该文件的URL。
执行以下操作以配置RESTful服务:
转到工具 > Cloud Services > 数据源。点按以选择要创建云配置的文件夹。
请参阅 为云服务配置配置文件夹 有关为云服务配置创建和配置文件夹的信息。
点按 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 RESTful服务 从 服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后点按 下一个.
为RESTful服务指定以下详细信息:
从Swagger源下拉列表中选择URL或文件,然后相应地指定Swagger定义文件的Swagger URL或者从本地文件系统上传Swagger文件。
根据Swagger源输入,以下字段已预填充值:
方案:REST API使用的传输协议。 下拉列表中显示的方案类型数取决于Swagger源中定义的方案。
主机:提供REST API的主机的域名或IP地址。 它是必填字段。
基本路径:所有API路径的URL前缀。 它是一个可选字段。\
如有必要,请编辑这些字段的预填充值。
选择身份验证类型 — 无、OAuth2.0(授权码, 客户端凭据)、基本身份验证、API密钥、自定义身份验证或相互身份验证 — 用于访问RESTful服务,并相应地提供身份验证的详细信息。
如果您选择 API密钥 作为身份验证类型,指定API密钥的值。 API密钥可作为请求标头或查询参数发送。 从中选择以下选项之一 位置 下拉列表,并在中指定标头的名称或查询参数 参数名称 字段输入相应的。
如果您选择 相互认证 对于身份验证类型,请参阅 RESTful和SOAP Web服务的基于证书的双向身份验证.
点按 创建 以创建RESTful服务的云配置。
Experience Manager Forms 由于数据源包括用于性能优化的HTTP客户端配置,因此,在与RESTful Web服务集成时会生成数据模型。
执行以下步骤以配置表单数据模型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服务进行描述 Web服务描述语言(WSDL)规范. 要在AEM云服务中配置基于SOAP的Web服务,请确保您拥有该Web服务的WSDL URL,并执行以下操作:
转到工具 > Cloud Services > 数据源。点按以选择要创建云配置的文件夹。
请参阅 为云服务配置配置文件夹 有关为云服务配置创建和配置文件夹的信息。
点按 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 SOAP Web服务 从 服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后点按 下一个.
为SOAP Web服务指定以下内容:
Web服务的WSDL URL。
服务端点. 在此字段中指定一个值以覆盖WSDL中提到的服务端点。
选择身份验证类型 — 无、OAuth2.0(授权码, 客户端凭据)、基本身份验证、自定义身份验证、X509令牌或相互身份验证 — 用于访问SOAP服务,并相应地提供身份验证的详细信息。
如果您选择 X509令牌 对于身份验证类型,请配置X509证书。 有关更多信息,请参阅 设置证书.
在中指定X509证书的KeyStore别名 密钥别名 字段。 指定身份验证请求保持有效的时间(秒),在 存留时间 字段。 (可选)选择对消息正文或时间戳标头签名或同时选择两者。
如果您选择 相互认证 对于身份验证类型,请参阅 RESTful和SOAP Web服务的基于证书的双向身份验证.
点按 创建 创建SOAP Web服务的云配置。
OData服务由其服务根URL标识。 要在AEM云服务中配置OData服务,请确保您拥有该服务的服务根URL,并执行以下操作:
表单数据模型支持 OData版本4.
有关配置Microsoft Dynamics 365的分步指南(在线或内部部署),请参阅 Microsoft Dynamics OData配置.
转到工具 > Cloud Services > 数据源。点按以选择要创建云配置的文件夹。
请参阅 为云服务配置配置文件夹 有关为云服务配置创建和配置文件夹的信息。
点按 创建 以打开 创建数据源配置向导. 指定配置的名称和(可选)标题,选择 OData服务 从 服务类型 下拉列表(可选)浏览并选择配置的缩略图图像,然后点按 下一个.
为OData服务指定以下详细信息:
必须选择OAuth 2.0身份验证类型才能使用OData端点作为服务根连接到Microsoft Dynamics服务。
点按 创建 以创建OData服务的云配置。
为表单数据模型启用相互身份验证后,数据源和运行表单数据模型的AEM Server在共享任何数据之前都会验证彼此的身份。 可以对基于REST和SOAP的连接(数据源)使用相互身份验证。 要在AEM Forms环境中为表单数据模型配置双向身份验证,请执行以下操作:
fd-cloudservice
用户和点按 属性.fd-cloudservice
用户,指定证书的密钥别名。您已配置数据源。 接下来,您可以创建一个表单数据模型,或者,如果您已在不使用数据源的情况下创建了表单数据模型,则可以将其与您配置的数据源相关联。 请参阅 创建表单数据模型 以了解详细信息。