添加 列

将列添加到指定的数据表。

命令可用性: 本地 IBM RPA SaaS 和 IBM RPA

脚本语法

IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。

addColumn --dataTable(DataTable) --columnname(String) --type(String) [--expression(String)]

输入参数

下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。

设计器方式标签 脚本方式名称 必需的 接受的变量类型 描述
数据表 dataTable Required Data Table 已评估的数据表。
列名 columnname Required Text 输入为新列指定的名称。
类型 type Required Text 选择已添加到数据表中的新列的数据类型。

请参阅 type 参数选项。
表达式 expression Optional 使用表达式过滤或列数据。 更多信息，请参阅 expression 参数选项。

type 参数选项

下表显示了可用于 type 输入参数的选项。 该表显示了在脚本方式下工作时的可用选项以及在设计器方式下的等效标签。

设计器方式标签 脚本方式名称
布尔值 Boolean
编号 Numeric
文本 String
日期 Date
日期时间 DateTime
时间范围 TimeSpan
货币 Money
电话号码 PhoneNumber

expression 参数选项

expression 参数允许您根据特定条件过滤数据表中的行。

创建 Where 表达式时，请使用列名称来引用列值。 列名可以由简单的字符序列或特殊字符组成，例如 ~ 、 ( 、 ) 、 # 、 \ 、 / 、 = 、 > 、 < 、 + 、 - 、 * 、 % 、 & 、 | 、 ^ 、 ' " 、 [ 、 ] 和 (blank space) 。 包含特殊字符的列名应使用方括号或重音符号（`）括起来。

示例：

包含特殊字符的列名： [Column#] 或`列号`。

有关过滤包含保留字列名的信息，请参阅表达式语法 🡥。

注意： 在输入 where参数时，表达式语法不需要双引号。

价值类型指南

  • 字符串值
    请将字符串值用单引号括起来，例如： 。 Name = 'John' 要在字符串值中包含单引号，请使用另一个单引号进行转义，例如： Name = ''John'' 。

  • 日期值
    请将日期值放在单引号内，例如： 。 Date = '05/05/99'

  • 数字值
    直接定义数字和小数值，无需用任何字符括起来，例如： Goal = 4 或 Price = 70.00 。

  • 运算符值
    您可以使用布尔运算符、比较表达式和数学运算：

布尔运算符：

  • AND
  • OR
  • NOT

比较表达：

  • <
  • >
  • <=
  • >=
  • <>
  • =
  • IN
  • LIKE

数学运算：

  • *（乘）
  • / （部门）
  • + （补充）
  • - （减法）
  • % （模量）

有关支持的布尔运算符优先级和算术运算符的更多信息，请参阅运算符 🡥。

此外，您还可以在 LIKE 比较表达式中使用通配符。 欲了解更多信息，请参阅关于通配符的规则和模式，请发送电子邮件至 通配符 🡥 。

聚集函数

通过引用表格列名来使用聚合函数。 支持以下功能：

  • Sum()
  • Avg()
  • Count()
  • Min()
  • Max()
  • StdDev()
  • Var()

示例：Count(Salary) >= 3

此外，您还可以使用以下受支持的功能：

  • LEN(Column name)：获取字符串的长度。 例如：LEN(Name) = 4。
  • SUBSTRING(Column name, start index, substring length)：从字符串中的指定位置开始，获取指定长度的子串。 例如：SUBSTRING(Name, 1, 3) = 'Car'。
  • TRIM(Column name)：删除所有前导和尾随空格字符，例如： \r 、 \n 、 \t 、 (blank space) 。例如： TRIM(Name) = 'User name' 。
  • IIF(Column name, true statement, false statement)：获取两个值中的一个，具体取决于逻辑表达式的结果。 例如：IIF(Name = 'John', True, False) = True。

示例

使用添加列命令来添加使用“日期”类型的列。

defVar --name excelFile --type Excel
defVar --name excelTable --type DataTable
defVar --name columnNameList --type List --innertype String
// Enter the file path to the excel file
excelOpen --file "tableExcelCompanyCity.xlsx" excelFile=value
excelGetTable --file ${excelFile} --getfirstsheet  --entiretable  --hasheaders  excelTable=value
getColumns --dataTable ${excelTable} columnNameList=names
logMessage --message "Table columns before addColumn: ${columnNameList}" --type "Info"
// Add a new column that uses the Date type 
addColumn --dataTable ${excelTable} --columnname "Column Name" --type Date
getColumns --dataTable ${excelTable} columnNameList=names
// Displays all the columns in the console
logMessage --message "Table columns after addColumn: ${columnNameList}" --type "Info"