生产力活动

上次更新日期 2026年2月24日

Excel 应用程序作用域

UiPath.Excel.Activities.ExcelApplicationScope

打开 Excel 工作簿，并为“Excel 活动”提供作用域。当该活动执行结束时，指定的工作簿和 Excel 应用程序都将关闭。如果已在“输出”>“工作簿”属性字段中提供“WorkbookApplication”变量，则在活动结束后，该电子表格亦不会关闭。如果指定文件不存在，则系统会新建一个 Excel 文件。仅当您的机器上已安装 Microsoft Excel 应用程序时，才能使用该活动。

属性

备注：

必须为字符串加上引号。
使用 Office 365 时，如果在手动打开 Excel 文件之前执行了 Excel 应用程序作用域，则该活动将在新实例中打开 Excel 文件。

常见

“显示名称”- 活动的显示名称。

文件

“编辑密码”- 编辑受密码保护的 Excel workbook 时所需的密码（如有必要）。仅支持字符串变量和字符串。
“密码”- 打开受密码保护的 Excel 工作簿时所需的密码（如有必要）。仅支持字符串和字符串变量。
“workbook 路径”- 要使用的 Excel 电子表格的完整路径。如果要使用的 Excel 文件位于项目文件夹中，则可使用其相对路径。仅支持字符串变量和字符串。

其他

“私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

选项

“如果不存在，则进行创建”- 选中后，如果在指定路径下找不到 workbook，则系统会使用“workbook 路径”属性字段中指定的名称新建一个 Excel workbook。清除后，如果在指定路径下找不到 workbook ，则系统会引发异常，并通知用户。默认情况下，该复选框处于选中状态。
“实例缓存时间” - 执行所有子活动后，Excel 流程保持活动状态的时间。默认值为 3,000 毫秒。当在循环（例如，在遍历循环活动中）中使用该活动时，或者连续使用多个“Excel 应用程序作用域”活动时，这可以防止因打开下一个文件时 Excel 流程关闭而导致的错误。如要尽快关闭 Excel，请将该值设置为 0。

备注：

处理多个文件时，如果让 UiPath 管理 Excel 流程的生命周期，则此竞争条件可能会导致错误。为防止出现这种情况，我们建议创建一个“Excel 应用程序作用域” 活动，将“Workbook”保存为变量，将所有其他“Excel 应用程序作用域” 活动置于此父级活动中，然后在所有子作用域活动中重用“WorkbookApplication”变量作为“现有Workbook” 属性的输入。这可确保只要自动化使用 Excel，Excel 就会保持运行状态。

MacroSetting - Specifies the macro level for the current Excel file. By default, EnableAll is selected. The drop-down contains three options, as follows:
- “全部启用” - 所有宏均已启用并且可以运行。
- “全部禁用”- 禁用指定 Excel 文件中的所有宏。无法运行任何宏。
- “从 Excel 设置读取” - 读取当前的 Excel 宏设置。
Read-only - Opens the specified workbook in Read-Only mode. Selecting this check box enables you to perform data extraction operations in an Excel file which is locked for editing or has an edit password. By default, this check box is not selected.
Save changes - Automatically saves the workbook on each change caused by an activity. If disabled, the changes will not be saved when the execution of the Excel Application Scope ends. By default, this checkbox is selected.
作为流程启动 - 如果为“True”，则 Excel 将作为新流程打开。
Visible - When selected, the Excel file is opened in the foreground while performing actions on it. When it is cleared, all operations are done in the background.