打开 Excel
组件介绍
打开已有 Excel 文件或者新建 Excel
截图
属性说明
必填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 文件 | 字符串 | 空 | 需要打开的 Excel 文件路径 支持 xlsx、xls、xlxm、csv 等表格格式 点击右侧的文件夹图标可以选择需要打开的文件路径 也可以直接输入需要打开的文件路径，首尾需要加英文双引号 点击右侧 fx 可以选择文件路径变量 |
选填项
| 属性名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 运行环境 | 下拉选项 | 自动检测 | 调用 WPS 还是 Microsoft Office 打开 Excel 文件： ● 自动检测：优先检测是否安装 WPS，没有安装 WPS 再检测是否安装 Microsoft Office ● WPS：WPS ● Office：Microsoft Office |
| 密码 | 字符串 | 空 | Excel 文件设置的密码，未设置为空 |
| 前台可见 | 下拉选项 | 是 | 是否在前台显示 Excel 文件： ● 是 ● 否 |
| 自动保存 | 下拉选项 | 是 | 在文件内容发生变化时是否自动保存修改内容： ● 是 ● 否 |
| 结束后关闭 | 下拉选项 | 否 | 组件运行结束是否关闭打开的文件： ● 是 ● 否 |
| 关闭前保存 | 下拉选项 | 是 | 文件关闭前是否保存修改内容： ● 是 ● 否 |
| 新建文件 | 下拉选项 | 是 | 文件不存在是否自动创建： ● 是 ● 否 |
| 只读 | 下拉选项 | 否 | 是否以只读方式打开文件： ● 是 ● 否 |
返回值
| 名称 | 类型 | 说明 |
|---|---|---|
| Excel 对象 | 对象 | 打开 Excel 的句柄 后续 Excel 组件「Excel 对象」选择属性即可操作 Excel 对象对应文件 |
组件示例
- 打开 Excel：文件 "./res/测试.xlsx"，其他选填项默认 — "./res/测试.xlsx" 表示流程的 res 文件夹下的测试.xlsx 文件，文件不存在会自动创建并在输出日志显示路径
- 写入 Excel：写入内容 "测试写入"，单元格 "A1"——在 A1 单元格写入文字：测试写入，Excel 对象为空默认为上一个「打开 Excel」组件打开的文件即测试.xlsx 文件
- 读取 Excel：范围单元格，单元格 "A1"，返回值读取内容读取内容——读取 A1 单元格的内容
- 输出日志：日志读取内容
- 关闭 Excel：运行前等待 5——等待 5 秒关闭 Excel 文件
- 运行结果：打开当前流程 res 文件夹下的测试.xlsx 文件，在 A1 单元格写入文字：测试写入并读取对应单元格数据，等待 5 秒后关闭文件日志面板输出 A1 单元格的文字：测试写入
名词解析
只读：只能读取文件，无法正常修改和存储文件内容。
注意事项
- 运行环境选择「自动检测」时，默认会先检测是否安装 WPS，如果已安装则调用 WPS 打开 Excel；如果未安装 WPS 再检测是否安装 Microsoft Office，如果已安装则调用 Microsoft Office 打开 Excel；如果两个软件都没有安装默认会报错。
- 必须安装 2016 及其以上版本 Microsoft Office 软件或者 WPS 软件。
- v1.3.6 及以上版本编辑器使用此组件时，其他 Excel 组件可以不添加到当前组件中，当其他 Excel 组件「Excel 对象」为非空时，操作对象为 Excel 对象对应的 Excel 文件；「Excel 对象」为空默认为上方最近的一个 Excel 对象。
- 文件同时支持相对路径和绝对路径，相对路径以点斜杠 ./ 开头，代表该流程路径下文件夹，如示例中文件对应的 "./res/测试.xlsx"，表示当前流程 res 文件夹下的测试.xlsx 文件，在当前流程顶部标签页鼠标右键点击「打开位置」，打开 res 文件夹即可看到测试.xlsx 文件。
- 「新建」选择是时，在文件不存在时会自动创建并在输出日志显示新创建的文件路径。
- 当前组件不推荐文件格式为 csv，文件格式为 csv 时使用部分组件如「设置列宽」及「设置行高」等会失效，无法修改对应位置的列宽及行高。
- 如果此组件运行出现未打开对应 Excel 文件或者报错 RPC 服务器不可用的问题，请点击右上角蓝色头像，点击「设置」，点击「关于我们」中 SDK 版本后方的「重置运行环境」按钮后重新运行流程试下。