(十七)「JVS-Rules规则引擎 V2.5」— 决策流程调用
2026/7/10 3:45:13 网站建设 项目流程

核心概念:API使用级集成

决策流程的调用主要通过API使用级集成方式实现。这种方式将JVS规则引擎视为一个独立的服务,外部系统在需要进行业务逻辑判断时,将对应的入参传入规则引擎,由规则引擎根据预先配置的决策模型执行并返回结果。

集成特点:简单高效。
前提条件:业务管理人员需要在规则引擎中预先配置对应的判断模型、函数加工和决策流程。

提供的调用接口

提供有三种类型的接口用于决策流程的调用与查询:

  1. 查询入参变量:通过决策流水号查询该决策流定义的入参变量。
  2. 执行决策流(通过决策流编号):这是最主要的执行接口,通过传入决策流编号和参数来执行整个决策流程。
  3. 直接调用第三方接口:提供了直接调用外部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​​:返回的信息。

如何测试调用

在决策设计器的界面中,可以直接进行模拟调用:

  1. 进入决策流的【决策设计】页面。
  2. 点击画布上方的【执行】按钮(测试执行)。
  3. 在弹出的“参数映射”窗口中,填入该决策流所需的入参值。
  4. 点击【执行】按钮,系统会模拟执行整个流程,并在界面上展示每个节点的执行状态与最终结果。

关键总结

  1. 决策流通过RESTful API被外部系统调用,每个决策流有唯一的编号
  2. 调用时需通过​​Header​​传递凭证,通过​​Body​​传递业务入参
  3. 系统提供了在线模拟测试功能,方便在开发阶段进行调试和验证。
  4. 返回的​​data​​中包含了详细的执行结果和过程数据,供后续业务处

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询