本节概述了如何使用事件验证连接器实例。每个连接器都不同,因此请查看特定连接器指南的“事件”部分。您可以通过SAP Cloud Platform Open Connectors或API进行身份验证。
使用轮询验证连接器实例
使用事件验证连接器实例与验证实例的工作方式相同,您只需打开事件并设置更多参数即可。
有关此处描述的每个字段的详细信息,请参阅参数。
要通过轮询验证连接器实例:
输入验证元素实例所需的基本信息,如特定于连接器的文档中所述,或验证连接器实例中的一般步骤。要在事件回调的标头中启用哈希验证,请单击“ 显示可选字段”,然后向“ 回调通知签名密钥”添加密钥。启用事件:启用切换事件。
如果连接器同时支持轮询和webhook,请在“ 事件类型”中选择事件类型。使用事件轮询器刷新间隔(分钟)滑块或输入以分钟为单位的数字,以指定SAP Cloud Platform Open Connectors应轮询更改的频率。选择要轮询的资源。高级用户可以进一步配置轮询:
单击 以直接编辑轮询配置JSON。
右侧的代码视图event.poller.configuration使用默认轮询配置更新JSON对象。您可以更改每个经过身份验证的实例的轮询配置。
(可选)键入或选择一个或多个元素实例标记以添加到经过身份验证的元素实例。单击“ 创建实例”。
您的轮询配置已完成,您可以对连接器实例进行身份验证。使用事件构建公式以完成各种工作流程。
轮询参数
UI上的标签和按钮对应于JSON中的参数。下表显示了粗体的 UI标签和按钮以及配置JSON对象中的等效参数code formatting。
参数 | 描述 | 数据类型 |
已启用事件 event.notification.enabled |
标识为连接器实例启用的事件。 默认值:false。 |
布尔 |
事件类型 event.vendor.type |
事件的类型,polling或者webhook。 | 字符串 |
事件通知回调URL event.notification.callback.url |
您希望SAP Cloud Platform Open Connectors发送事件的URL。 | 字符串 |
事件轮询器刷新间隔(分钟) event.poller.refresh_interval |
用于确定轮询器检查更改的频率的分钟数。 | 数 |
回调通知签名密钥 event.notification.signature.key |
可选。用户定义的密钥,用于增加安全性以显示事件未被篡改。 | 字符串 |
配置轮询 event.poller.configuration |
轮询的配置参数。 提示:默认轮询配置表示最佳配置。虽然您可以更改轮询器配置中的任何内容,但我们建议您很少这样做并与SAP Cloud Platform Open Connectors支持结合使用。 | JSON对象 |
轮询资源 resourceName(例如contacts) |
您将监视的资源的轮询事件配置。 | JSON对象 |
网址 url |
用于查询资源更新的URL。 | 字符串 |
ID字段 idField |
资源中用于唯一标识它的字段。 | 字符串 |
高级过滤 datesConfiguration |
轮询中日期的配置参数。 | JSON对象 |
更新日期字段 updatedDateField |
标识更新对象的字段。 | 字符串 |
更新日期格式 updatedDateFormat |
标识更新对象的字段的日期格式。 | 字符串 |
创建日期字段 createdDateField |
标识已创建对象的字段。 | 字符串 |
创建日期格式 createdDateFormat |
标识已创建对象的字段的日期格式。 | 字符串 |
使用Webhooks验证连接器实例
使用事件验证连接器实例与验证实例的工作方式相同,您只需打开事件并设置更多参数即可。
注意:使用webhook事件对连接器实例进行身份验证时,请确保选中“连接器指南”以获取API提供程序所需的任何其他设置。
要使用webhooks验证连接器实例:
输入连接器实例的名称以及验证连接器实例所需的任何配置参数。要在事件回调的标头中启用哈希验证,请单击“ 显示可选字段”,然后向“ 回调通知签名密钥”添加密钥。启用事件:启用切换事件。
如果连接器同时支持轮询和Webhook,请在“ 事件类型”中选择webhooks。
添加事件通知回调URL以接收有关事件的信息。
注意:在大多数情况下,您必须将事件回调URL设置为API提供程序的webhook设置的一部分,并且您在此处输入的内容应该匹配。
您的webhooks配置已完成,您可以对连接器实例进行身份验证。使用事件构建公式以完成各种工作流程。
Webhook参数
UI上的标签和按钮对应于JSON中的参数。下表显示了粗体的 UI标签和按钮以及配置JSON对象中的等效参数code formatting。
bbbbb
参数 | 描述 | 数据类型 |
已启用事件 event.notification.enabled |
标识为连接器实例启用的事件。 默认值:false。 |
布尔 |
事件类型 event.vendor.type |
事件的类型,polling或者webhook。 | 字符串 |
事件通知回调URL event.notification.callback.url |
您希望SAP Cloud Platform Open Connectors发送事件的URL。 | 字符串 |
回调通知签名密钥 event.notification.signature.key |
可选。用户定义的密钥,用于增加安全性以显示事件未被篡改。 | 字符串 |