(十七)「JVS-Rules规则引擎 V2.5」— 决策流程调用

核心概念: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​中包含了详细的执行结果和过程数据,供后续业务处
相关推荐
进击的雷神4 小时前
怕 AI Agent 乱删文件?Tank-OS 把它锁进不可变系统
人工智能·ai·api·agent
高频因子挖掘机5 小时前
从第一行 Python 代码开始,个人量化项目应该先接入历史行情还是实时行情?
后端·github·api
高频因子挖掘机5 小时前
个人开发者如何高效处理 A 股日 K 线数据?基于 QuantDash 的清洗思路与复权实战
后端·github·api
高频因子挖掘机7 小时前
股票池代码为什么总有问题?从常见误区到可解释的校验报告
后端·github·api
高频因子挖掘机17 小时前
本地已有一年历史数据,第二天更新别只拉“昨天一天”:量化 K 线增量同步实践
后端·github·api
高频因子挖掘机17 小时前
只补缺失日期,不重拉全部历史:增量更新 K 线应该怎么设计?
后端·github·api
SL_staff20 小时前
私有化低代码运维三重雷区:JVS开源栈中的Kafka/ES/RabbitMQ治理实践
java·低代码·全栈
余槐i21 小时前
Claude Code 切换中转站后 401 不断:先查环境变量覆盖顺序
api·开发工具·mcp·claude code·cc-switch
快乐非自愿1 天前
低代码落地费控系统:从报销流程到业财闭环的实操方案
android·低代码·rxjava·ai低代码
comedate1 天前
DeepSeek API 接入教程:申请、Python 调用与常见坑
大模型·api·deepseek