验证大于等于

验证大于等于 用于比较两个数值，判断实际值是否大于等于期望值，并输出验证结果（True/False）。它支持整数和小数比较，常用于阈值检查、数值范围验证、流程分支判断等场景。

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

先选使用方式

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

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

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

什么时候用？

验证数值是否达到或超过最小阈值，确保数据在预期范围内。
检查实际值是否大于等于设定阈值，用于性能监控、资源检查等。
根据数值大小关系决定后续的流程分支。
验证业务规则中的数值是否符合预期，如最低评分、库存下限等。

使用前确认

实际值和期望值均为有效数字（整数或小数），不能为空。
若使用变量引用（如 ${variableName}），确认变量已正确赋值且为数值。
已规划好验证失败时的处理方式（输出结果或抛出异常）。

可视化编排：从 0 到跑通

下面用一个常见场景演示：验证某项评分是否达到合格线。按 3 步即可跑起来：

在工作流画布中添加 验证大于等于 节点。
在 实际值 填入待校验数值（如评分变量），在 期望值 填入合格线（如 8），并设置输出变量名。
点击运行，确认输出变量得到 true（达到或超过）或 false（未达到）。

参数说明

输入参数

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

输出参数

界面名称	代码属性名	类型	必填	说明
将结果保存至	`outKey`	Boolean	否	填写变量名称（如 `greaterOrEqualResult`），保存验证结果（`true`/`false`）。

成功标准

节点运行成功，日志中没有数值解析错误。
输出变量得到布尔结果：true 表示实际值大于等于期望值，false 表示小于。
设为抛出异常时，验证失败会中断流程；设为输出结果时，会继续执行后续节点。

运行后你会看到（以上面场景为例）：

输出变量得到 true（达到或超过合格线）或 false（未达到）。
运行日志显示验证执行成功。

失败排查

现象 / 报错原文	可能原因	处理建议
报错提示不是有效数字	输入值不是数字或数字字符串	确认实际值、期望值为有效数字；变量引用时确认变量已赋值
结果与预期不符	实际值/期望值取反或单位不一致	核对两个数值的来源与含义
验证失败直接中断流程	`falseResultHandling` 设为抛出异常	如需继续执行，改用 `OUTPUT_RESULT`
浮点比较结果意外	浮点精度问题	该指令使用精确数值计算，仍需确认输入精度是否符合预期

Python 代码编排

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

# 验证实际值 8 是否大于等于期望值 8，结果保存到 output
bots.verifyGreaterThanOrEqual(
    actualNumber=8,
    expectedNumber=8,
    falseResultHandling="OUTPUT_RESULT",
    outKey="output",
)

可视化表单里的「实际值」「期望值」「False结果处理」「将结果保存至」分别对应代码里的 actualNumber、expectedNumber、falseResultHandling、outKey。如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

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

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

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

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

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

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

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

A：支持。可使用 ${variableName} 的方式引用变量值作为参数。

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

A：该参数用于控制验证失败时的执行行为（括号内为需传入的参数值）：

输出结果（OUTPUT_RESULT，默认）：验证失败时输出 false 到 outKey，继续执行后续流程。
抛出异常（THROW_EXCEPTION）：验证失败时抛出异常，中断当前流程执行。