表格数据操作

因软件更新较快,部分文档内容与软件最新版本有所出入,请知悉。

【本功能为预览状态,欢迎反馈问题】

对某个表格变量(DataTable对象)进行读写或更新。

关于表格变量的相关说明,请参考文档《表格变量类型》。


通用输入输出参数

输入参数:

【表格变量】选择要操作的目标表格变量。

【操作类型】对表格变量进行的操作种类。

【失败后停止】遇到异常情况时停止继续执行后续步骤。

输出参数:

【是否成功】操作是否没有遇到异常。


操作类型

获取信息

获取表格变量的数据信息。

输出参数:

  • 行列表:表格的Rows数据。需输出到“对象”类型变量中。
  • 列的列表:表格的Columns数据。需输出到“对象”类型变量中。
  • 行数:表格数据的总行数。

添加行

向表格中添加一行数据。

【行数据】

新添加行的各列数据。为词典类型,每一项的Key为列名,Value为值。

注:不需要为自动生成值的列提供数据(如自增长的列等)。

查看或编辑数据

显示一个窗口,可用于查看或修改表格变量中的数据。

通过【只读模式】参数可以控制是否允许修改表格变量中的数据。

只读模式

如果需要复制内容,可以鼠标拖动选中一个或多个单元格后Ctrl+C或使用右键菜单。

编辑模式

注:需要事先在表格变量里定义每列的编辑方式。

点击“添加行”按钮,可以打开表单窗口添加新的行。

双击一行中的单元格或点击后面的“编辑”按钮,可以编辑该行内容。

点击“删除”按钮可以删除一行。

点击“还原”可以将数据恢复到打开窗口时的状态。

查询或筛选行(Select)

使用DataTable对象的Select()方法获取符合条件的行。

【筛选表达式】查询条件,语法请参考《DataView RowFilter Syntax》。

示例:

  • Id = 10 Id > 20 Id in (1,2,3)
  • Name = '张三' Name <> '李四' Name in ('张三','李四','王五')
  • Date = #2022-12-27#
  • Name LIKE '*str*' (通配符*可以在最前面或/和最后面,不能在中间)
  • 布尔操作符支持ANDORNOT 如:NOT City = 'Tokyo' AND NOT City = 'Paris'

【排序】可选。设定查询结果的排序方式,例如:

  • Birth DESC(按Birth列从大到小倒序排序)
  • Id (按ID从小到大正序排序)

输出:

【行数】符合筛选条件的结果行数。

【行列表】符合条件的行列表(类型为DataRow[]),可通过“每个”模块循环访问各行信息。

【第一行】第一条符合条件的行。

从CSV文本加载数据

从csv格式(逗号分隔)的文本加载数据到表格变量。可以在前面使用“读取文件”模块将文件内如读取到文本变量中(csv文件在简体中文系统中通常使用GB2312编码保存),再在本模块中将变量输入到“文本数据”参数。

【文本数据】csv文本内容。第一行应该为标题行,内容为各列的列名。

【清除已有的行】是否清除已有的数据。

从JSON文本加载数据

从JSON数组文本中加载数据。JSON对象中,key为各列的列名。

其它参数同上。

从Excel工作表加载数据

从Excel工作表加载数据。

要读取的Excel工作表中应该有规范的二维表格数据。

【Excel文件路径】Excel文件的完整路径。此文件当前不能被锁定(如在Excel中打开)。

【Excel工作表名】工作表名称。留空时读取第一个工作表。

【标题行号】列名所在行的行号(从1开始的数字,当前面有表头之类的内容时,会大于1)

注:如果遇到错误提示“Wrong Local header signature: 0xE011CFD0”说明您的excel文件后缀名和实际格式不匹配。xslx和xls是两种excel版本,不能混用。

导出文本数据

将表格变量内容导出为文本格式(CSV或Json)。

导出Excel文件

将表格内容输出到一个新建的Excel文档中。

【Excel文件路径】文件的保存路径。

【Excel工作表名】工作表名,留空时为“Sheet1”。




语雀在语雀上查看