验证大于

验证大于 用于验证实际值是否大于期望值，支持整数和小数的大小比较。它常用于阈值检查、数值范围校验和根据数值关系进行条件分支判断。

指令标识：VerifyGreaterThan
指令类型：通用指令
指令描述：验证实际值是否大于期望值，支持整数和小数的大小比较验证

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。验证大于 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「验证大于」节点，填写实际值、期望值、设置输出变量	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `ok = bots.verifyGreaterThan(actualNumber=15, expectedNumber=10, outKey="result")`	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

验证数值是否超过最小阈值，确保数据在预期范围内。
检查实际值是否大于设定阈值，用于性能监控、资源检查等。
根据数值大小关系决定后续流程分支。
验证业务数值（如评分、增长率）是否达到预期标准。

使用前确认

实际值与期望值均为有效的数字（或数字字符串）。
已规划好输出变量名，用于保存比较结果。
默认失败处理为「抛出异常」（THROW_EXCEPTION），即验证不通过会中断流程；如需继续执行，改为 OUTPUT_RESULT。

可视化编排：从 0 到跑通

在工作流画布中添加 验证大于 节点。
在 实际值 中填写要比较的数值，例如 15；在 期望值 中填写 10。
在 将结果保存至 中填写变量名，例如 result。
如希望验证不通过时继续流程，将 False结果处理 设为 OUTPUT_RESULT。
运行后查看输出是 true 还是 false。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
实际值	`actualNumber`	Double	是	-	需要进行大于比较的实际数值，不能为空，仅支持数字类型，例如 `15`。
期望值	`expectedNumber`	Double	是	-	与实际值比较的期望数值，不能为空，仅支持数字类型，例如 `10`。
False结果处理	`falseResultHandling`	Enum	否	`THROW_EXCEPTION`	高级参数。验证结果为 False 时的行为：`THROW_EXCEPTION`（抛出异常中断流程）、`OUTPUT_RESULT`（输出结果继续流程）。

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	Boolean	是	保存验证结果，`true` 表示实际值大于期望值，`false` 表示小于等于，例如变量名 `result`。

成功标准

节点正常执行并输出布尔结果。
实际值大于期望值时输出 true，符合预期。
后续节点能基于输出结果进行分支判断。

失败排查

现象	可能原因	处理建议
节点抛异常中断流程	默认 `falseResultHandling` 为 `THROW_EXCEPTION` 且验证未通过	如需继续执行，改为 `OUTPUT_RESULT`
比较结果不符合预期	实际值/期望值传错或类型不对	确认两个值为有效数字，必要时检查变量引用
输入非数字报错	值不是有效数字	确保输入为有效的数字类型或数字字符串
浮点比较有疑问	小数精度问题	该指令支持整数和小数的精确比较，确认数值本身正确

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

# 验证 15 是否大于 10，返回值即布尔结果
ok = bots.verifyGreaterThan(
    actualNumber=15,
    expectedNumber=10,
    falseResultHandling="OUTPUT_RESULT",
    outKey="result",
)
print(ok)

如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：该指令的返回结果是什么类型？

A：返回布尔值（Boolean）。true 表示实际值大于期望值，false 表示实际值小于等于期望值。

Q2：是否支持浮点数比较？

A：是的。该指令支持整数和小数的比较验证，使用精确的数值计算确保结果准确。

Q3：如果输入值不是数字会怎样？

A：如果输入不是有效数字，指令会抛出异常。请确保输入为有效的数字类型或数字字符串。

Q4：该指令是否支持变量引用？

A：是的。可以使用 ${变量名} 的方式引用变量值作为参数。

Q5：False结果处理如何使用？

A：该参数控制验证失败时的执行行为（括号内为需传入的参数值），本指令默认 抛出异常：

抛出异常（THROW_EXCEPTION，默认）：验证失败时抛出异常，中断当前流程执行。

输出结果（OUTPUT_RESULT）：验证失败时输出 false 结果到 outKey，继续执行后续流程。