核心概念:API使用级集成
决策流程的调用主要通过API使用级集成方式实现。这种方式将JVS规则引擎视为一个独立的服务,外部系统在需要进行业务逻辑判断时,将对应的入参传入规则引擎,由规则引擎根据预先配置的决策模型执行并返回结果。
集成特点:简单高效。
前提条件:业务管理人员需要在规则引擎中预先配置对应的判断模型、函数加工和决策流程。
提供的调用接口
提供有三种类型的接口用于决策流程的调用与查询:
- 查询入参变量:通过决策流水号查询该决策流定义的入参变量。
- 执行决策流(通过决策流编号):这是最主要的执行接口,通过传入决策流编号和参数来执行整个决策流程。
- 直接调用第三方接口:提供了直接调用外部API的接口,但这属于数据源接入范畴,并非直接调用本系统的决策流。
调用方式与步骤
以接口“通过决策流编号执行”为例,调用一个决策流程通常包含以下步骤:
1. 获取接口信息与凭证
在决策列表或详情页中,找到您要调用的决策流,其对应的【调用示例】或【服务开放】页面会生成该决策流的API调用说明,包括:
- 接口地址:例如
POST /api/risk/projectFlow/call/{no},其中 {no} 是决策流的唯一编号。 - 请求方式:通常为
POST。 - 请求Headers:通常需要传入
application-name(应用名)和 secret(凭证,需在“服务开放”中生成)。 - 请求参数:该API所需的业务入参。
2. 构造请求并执行调用
根据接口文档构造HTTP请求:
- 请求地址:将决策流编号
{no} 替换为实际的编号。 - 请求体(Body):以JSON数组格式传入该决策流需要的所有业务入参。
- 请求头(Header):放入
application-name 和 secret 等信息。
3. 解析响应结果
执行成功后,系统会返回一个JSON格式的响应。返回参数主要包含:
-
code:状态码,通常0为正常,500为异常。 data:业务返回的具体数据,其中包含了执行结果的核心信息,例如:
-
errorCode:执行结果code码,0为正常执行。 -
result:决策流最终通过或未通过的结果。 -
list:详细数据列表,包含每个节点的执行结果等。 -
modelJson:节点树执行的测试结果JSON。
-
msg:返回的信息。
如何测试调用
在决策设计器的界面中,可以直接进行模拟调用:
- 进入决策流的【决策设计】页面。
- 点击画布上方的【执行】按钮(测试执行)。
- 在弹出的“参数映射”窗口中,填入该决策流所需的入参值。
- 点击【执行】按钮,系统会模拟执行整个流程,并在界面上展示每个节点的执行状态与最终结果。
关键总结
- 决策流通过RESTful API被外部系统调用,每个决策流有唯一的编号。
- 调用时需通过
Header传递凭证,通过Body传递业务入参。 - 系统提供了在线模拟测试功能,方便在开发阶段进行调试和验证。
- 返回的
data中包含了详细的执行结果和过程数据,供后续业务处