验证小于
验证小于 用于验证实际值是否小于期望值,支持整数和小数的大小比较。它常用于上限校验、阈值检查、数据质量检查,以及把比较结果保存为布尔值供后续流程使用。
指令标识:VerifyLessThan
指令类型:通用指令
指令描述:该指令用于验证实际值是否小于期望值,支持整数和小数的大小比较验证
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。验证小于 在两种方式里都能用,核心业务参数一致,区别主要是你通过界面配置,还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排(推荐先学) | 拖入「验证小于」节点,填写实际值、期望值、失败处理和输出变量 | 大多数用户,零代码,适合快速搭建和调试 |
| 代码编排(Python) | 在脚本中调用 bots.verifyLessThan(actualNumber=5, expectedNumber=10, outKey="lessResult") | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通,再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名,方便两种方式对应。
什么时候用?
Section titled “什么时候用?”- 需要验证某个数值低于上限阈值。
- 需要检查采集结果、计算结果或表单数据是否没有超过最大允许值。
- 需要根据数值大小关系决定后续流程分支。
- 需要在自动化测试中把小于比较作为断言或校验步骤。
- 实际值与期望值均为有效数字,或可转换为数字的变量值。
- 已确认实际值和期望值的单位一致,避免比较结果误判。
- 已规划好验证失败时的处理方式:继续输出结果,或抛出异常中断流程。
- 如需后续使用结果,提前设置「将结果保存至」变量名。
可视化编排:从 0 到跑通
Section titled “可视化编排:从 0 到跑通”下面用一个常见场景演示:验证接口响应耗时是否小于上限。按 4 步即可跑起来:
- 在工作流画布中添加 验证小于 指令。
- 在 实际值 中填写响应耗时,例如
5;在 期望值 中填写上限,例如10。 - 在 False结果处理 中选择
OUTPUT_RESULT,让验证失败时输出false并继续流程。 - 在 将结果保存至 中填写变量名,例如
lessResult,运行后查看变量值。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| 实际值 | actualNumber | Double | 是 | - | 需要进行小于比较验证的实际数值,实际值不能为空,仅支持数字类型,例如 5。 |
| 期望值 | expectedNumber | Double | 是 | - | 与实际值进行小于比较的期望数值,期望值不能为空,仅支持数字类型,例如 10。 |
| False结果处理 | falseResultHandling | Enum | 否 | OUTPUT_RESULT | 高级选项。验证结果为 False 时的行为:OUTPUT_RESULT(输出结果,继续流程)、THROW_EXCEPTION(抛出异常,中断流程)。 |
| 是否发送消息 | sendMsgFlag | Boolean | 否 | True | 是否发送节点消息。 |
| 界面名称 | 代码属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| 将结果保存至 | outKey | Boolean | 否 | 验证结果的存储变量名,返回 true 或 false,例如 lessResult。 |
- 节点正常执行,并生成布尔验证结果。
- 当实际值小于期望值时,输出变量为
true。 - 当实际值大于等于期望值时,按
falseResultHandling策略输出false或抛出异常。
运行后你会看到(以上面场景为例):
- 输出变量
lessResult的值为true。 - 运行日志中没有数字格式或参数缺失错误。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
| 节点提示实际值或期望值为空 | 必填参数未填写,或变量引用为空 | 检查「实际值」「期望值」是否有值,确认变量已赋值 |
| 输入非数字时报错 | 参数不是有效数字或数字字符串 | 改为有效数字,例如 5 或 5.5 |
| 验证失败后流程中断 | falseResultHandling 选择了 THROW_EXCEPTION | 如需继续流程,改为 OUTPUT_RESULT |
| 输出结果与预期不一致 | 实际值和期望值填反,或单位不一致 | 对照运行日志和变量面板确认两个输入值 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建,示例里只需要关注业务指令本身。
# 验证响应耗时是否小于上限ok = bots.verifyLessThan( actualNumber=5, expectedNumber=10, falseResultHandling="OUTPUT_RESULT", outKey="lessResult",)print(ok)可视化表单里的「实际值」「期望值」「False结果处理」「是否发送消息」「将结果保存至」分别对应代码里的 actualNumber、expectedNumber、falseResultHandling、sendMsgFlag、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)会中断当前流程。