验证小于等于
验证小于等于 用于验证实际值是否小于等于期望值,支持整数和小数之间的大小比较验证。它常用于数值范围验证、上限检查和业务规则校验,验证结果以布尔值输出。
指令标识:VerifyLessThanOrEqual
指令类型:通用指令
指令描述:验证实际值是否小于等于期望值,支持整数和小数的比较验证
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。验证小于等于 在两种方式里都能用,核心业务参数一致,区别主要是你通过界面配置,还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排(推荐先学) | 拖入「验证小于等于」节点,在右侧表单填写实际值和期望值 | 大多数用户,零代码,适合快速搭建和调试 |
| 代码编排(Python) | 在脚本中调用 bots.verifyLessThanOrEqual(actualNumber=..., expectedNumber=..., outKey="output") | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通,再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名,方便两种方式对应。
什么时候用?
Section titled “什么时候用?”- 验证数值是否不超过最大阈值,确保数据在预期范围内。
- 检查实际值是否小于等于设定上限,用于性能监控、资源检查。
- 根据数值大小关系决定后续的流程分支。
- 验证业务逻辑中的数值是否符合预期(如最高消费、最高评分)。
- 检查数据是否超过最大允许值,保证数据质量。
- 实际值和期望值都为有效数字(支持整数和小数)。
- 已规划好验证失败时的处理方式(输出结果继续,或抛出异常中断)。
- 如使用变量引用,确认引用的变量已正确赋值。
- 输出变量已规划好,用于保存验证结果(Boolean)。
可视化编排:从 0 到跑通
Section titled “可视化编排:从 0 到跑通”下面用一个常见场景演示:验证实际值 5 是否小于等于期望值 5。按 3 步即可跑起来:
- 在画布中添加 验证小于等于 指令。
- 在 实际值 填
5,在 期望值 填5(也可用${变量名}引用变量)。 - 在 将结果保存至 中填写输出变量名(例如
output),点击运行查看验证结果。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| 实际值 | actualNumber | Double | 是 | - | 需要进行小于等于比较的实际数值,仅支持数字类型,例如 10。 |
| 期望值 | expectedNumber | Double | 是 | - | 与实际值进行小于等于比较的期望数值,仅支持数字类型,例如 10。 |
| False结果处理 | falseResultHandling | Enum | 否 | OUTPUT_RESULT | 高级参数,验证结果为 False 时的行为:输出结果=OUTPUT_RESULT(继续流程);抛出异常=THROW_EXCEPTION(中断流程)。 |
| 界面名称 | 代码属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| 将结果保存至 | outKey | Boolean | 否 | 填写变量名称(例如 lessOrEqualResult),保存验证结果(true/false)。 |
- 输出变量中得到布尔结果(
true/false)。 - 实际值小于等于期望值时返回
true,否则按falseResultHandling策略处理。 - 运行日志中没有「非数字」类报错。
运行后你会看到(以上面场景为例):
- 实际值
5小于等于期望值5,输出变量output保存为true。 - 如果实际值大于期望值,节点会按「False 结果处理」配置输出
false或中断流程。
| 现象 | 可能原因 | 处理建议 |
|---|---|---|
| 抛出异常报错 | 输入值不是有效数字 | 确保实际值/期望值为有效数字或数字字符串 |
| 验证失败直接中断流程 | falseResultHandling 设为 THROW_EXCEPTION | 需要继续流程时改为 OUTPUT_RESULT |
| 结果与预期不符 | 变量引用值不正确 | 检查 ${变量名} 引用的变量是否已正确赋值 |
| 取不到验证结果 | 未配置输出变量 | 检查「将结果保存至」是否填写 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建,示例里只需要关注业务指令本身。
# 验证实际值 5 是否小于等于期望值 5bots.verifyLessThanOrEqual( actualNumber="5", expectedNumber="5", falseResultHandling="OUTPUT_RESULT", outKey="output",)可视化表单里的「实际值」「期望值」「False 结果处理」「将结果保存至」分别对应代码里的 actualNumber、expectedNumber、falseResultHandling、outKey。
如果你想在工作流中通过节点动态编排指令,可使用 执行指令(XML)。
Q1:该指令的返回结果是什么类型?
Section titled “Q1:该指令的返回结果是什么类型?”A: 返回结果为布尔值(Boolean)。true 表示实际值小于等于期望值,false 表示实际值大于期望值。
Q2:是否支持浮点数比较?
Section titled “Q2:是否支持浮点数比较?”A: 是的。该指令支持整数和小数的比较验证,使用精确的数值计算确保比较结果的准确性。
Q3:如果输入值不是数字会怎样?
Section titled “Q3:如果输入值不是数字会怎样?”A: 如果输入值不是有效的数字,指令会抛出异常。请确保输入的是有效的数字类型或数字字符串。
Q4:该指令是否支持变量引用?
Section titled “Q4:该指令是否支持变量引用?”A: 是的。该指令支持变量引用,可以使用 ${variableName} 的方式引用变量值作为参数。
Q5:False 结果处理如何使用?
Section titled “Q5:False 结果处理如何使用?”A: 该参数用于控制验证失败场景下的执行行为,支持两种策略(括号内为需传入的参数值):
输出结果(OUTPUT_RESULT,默认):验证失败时输出 false 结果到 outKey,继续执行后续流程。
抛出异常(THROW_EXCEPTION):验证失败时抛出异常,中断当前流程执行。