写入数据表
组件介绍
在数据表写入或者覆盖内容
截图
属性说明
通用必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入内容 | 字符串 数字 列表 数据表 |
空 | 写入 Excel 的内容 「范围」选择「单元格」时输入内容类型为数字/字符串，如 123 或者 "123" 「范围」选择「行」/「列」时输入内容类型为列表，如 [1,2,3] 「范围」选择「区域」时输入内容类型为数据表，如 [[1,2,3]] 写入内容类型是字符串/数字/列表，而「范围」选择「区域」时则自动将格式转为数据表 |
| 范围 | 下拉选项 | 单元格 | 写入内容的范围： ● 单元格 ● 区域 ● 行 ● 列 |
通用选填项
| 属性名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| 数据表对象 | 对象 | 空 | 需要操作的数据表 空默认为上方最近的一个对象 非空为选择的数据表对象 点击右侧 fx 可以选择数据表对象 |
区域
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 横向追加：在指定行/列已有内容右侧追加写入 ● 纵向追加： 在指定行/列已有内容下方追加写入 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 「写入方式」选择「覆盖写入」时生效 开始写入的起始单元格地址，如 "A8"，为空则默认从 A1 开始写入 |
| 行号 | 数字/字符串 | 空 | 「写入方式」选择「横向追加」时生效 开始横向追加写入的行号，如 2， 行号为空在有内容的下最后一列的下一列的第一行开始横向写入，工作表为空时则默认为第 1 行 行号非空在对应行最后一个有内容单元格的右侧单元格开始横向写入，此行为空默认从此行第一个单元格开始写入 |
| 列 | 数字/字符串 | 空 | 「写入方式」选择「纵向追加」时生效 开始纵向追加写入的列名/列号，如 2 列为空在已有内容最后一行的下一行开始纵向写入，工作表为空时则默认为第 1 列 列非空在指定列最后一个单元格下方的单元格开始纵向写入 |
单元格
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 横向追加：在指定行/列已有内容右侧追加写入 ● 纵向追加： 在指定行/列已有内容下方追加写入 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 单元格 | 字符串 | 空 | 「写入方式」选择「覆盖写入」时生效内容 写入的单元格地址，如 "A8"，为空则默认在 A1 写入 |
| 行号 | 数字/字符串 | 空 | 「写入方式」选择「横向追加」时生效 开始横向追加写入的行号，如 2， 行号为空在有内容的下最后一列的下一列的第一行开始横向写入，工作表为空时则默认为第 1 行 行号非空在对应行最后一个有内容单元格的右侧单元格开始横向写入，此行为空默认从此行第一个单元格开始写入 |
| 列 | 数字/字符串 | 空 | 「写入方式」选择「纵向追加」时生效， 开始纵向追加写入的列名/列号，如 2 列为空在已有内容最后一行的下一行开始纵向写入，工作表为空时则默认为第 1 列 列非空在指定列最后一个单元格下方的单元格开始纵向写入 |
行
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 追加写入：在已有内容最后一行的下一行写入内容 ● 向上插入：在指定行向上写入内容 ● 向下插入：在指定行向下写入内容 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 「写入方式」选择「覆盖写入」时生效 开始写入的起始单元格地址，如 "A8"，为空则默认从 A1 开始写入 |
| 行号 | 数字/字符串 | 空 | 「写入方式」选择「向上插入」/「向下插入」时生效 向上/向下写入内容的行号，空则默认为第 1 行 |
列
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 追加写入：在已有内容最后一列的右侧列写入内容 ● 左侧插入：在指定列向左写入内容 ● 右侧插入：在指定列向右写入内容 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 「写入方式」选择「覆盖写入」时生效 开始写入的起始单元格地址，如 "A8"，为空则默认从 A1 开始写入 |
| 列 | 数字/字符串 | 空 | 「写入方式」选择「左侧插入」/「右侧插入」时生效 向左/向右列写入内容的列名/列号，空则默认为第 1 列 |
返回值
无
组件示例
- 赋值：变量名
数据表，变量值[["1"]]——[["1"]] 为数据表 - 指定数据表对象：数据表对象
数据表，其他选项默认——点击 fx 选择数据表变量 - 写入数据表：写入内容
"22"，单元格"A2"，其他选项默认——在下一行的第一个单元格即 A2 插入字符串数据 "22" - 读取数据表：选项默认，返回值内容
内容——内容为数据表对象，读取全部内容 - 输出日志：日志
内容 - 数据表行数：返回值行数
行数——读取插入字符串数据 "22" 后的数据表行数，未插入前是 1 行，插入后是 2 行 - 输出日志：日志
行数 - 运行结果：在数据表中插入字符串数据 "22"，并在日志面板输出插入数据后的数据表全部内容及对应行数
名词解析
数据表：为多个列表的集合，可以理解为存储大量信息并包含行和列的简单电子表格的数据如，使用方括号把多个用逗号分隔的列表括起来，例如 [[列表1],[列表2],[列表3]]，其中 [[]] 表示空数据表。
列号、列名：数字列号从数字 1 开始，数据类型为数字；字母列名从字母 A 开始，数据类型为字符串；列号 1、2、3 对应列名 "A"、"B"、"C"，为第 1 列、第 2 列及第 3 列，可使用「数字列号转字母列名」及「字母列名转数字列号」组件将列名及列号进行相互转换。
列表：由多个文本组成，每个文本之间以逗号分隔，两端以方括号括起来。例如 ["1","2","3","4","5","6","7"] 就是一个列表，其中包含 7 个文本项。
注意事项
当此组件添加添加到「指定数据表对象」组件中并且对应属性「数据表对象」为空时，操作数据表默认为「指定数据表对象」组件属性「数据表」选择对象对应数据表，具体详见「指定数据表对象」组件。
当此组件的属性「数据表对象」为非空时，操作数据表为选择数据表对象变量对应数据表，如下图「数据表行数」组件的「数据表对象」选择变量 c，则对应操作数据表则为变量 c 对应的数据表，需要保证变量 c 为数据表变量否则会报错。
在网页上抓取数据目前支持谷歌、IE、Edge、360 及 Firefox（火狐） 浏览器，除 IE 浏览器外其他浏览器都需要安装插件，具体操作详见浏览器插件安装说明。
如果必填项单元格或者起始单元格对应数据表的位置中已有内容，会覆盖之前的内容，见组件示例。
范围选择「单元格」时会在指定单元格中输入文本的全部内容。
范围选择「区域」时会按照需要写入数据表的格式，在起始单元格开始输入内容。
范围选择「行」或者「列」时会循环获取列表中的每个数据，并在起始单元格开始依次输入每个数据，如范围选择行并且起始单元格为 "A3"，则会将第一个数据输入到 A3，第二个数据输入到 A4，以此类推。