服务参数介绍

1 简介

1.1 功能介绍

服务参数是在“选取事件”和“执行服务”后，配置具体的服务参数，其打开的配置页面是所选择服务的具体服务配置页面。自BOS_V5.0.011起，预置的事件订阅支持查看服务参数。

1.2 系统路径

【流程服务云】→【业务事件中心】→【事件订阅】→【服务参数】

2 主要页面

选择订阅的事件后，根据需要执行的不同服务，会对应不同的服务参数页面。

2.1 执行服务为“执行操作”

当选取事件不同时，执行操作服务的服务参数界面会有所不同，目前有如下两种配置界面。  

1. “选取事件”为苍穹操作事件，执行服务为“执行操作”，服务参数配置包含“当前实体操作”和“目标实体操作”两种配置。

• 选取当前实体执行操作

        1)   当前实体：根据事件业务对象自动带出，不可编辑；

        2)   执行操作：指事件触发的时候会执行所选取的执行操作，F7列表中显示当前实体所绑定的操作；

        3)   执行操作的实体过滤：对当前实体设置过滤条件，该事件触发时，对满足过滤条件的实体执行操作。

• 选取任意实体执行操作

        1)   当前实体：根据事件业务对象自动带出，不可编辑；

        2)   目标实体：用于选择目标实体，F7列表显示所有实体；

        3)   执行操作：指事件触发的时候会执行所选取的目标实体的实体操作，F7列表中显示目标实体所绑定的实体操作；

        4)   关系类型：定义当前实体与目标实体的关系；

            a.  是当前实体的Botp上游：采用业务流服务中单据转换定义的上游关系；

            红字提示：执行目标实体操作。“目标实体”是“当前实体”的BOTP上游关系。

            b.  是当前实体的Botp下游：采用业务流服务中单据转换定义的下游关系；

            c.  自定义当前实体的上游关系：自定义当前实体与目标实体的上游关系，当前实体的“XX字段”=目标实体的“业务主键”；

            红字提示：执行目标实体操作。

          “目标实体”是“当前实体”的自定义上游实体，当前实体的XX字段等于目标实体的ID。

           d.  自定义当前实体的下游关系：自定义当前实体与目标实体的上游关系，当前实体的“业务主键”=目标实体的“XX字段”；

            红字提示：执行目标实体操作。

           “目标实体”是“当前实体”的自定义下游实体，当前实体的ID等于目标实体的XX字段。

           e.  “当前实体=目标实体”配置关系字段：“关系类型”为自定义上下游关系时显示；

            * 当前实体/目标实体为单据时，可以选择“业务主键”或“单据编码”作为上下游关系的查找字段

            *“XX”字段支持类型为：文本类型和长整形 。

        5)  执行操作的实体过滤：对目标实体设置过滤条件，该事件触发时，对满足过滤条件的目标实体执行操作。

   2.“选取事件”为自定义事件，执行服务为“执行操作”时，服务参数配置仅包含“目标实体”相关配置。

• 目标实体：指选择事件触发时执行的目标实体，F7列表中显示所有实体；

• 执行操作：指事件触发的时候会执行所选取的实体对应的操作，F7列表中显示目标实体所绑定的操作；

• 执行操作的实体过滤：对目标实体设置过滤条件，该事件触发时，对满足过滤条件的目标实体执行操作。

2.2 执行服务为“执行插件”

• 业务应用：微服务调用时自定义应用，非必填；

• 插件名称：填写事件被触发时需要执行的插件的名称；

        注：插件必须实现kd.bos.bec.api.IEventServicePlugin接口的handleEvent方法。

• 微服务调用插件：

        1)   当业务应用没有值时，如果是苍穹事件，会根据事件实体的appid以微服务方式调用插件，如果是自定义事件，默认在工作流节点调用；

        2)   当业务应用有值时，会根据所填应用的appid以微服务方式调用插件。

2.3 执行服务为“微服务”

• 业务云：当执行平台中的微服务时此参数无需填写；当执行业务中的微服务时需选择对应的业务云；

• 业务应用：选择微服务接口所属于的应用；

• 服务名称：微