While
在条件为 true 时重复命令块。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
依赖关系
使用 End while (endWhile) 命令终止命令块。
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
while --left(Variant) --operator(ConditionalOperators) --right(Variant) [--negate(Boolean)]
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| 左操作数 | left |
Required |
Any |
用于对条件求值的值。 如果定义的变量的类型为 "数字" ，那么缺省值为 0。 |
| 运算符 | 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
- 小于
- 小于或等于
- 匹配
示例
示例 1: 将 incrementVar 的值递增 1 ，并停止，直到该值不再小于 5 为止。
defVar --name verifyValue --type Numeric
while --left "${verifyValue}" --operator "Less_Than" --right 5
incrementVar --number ${verifyValue}
logMessage --message "${verifyValue}" --type "Info"
endWhile
// Result of operation:
// 1
// 2
// 3
// 4
// 5
示例 2: 在类似情况下，变量 verifiedValue 以值 8 开头，并且循环会将其递减，直到该值不再大于 5 为止。
// The value to be verified is equal to 8.
defVar --name verifiedValue --type Numeric --value 8
while --left "${verifiedValue}" --operator "Less_Than" --right 5 --negate
logMessage --message "${verifiedValue}" --type "Info"
decrementVar --number ${verifiedValue}
endWhile
// Result of the operation:
// 8
// 7
// 6
// 5