事件定义

事件定义用于定义具体的时机，目前提供了2种方式：

• 苍穹操作事件：定义了苍穹实体上的操作，执行此操作时会触发事件；

• 自定义事件：定义了http api，执行接口时会触发事件。

事件使用规则：

1. 事件在启用状态下，可以在事件订阅中选中，如果事件被禁用，那么事件订阅中不可选中，且事件不会被触发；

   
   

2. 已订阅的事件不允许修改,删除订阅之后才能修改/删除事件定义；

   
   

3. 存在引用时，不允许删除。

苍穹操作事件

• 业务对象：事件类型为“苍穹操作事件”时显示，业务对象列表中显示所有实体；

• 来源应用：

  1） 事件类型为“苍穹操作事件”时显示；

  2） 根据“业务实体”自动带出，不可编辑；

  3） “业务实体”删除后，自动清空。

• 业务操作：

  1） 事件类型为“苍穹操作事件”时显示；

  2） 依赖于“业务实体”，没有选中“业务实体”时，则无法选择；

  3） 删除或变更“业务实体”时会自动清空。

• 事件编码：根据“业务实体.业务操作”自动生成（eg：er_tripreqbill.new）；编码不允许重复；

• 事件名称：根据“业务实体.业务操作”自动生成（eg：出差申请单.新增）；

• 事件参数：根据业务对象选择对象的属性；

  苍穹内部的操作事件发起时，默认只会携带单据主键和实体编码，当该事件需要被外部系统响应时，不能仅传递单据主键，开启“传递数据”后，会将当前属性重新作为事件参数包装，并分发给后续各个服务中传递执行。

• 支持新增事件参数 ；

  单据操作返回值不仅包含实体对象的参数，还包含其他参数，如需引用需要新增事件参数用于事件订阅。
  

自定义事件

当苍穹提供的操作事件满足不了用户需求时，可以自定义事件来满足需求。

自定义事件触发：接口触发（API名称：触发业务事件）

定义：事件名称，事件参数。

例如：

通过接口触发事件时，就会执行对应的发送消息或执行操作或者其他服务项。

开放平台接口说明                      

https://feature.kingdee.com:1026/devwf/kapi/app/bec/triggerEvent { "eventNumber":"selfEvent001",

"data":{ "billno":"xx001", "date":"2020-07-15", "source":"sap", "businesskey":"929690539081611264,929691255141578752" //如果是触发苍穹操作，这个项为必填 } }

参数说明