事件订阅介绍

栏目：云苍穹知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：3

事件订阅介绍

事件订阅

事件订阅是指在什么时机做什么内容，事件定义和服务目录都是为事件订阅服务的。

用户可以根据需要新增订阅事件：

一、选取事件

选取事件用于选择事件定义

二、执行服务

执行服务用于选择服务目录

三、服务参数

服务参数是根据“选取事件”和“执行服务”来配置具体的服务参数，从而实现订阅事件的目的。

执行操作

当选取事件不同时，执行操作界面自动匹配相应的界面，目前有如下两种配置界面：

1. “选取事件”为苍穹操作事件，执行服务为“执行操作”时，则服务参数如下图所示：

选取当前实体执行操作
1)   当前实体：根据事件业务对象自动带出，不可编辑
2)   执行操作：指事件触发的时候会执行所选取的执行操作，F7列表中显示当前实体所绑定的操作
3)   执行操作的实体过滤：对当前实体设置过滤条件，该事件触发时，对满足过滤条件的实体执行操作
选取任意实体执行操作
1)   当前实体：根据事件业务对象自动带出，不可编辑
2)   目标实体：用于选择目标实体，F7列表显示所有实体
3)   执行操作：指事件触发的时候会执行所选取的目标实体的执行操作，F7列表中显示目标实体所绑定的操作
4)   关系类型：定义当前实体与目标实体的关系
a)   是当前实体的Botp上游：采用业务流服务中单据转换定义的上游关系
红字提示：执行目标实体操作。“目标实体”是“当前实体”的BOTP上游关系
b)   是当前实体的Botp下游：采用业务流服务中单据转换定义的下游关系
c)   自定义当前实体的上游关系：自定义当前实体与目标实体的上游关系，当前实体的“X字段”=目标实体的“业务主键”
红字提示：执行目标实体操作。“目标实体”是“当前实体”的自定义上游实体，当前实体的X字段等于目标实体的ID
d)   自定义当前实体的下游关系：自定义当前实体与目标实体的上游关系，当前实体的“业务主键”=目标实体的“X字段”
红字提示：执行目标实体操作。“目标实体”是“当前实体”的自定义下游实体，当前实体的ID等于目标实体的X字段
5)   “当前实体=目标实体”配置关系字段：“关系类型”为自定义上下游关系时显示
6)   执行操作的实体过滤：对目标实体设置过滤条件，该事件触发时，对满足过滤条件的目标实体执行操作

2. “选取事件”为自定义事件，执行服务为“执行操作”时，则服务参数如下图所示：

目标实体：指选择事件触发时执行的目标实体，F7列表中显示所有实体
执行操作：指事件触发的时候会执行所选取的执行操作，F7列表中显示目标实体所绑定的操作
执行操作的实体过滤：对目标实体设置过滤条件，该事件触发时，对满足过滤条件的目标实体执行操作

说明：斜体字描述的功能暂未放开

自动发送消息

当执行服务为“发送消息”时，服务参数如下图所示：

接收人：消息接收人
1)   来自单据：控件为“用户”、“创建人”和“修改人”的字段会显示到这里
2)   来自事件：事件参数中配置的与人员用户相关的参数会显示到这里
3)   人员：当前环境中的人员列表（包含外部人员），支持多选
标题：消息标题
1) 支持“插入常用字段”、“插入表达式”和文字
2) “插入表达式”包含实体属性和事件参数
消息：消息内容
1) 支持“插入常用字段”、“插入表达式”和文字
2) “插入表达式”包含实体属性和事件参数
消息渠道：消息接收人收到消息的渠道
1) 消息中心列表、云之家、邮件、短信、钉钉、企业微信可以收到消息通知
2) 渠道的可选类型有由“系统管理-消息平台-消息渠道”控制

调用http服务

当执行服务为“执行Restful服务”时，服务参数如下图所示：

请求方式：http请求方式
1) post：对应网站的请求方式为post时选择此项
2) get：对应网站的请求方式为get时选择此项
url：http接口执行时的url
授权方式：
1)   无授权：无需授权即可调用
2)   oAuth2.0认证：第三方登录场景常用认证方式
3)   自定义获取令牌：通过自定义的方式进行认证
授权配置：“授权方式”为oAuth2.0认证和自定义获取令牌方式时显示
授权方式为oAuth2.0认证时：
1）令牌 URL：获取第三方认证的令牌的url
2）客户端 ID与客户端Secret：作为被第三方信任的识别信息，需要在第三方系统上认证，然后第三方会返回客户端 ID与客户端Secret。
3）认证方式：可选密码认证和客户端认证
授权方式为自定义获取令牌时：
1）令牌URL：获取第三方认证的令牌的url
令牌标识：接口访问时会携带令牌，第三方系统根据该信息进行身份识别。
令牌追加位置：请求头；请求体；url追加参数