验证条件为真

验证条件为真 用于验证某个条件是否为真。你可以设置左值、操作符和右值来验证数字关系、字符串包含、集合关系和空值等条件，常用于断言、结果校验和流程分支判断，验证结果以布尔值输出。

指令标识：VerifyTrue
指令类型：逻辑指令
指令描述：验证数字关系、字符串包含、集合关系和空值等条件

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「验证条件为真」节点，在右侧表单填写左值、操作符和右值	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 bots.verifyTrue(leftValue=..., operator=..., outKey="output")	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

• 验证两个数值之间的大小关系（大于、小于、等于等）。
• 验证字符串是否包含特定子字符串。
• 验证集合中是否包含特定元素。
• 验证值是否为空或不为空。
• 根据验证结果决定后续的流程分支。

使用前确认

• 已明确要验证的条件（左值、操作符、右值）。
• 当操作符为 IS_EMPTY（为空）、IS_NOT_EMPTY（不为空）时，右值可不填。
• 已规划好验证失败时的处理方式（输出结果继续，或抛出异常中断）。
• 输出变量已规划好，用于保存验证结果（Boolean）。

可视化编排：从 0 到跑通

下面用一个常见场景演示：验证某个值是否为空。按 3 步即可跑起来：

1. 在画布中添加 验证条件为真 指令。
2. 在 左值 填入要验证的值（如 234），在 操作符 中选择 IS_EMPTY（为空），右值留空。
3. 在 将结果保存至 中填写输出变量名（例如 output），点击运行查看验证结果。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
左值	leftValue	String	是	-	需要进行验证的值。
操作符	operator	Enum	是	GREATER_THAN	验证条件：大于=GREATER_THAN；小于=LESS_THAN；等于=EQUALS；不等于=NOT_EQUALS；大于等于=GREATER_THAN_OR_EQUALS；小于等于=LESS_THAN_OR_EQUALS；包含=CONTAINS；不包含=NOT_CONTAINS；属于=IN；以…开头=START_WITH；以…结尾=END_WITH；为空=IS_EMPTY；不为空=IS_NOT_EMPTY。
右值	rightValue	String	否	-	用于比较的值。当操作符为 IS_EMPTY（为空）、IS_NOT_EMPTY（不为空）时非必填。
False结果处理	falseResultHandling	Enum	否	OUTPUT_RESULT	高级参数，验证结果为 False 时的行为：输出结果=OUTPUT_RESULT（继续流程）；抛出异常=THROW_EXCEPTION（中断流程）。

输出参数

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

成功标准

• 输出变量中得到布尔结果（true/false）。
• 条件满足时返回 true，不满足时按 falseResultHandling 策略处理。
• 运行日志中没有操作符或参数类型相关报错。

失败排查

现象	可能原因	处理建议
结果与预期不符	操作符选错或左右值类型不匹配	检查 operator 与左右值的语义是否一致
缺少右值报错	非空类操作符未填右值	补充右值；仅 IS_EMPTY/IS_NOT_EMPTY 可不填
验证失败直接中断流程	falseResultHandling 设为 THROW_EXCEPTION	需要继续流程时改为 OUTPUT_RESULT
变量引用未生效	引用变量未赋值	检查 ${变量名} 引用的变量是否已正确赋值

Python 代码编排

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

# 验证左值是否为空
bots.verifyTrue(
    leftValue="234",
    operator="IS_EMPTY",
    falseResultHandling="OUTPUT_RESULT",
    outKey="output",
)

需要比较两个值时，填写右值即可：

# 验证左值是否包含右值
bots.verifyTrue(
    leftValue="hello world",
    operator="CONTAINS",
    rightValue="world",
    outKey="output",
)

可视化表单里的「左值」「操作符」「右值」「False 结果处理」「将结果保存至」分别对应代码里的 leftValue、operator、rightValue、falseResultHandling、outKey。

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

常见问题

Q1：该指令支持哪些操作符？

A： 支持数值比较（大于、小于、等于等）、字符串包含、集合关系（属于）、前后缀匹配以及空值检查等多种操作符。

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

A： 返回结果为布尔值（Boolean）。true 表示条件满足，false 表示条件不满足。

Q3：右值是否总是必填的？

A： 否。当操作符为 IS_EMPTY（为空）或 IS_NOT_EMPTY（不为空）时，右值非必填；其他操作符通常需要填写右值。

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

A： 是的。该指令支持变量引用，可以使用 ${variableName} 的方式引用变量值作为左值或右值。

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

A： 该参数用于控制验证失败场景下的执行行为，支持两种策略（括号内为需传入的参数值）：

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

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

相关指令

• 验证相等
• 验证元素存在
• 条件分支
• 断言