写入 Excel
组件介绍
在工作表写入或者覆盖内容
截图
属性说明
通用必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入内容 | 字符串 数字 列表 数据表 |
空 | 写入 Excel 的内容 【范围】选择【单元格】时输入内容类型为数字/字符串，如 123 或者 "123" 【范围】选择【行】/【列】时输入内容类型为列表，如 [1,2,3] 【范围】选择【区域】时输入内容类型为数据表，如 [[1,2,3]] 无论写入内容类型是字符串/数字/列表，在【范围】选择【区域】时则自动将格式转为数据表 |
| 范围 | 下拉选项 | 区域 | 写入内容的范围： ● 单元格 ● 区域 ● 行 ● 列 |
通用选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 表名 | 字符串 | 空 | 需要操作的工作表名称，为空默认为当前打开的工作表 |
| Excel 对象 | 对象 | 空 | 需要切换的 Excel 文件 【打开 Excel】组件返回值对应的 Excel 文件 空默认为上一个【打开 Excel】组件打开的 Excel 文件 |
区域
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 横向追加：在指定行/列已有内容右侧追加写入 ● 纵向追加： 在指定行/列已有内容下方追加写入 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 【写入方式】选择【覆盖写入】时生效， 开始写入的起始单元格地址，如 "A8"，为空则默认从 A1 开始写入 |
| 行号 | 数字/字符串 | 空 | 【写入方式】选择【横向追加】时生效 开始横向追加写入的行号，如 2， 行号为空在有内容的下最后一列的下一列的第一行开始横向写入，工作表为空时则默认为第 1 行 行号非空在对应行最后一个有内容单元格的右侧单元格开始横向写入，此行为空默认从此行第一个单元格开始写入 |
| 列 | 数字/字符串 | 空 | 【写入方式】选择【纵向追加】时生效 开始纵向追加写入的列名/列号，如 2 列为空在已有内容最后一行的下一行开始纵向写入，工作表为空时则默认为第 1 列 列非空在指定列最后一个单元格下方的单元格开始纵向写入 |
单元格
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 横向追加：在指定行/列已有内容右侧追加写入 ● 纵向追加： 在指定行/列已有内容下方追加写入 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 单元格 | 字符串 | 空 | 【写入方式】选择【覆盖写入】时生效内容 写入的单元格地址，如 "A8"，为空则默认在 A1 写入 |
| 行号 | 数字/字符串 | 空 | 【写入方式】选择【横向追加】时生效 开始横向追加写入的行号，如 2， 行号为空在有内容的下最后一列的下一列的第一行开始横向写入，工作表为空时则默认为第 1 行 行号非空在对应行最后一个有内容单元格的右侧单元格开始横向写入，此行为空默认从此行第一个单元格开始写入 |
| 列 | 数字/字符串 | 空 | 【写入方式】选择【纵向追加】时生效， 开始纵向追加写入的列名/列号，如 2 列为空在已有内容最后一行的下一行开始纵向写入，工作表为空时则默认为第 1 列 列非空在指定列最后一个单元格下方的单元格开始纵向写入 |
行
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 追加写入：在已有内容最后一行的下一行写入内容 ● 向上插入：在指定行向上写入内容 ● 向下插入：在指定行向下写入内容 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 【写入方式】选择【覆盖写入】时生效 开始写入的起始单元格地址，如 "A8"，为空则默认从 A1 开始写入 |
| 行号 | 数字/字符串 | 空 | 【写入方式】选择【向上插入】/【向下插入】时生效 向上/向下写入内容的行号，空则默认为第 1 行 |
列
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 写入方式 | 下拉选项 | 覆盖写入 | 写入数据的方式： ● 覆盖写入： 直接在指定位置写入并覆盖原有内容 ● 追加写入：在已有内容最后一列的右侧列写入内容 ● 左侧插入：在指定列向左写入内容 ● 右侧插入：在指定列向右写入内容 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 起始单元格 | 字符串 | 空 | 【写入方式】选择【覆盖写入】时生效 开始写入的起始单元格地址，如 "A8"，为空则默认从 A1 开始写入 |
| 列 | 数字/字符串 | 空 | 【写入方式】选择【左侧插入】/【右侧插入】时生效 向左/向右列写入内容的列名/列号，空则默认为第 1 列 |
返回值
无
组件示例
- 打开 Excel：文件 "./res/测试.xlsx"，其他选填项默认 — "./res/测试.xlsx" 表示流程的 res 文件夹下的 测试.xlsx 文件，具体介绍详见【打开 Excel】组件
- 写入 Excel：写入内容 "测试写入"，范围单元格，单元格 "A1"，其他选项默认
- 读取 Excel：范围单元格，单元格 A1"，返回值读取内容读取内容
- 输出日志：日志读取内容——点击 fx 选择变量
- 关闭 Excel
- 运行结果：打开 测试.xlsx 文件，在 A1 单元格写入文字：测试写入，读取并在日志面板输出 A1 单元格的内容
名词解析
列表：由多个文本组成，每个文本之间以逗号分隔，两端以方括号括起来。例如 ["1","2","3","4","5","6","7"] 就是一个列表，其中包含 7 个文本项。
数据表：为多个列表的集合，可以理解为存储大量信息并包含行和列的简单电子表格的数据如，使用方括号把多个用逗号分隔的列表括起来，例如 [[列表1],[列表2],[列表3]]，其中 [[]] 表示空数据表。
注意事项
此组件可以不添加到【打开 Excel】或者【指定 Excel 对象】组件（仅支持 v1.3.6 及以上版本编辑器及模拟器），当此组件【Excel 对象】为非空时，操作对象为 Excel 对象对应的 Excel 文件；【Excel 对象】为空默认为上方最近的一个 Excel 对象。
此组件不支持 csv 格式的文件。
必须安装 2016 及其以上版本 Microsoft Office 软件或者 WPS 软件。
范围选择列或者行时，会将列表中的每个数据从起始单元格开始依次写入。
范围选择区域时，会将数据表中的内容从起始单元格开始依次写入。
选填项输入的表名不存在会报错，不写默认为当前打开的工作表，可以使用【所有工作表名】组件获取工作表名称。
如果写入的单元格已有内容会覆盖之前的内容。
操作文件格式为 csv 时此组件将不生效，请更换 xlsx 或者 xls 格式再试下。
如果出现出现未打开对应 Excel 文件或者此组件报错：RPC 服务器不可用或者报错：组件执行失败的问题，请点击右上角蓝色头像，点击【设置】，点击【关于我们】中 SDK 版本后方的【重置运行环境】按钮后重新运行流程试下。