For Each 循环
循环遍历集合，并将该集合中每个项的值赋给一个变量。 每次迭代都会替换变量的值。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
foreach --collection(List<Variant>) --variable(Variant) [--distinct(Boolean)]
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| 集合 | collection |
Required |
List<Any>, Stack<Any>, Queue<Any>, String Dictionary<Any>, Email Connection, Error, Text File Reader, Workflow Batch |
循环遍历的集合 |
| 变量 | variable |
Required |
Any |
要在迭代中使用的变量。 |
| 非重复值 | distinct |
Optional |
Boolean |
用于将集合中重复的值仅赋给变量一次的选项。 |
示例
示例 1：在启用非重复值选项的情况下，循环遍历“队列”集合，并显示在执行期间赋给变量的值。
defVar --name collectionCycledThrough --type Queue --innertype String --value "[a,b,c,a]"
defVar --name valueCycledThrough --type String
foreach --collection "${collectionCycledThrough}" --variable "${valueCycledThrough}" --distinct
logMessage --message "${valueCycledThrough}" --type "Info"
endFor
//Result:
//a
//b
//c
示例 2：与上一个示例类似，但本例中禁用了非重复值选项。
defVar --name collectionCycledThrough --type Queue --innertype String --value "[a,b,c,a]"
defVar --name valueCycledThrough --type String
foreach --collection "${collectionCycledThrough}" --variable "${valueCycledThrough}"
logMessage --message "${valueCycledThrough}" --type "Info"
endFor
//Result:
//a
//b
//c
//a