定义变量
将变量定义为具有特定类型的输入或输出变量。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
描述
将变量定义为输入或输出变量。 每个变量都必须有一个变量类型，具体取决于其用途。 更多信息，请参阅变量类型部分。
您现在可以在定义变量(defVar) 命令中添加注释。 您在命令中添加的注释将作为输入变量的描述，您可以在IBM RPA Control Center的机器人和日程页面中看到这些注释。
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
defVar --name(String) --type(String) [--innertype(String)] [--value(Variant)] [--parameter(Boolean)] [--output(Boolean)] [--required(Boolean)]
依赖关系
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| 名称 | name |
Required |
Text |
变量的名称，在需要引用该变量时使用。 |
| 变量类型 | type |
Required |
Text |
变量的数据类型。 请参阅 变量类型 部分以获取更多详细信息。 |
| 内部类型 | innertype |
Optional |
Text |
类型为 "列表" ， "行" ， "堆栈" 或 "数据字典" 的变量的内部数据类型。 |
| 值 | value |
Optional |
Text |
分配给变量的初始值作为其缺省值。 可以使用 Set Variable (setVar) 命令指定变量不视为缺省值的值。 |
| 模式 | schema |
Optional. Only appears when Variable Type is Data Table |
Text |
定义数据表变量的模式。 请参阅 schema 参数选项 以获取详细信息。 |
| 脚本输入参数 | parameter |
Optional |
Boolean |
使其能够使用变量作为输入参数。 输入参数从外部请求 (例如， API 调用或其他源) 接收值。 |
| 脚本输出参数 | output |
Optional |
Boolean |
使其能够将变量用作输出参数。 输出参数从相应的脚本或其他源返回值。 |
| 必需的 | required |
Only visible when the "Script Input Parameter" parameter is enabled |
Boolean |
启用时，需要设置为 "脚本输入参数" 的参数。 否则，脚本无法正确运行。 |
schema 参数选项
此参数定义数据表变量的结构。 您可以定义列的名称以及每个列接受的变量类型。 目前，模式中接受以下数据类型:
- 布尔值
- 日期时间
- 数字
- 文本
如果分配的值与指定的模式不匹配，那么运行时将抛出错误消息。
示例
示例 1: 创建 "Boolean" 变量而不传递初始值。 因此，缺省情况下，初始值为“False”。
defVar --name booleanVariable --type Boolean
logMessage --message "Boolean Variable Content: ${booleanVariable}" --type "Info"
// Result: Variable Content: False.
示例 2: 创建初始值为 "546548" 的 "Number" 变量。
defVar --name numericVariable --type Numeric --value 546548
logMessage --message "Numeric Variable Content: ${numericVariable}" --type "Info"
// Result: Numeric Variable Content 546548.
示例 3: 创建内部类型为 "文本" 的 "堆栈" 变量，其初始值为 "Mary ， Jhon ， Liry ， Lucy ， Klaus"。
defVar --name stringStack --type Stack --innertype String --value "[Mary, Jhon, Liry, Lucy, Klaus]"
logMessage --message "String Stack Content: ${stringStack}" --type "Info"
// Result: String Stack Content: [Klaus,Lucy,Liry,Jhon,Mary].
🛈 请记住: Log Message (logMessage) 命令的唯一功能是在控制台中显示变量的值，而不显示与变量声明相关的其他函数。