When
与 Case (case) 命令配合使用以定义一组规则的条件。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
依赖关系
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
when --left(Variant) --operator(ConditionalOperators) --right(Variant) [--negate(Boolean)]
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| 左操作数 | left |
Required |
Any |
用于评估条件的值。 |
| 运算符 | operator |
Required |
ConditionalOperators |
用于评估条件的规则。 有关更多信息，请参阅 operator 参数选项。 |
| 右操作数 | right |
当 Operator 为 Equal_To, Greater_Than, Greater_Than_Equal_To, Less_Than, Less_Than_Equal_To, Contains, Ends_With, Begins_With, Matches 时必需 |
Any |
与 左操作数 比较以评估条件的值。 |
| 求反 | negate |
Optional |
Boolean |
对运算符中定义的规则求反。 |
operator 参数选项
对条件求值的 Operator 表达式支持以下值。
- 开头为
- 包含
- 结尾为
- 等于
- 大于
- 大于等于
- 为空
- 为 null
- 为 Null 或为空
- 为 true
- 小于
- 小于或等于
- 匹配
示例
使用 Case 命令评估两个条件。 命令 When 在第一个条件中定义左操作数中的值是否小于 3，在第二个条件中定义左操作数是否等于 5。 如果至少有一个条件为 true ，那么将使用 Log Message 命令显示变量 leftOperand 的值。
defVar --name leftOperand --type Numeric --value 5
case --name case --switches "AtLeast" --minimum 1
when --left "${leftOperand}" --operator "Less_Than" --right 3
when --left "${leftOperand}" --operator "Equal_To" --right 5
then
logMessage --message "${leftOperand}" --type "Info"
endCase
logMessage --message "End of execution" --type "Info"