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 执行服务为“微服务”

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

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

• 服务名称：微服务接口所在的java类；

• 方法名：微服务接口的名称；

• 参数：执行该微服务所需要的参数信息。

        1)   参数名称：参数的名称；

        2)   参数类型：参数对应的类型，目前支持：字符串、整数、小数、长整数、布尔值、日期/时间；

        3)   参数值：参数对应的值，支持手动输入和表达式的选择（包括单据字段和事件参数）。

2.4 执行服务为“发送消息”

•  接收人：消息接收人

        1)   来自单据：为“用户”、“创建人”和“修改人”等的人员类型及基础资料类型字段会显示到这里；

        2)   来自事件：事件参数中配置的与人员用户类型及基础资料字段相关的参数会显示到这里；

        3)   人员：当前环境中的人员列表（包含外部人员），支持多选；

        4)   插件：支持使用插件的方式自定义接收人，插件支持微服务调用。

• 标题：消息标题

        1)   支持“插入常用字段”、“插入表达式”和文字；

        2)   “插入表达式”包含实体属性和事件参数。

• 消息：消息内容

        1)   支持“插入常用字段”、“插入表达式”和文字；

        2)   “插入表达式”包含实体属性和事件参数。

• 消息渠道：消息接收人收到消息的渠道

        1)   消息中心，云之家、邮件、短信、钉钉、企业微信可以收到消息通知；

        2)   渠道的可选类型有由“系统管理-消息平台-消息渠道”控制。

2.5 执行服务为“执行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） 认证方式：可选密码认证和客户端认证。

        授权方式为自定义获取令牌时：

            令牌URL：获取第三方认证的令牌的url

• 令牌标识：接口访问时会携带令牌，第三方系统根据该信息进行身份识别；

• 令牌追加位置：请求头；请求体；url追加参数。