Excel应用程序范围
功能
(1)打开一个提供 Excel 活动范围的 Excel 工作簿。
(2)当该活动结束时,工作簿和 Excel 应用程序都将关闭。如果不存在指定文件,则会新建一个 Excel 文件。
选项
| 名称 | 说明 | 示例 |
|---|---|---|
| 启动方式 | 【枚举】Excel或wps的类型。 | ‘Microsoft Excel’、‘WPS Excel’、‘WPS Excel ET’ |
| 密码 | 【字符串】工作簿的密码,如果需要。 | ‘123’ |
| 编辑密码 | 【字符串】编辑工作簿所需要的密码,如果需要。 | ‘123’ |
| 自动识别 | 【布尔】是\否自动识别本机能使用的软件。默认情况下,未勾选此复选框。若勾选,则自动识别本机能使用的office或wps,且优先级为wps>office;若不勾选,则不会自动识别能使用的软件。 | 是 |
| 自动保存 | 【布尔】是\否自动保存。默认情况下,此复选框处于选中状态。如果不勾选,则在Excel Appliaction Scope执行结束时将不保存更改。 | 是 |
| 新建文件 | 【布尔】是\否新建。默认情况下,此复选框处于选中状态。若勾选:如果在指定路径下找不到工作簿,则会使用在WorkbookPath属性字段中指定的名称创建一个新的Excel工作簿。若不勾选:如果在指定路径下找不到工作簿,则会引发异常,通知用户。 | 是 |
| 宏设置 | 【枚举】是否允许宏的使用。 | EnableAll |
| 只读 | 【布尔】以只读模式打开指定的工作簿。默认情况下,未选中此复选框。如若勾选,可使在锁定以进行编辑或具有编辑密码的excel文件中执行数据提取操作。 | 否 |
| 可见 | 【布尔】选中后Excel文件将在前台执行操作时打开。清除后,所有操作均在后台完成。 | 是 |
| 句柄 | 【整型】填入主编辑页面句柄,可使用“查找窗口”或“用户界面探测器”工具获取句柄,具体操作可查看注意/说明。通过此句柄可以获取已打开的应用程序对象。如果设置此属性,则忽略‘工作簿路径’和‘现有工作簿’属性。此参数在2023.12.08及之后版本的 Server 中新增加的。 | 4000330 |
输入
| 名称 | 说明 | 示例 |
|---|---|---|
| 工作簿路径 | 【字符串】工作簿的完整路径,要有文件扩展名。如果工作簿路径没有文件拓展名,则会引发错误。 | 'F:\test.xlsx' |
| 现有工作簿 | 【字符串】输入表达式 | {填入变量名称} |
输出
| 名称 | 说明 | 示例 |
|---|---|---|
| 工作簿 | 【字符串】输入表达式 | {填入变量名称} |
注意/说明
1.使用 WPS 版本在2012以下时,启动方式建议使用 “WPS Excel ET”;在2012版本以上时,启动方式建议使用 “WPS Excel”。 免费版的 WPS 不向开发人员提供 com,即使用免费版 WPS 可能在使用 Excel 相关函数时报错,建议使用官网下载的专业版。
2.自动保存,如没有勾选时,所做的操作将无法保存。
3.新建文件,勾选后,如果在指定路径下找不到工作簿,则会使用在 WorkbookPath 属性字段中指定的名称创建一个新的 Excel 工作簿;取消勾选,如果在指定路径下找不到工作簿,则会引发异常,通知用户。
4.工作簿路径,直接复制过来的路径可能会出错,建议手动输入路径。(出错的现象是,会在复制过来的路径前面多出个“?”,把“?”删除即可),如下图所示:
5.使用“查找窗口”工具获取句柄时,选取的窗口句柄必须为“主编辑页面句柄”:
6.使用“用户界面探测器”工具获取句柄时,“EXCEL7” 为主编辑页面窗口类名,需选取应用程序下拉项 “EXCEL7” 的句柄信息:
7.使用“句柄”属性操作已打开的应用程序对象,组件运行后,应用程序会直接被关闭。
8.当使用 WPS 类型文件,且多个同类型窗口在同一标签页时,获取到的指定窗口“主编辑页面句柄”实际为最后打开的窗口句柄,组件运行后,同一标签页上同类型窗口会全部被关闭。
(1)多个同类型窗口在同一标签页情况如下图所示:
(2)多个同类型窗口独立显示情况如下图所示:
9.常见问题解决 (1)问题一:
描述:管理员方式启动控制台或者代理端后,使用 Excel 里 Com 相关组件操作 wps,报:无效的类字符串,ProgID: “Exce.lApplication” 问题
原因及解决:WPS 安装程序在安装的时候默认只在当前用户下安装,没有全局安装选项。可在执行报表机器上运行下面脚本可实现自动修改注册表,从而解决管理员权限下操作 wps 报无效类字符串问题。
(2)问题二:
- 描述:使用 office 报:无效的类字符串,ProgID: “Exce.lApplication” 错误。
- 原因及解决:可能是电脑自带 office,打开 office 默认路径下面的文件夹权限不够,需要分配好对应的文件夹权限。分配好 WindowsApps 文件夹权限,然后重启控制台或者代理端即可。
(3)更多相关问题解决,可参考一下几个知识库帖子:
相关函数
无
示例/演示
一、使用“文档路径”属性方法时,会新打开一个指定路径下的 Excel 应用程序并对其进行操作。 二、使用“句柄”属性方法时,可对已打开且没有具体的文件路径,只有进程和窗口的 Excel 应用程序进行操作。
示例附件
使用“工作薄路径”属性示例:
组件[Excel应用程序范围1]_20230612.db
使用“句柄”属性示例:
组件[Excel应用程序范围2]_20231212.db