Excel 操作

设置 Excel 实例后，使用启动 Excel 或附加到运行 Excel 操作，您可以进一步处理 Excel 工作表。

若要从 Excel 文档中读取和提取数据，请使用从 Excel 工作表中读取操作。 您可以检索单个单元格或数据表的值。 以下示例读取单元格 A1 到 E5：

当流运行时，操作将数据存储在数据表变量中：

要将数据写入 Excel 电子表格，请使用 写入 Excel 工作表操作。 本操作可以将任何静态数据或变量写入指定单元格或 Excel 工作表中的多个单元格。

以下示例将前面提到的数据表写入单元格 A51：

数据表中的每个单元格均填充工作簿中的相应单元格。 结果是，A51 至 E55 单元格范围使用数据表的内容进行填充。

调整 Excel 工作表中的列/行大小

调整 Excel 实例活动工作表中选定列或行的大小。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
调整目标大小	不可用	列、行	Column	指定是调整列大小还是行大小
选择范围	不可用	单个、范围、所有	单行	指定是选择活动工作表中的单个列/行、列/行范围还是所有可用列/行
Column	否	文本值		列的索引号或字母。 列编号从索引 1 开始。
Start column	否	文本值		第一列的索引或字母。 列编号从索引 1 开始。
End column	否	文本值		最后一列的索引或字母。 列编号从索引 1 开始。
行	否	数值		行的索引号。 编号从 1 开始。
Start row	否	数值		索引或第一行。 编号从 1 开始。
End row	否	数值		索引或最后一行。 编号从 1 开始。
调整类型大小	不可用	自动调整、自定义大小	自动调整	指定是自动调整所选列/行的大小还是设置自定义大小
Width	否	数值		所选列的宽度
Height	否	数值		所选行的高度

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法调整列/行大小	指示调整列/行大小时出现问题

运行 Excel 宏

在 Excel 实例的文档上运行指定的宏。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
宏	否	文本值		要运行的宏。 文本应包含宏的名称，后跟任意参数（可选），所有参数均以分号分隔。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法运行宏	指示运行指定宏时出现问题

获取活动 Excel 工作表

检索 Excel 文档的活动工作表。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。

生成的变量

参数	类型​​	说明
SheetName	文本值	活动工作表的名称
SheetIndex	数值	活动工作表的索引

异常

例外	描述
无法检索活动工作表	指示检索活动工作表时出现问题

获取所有 Excel 工作表

检索 Excel 文档的所有工作表名称。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。

生成的变量

参数	类型​​	说明
SheetNames	文本值列表	所有工作表的名称

异常

例外	描述
无法检索所有工作表名称	指示检索 Excel 工作表名称时出现问题

删除 Excel 工作表

从 Excel 实例中删除特定工作表。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Delete worksheet with	不可用	索引、名称	Name	是按名称还是按索引查找工作表
Worksheet index	否	数值		要删除的工作表的索引号。 编号从 1 开始，这意味着第一个工作表的索引为 1，第二个为 2，依此类推。
Worksheet name	否	文本值		要删除的工作表的名称

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到工作表	指示找不到具有指定名称的工作表
无法删除工作表	指示删除指定工作表时出现问题

重命名 Excel 工作表

重命名 Excel 实例的特定工作表。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Rename worksheet with	不可用	索引、名称	Name	指定是按名称还是按索引查找工作表
Worksheet index	否	数值		要重命名的工作表的索引。 编号从 1 开始，这意味着第一个工作表的索引为 1，第二个为 2，依此类推。
Worksheet name	否	文本值		要重命名的工作表的名称
Worksheet new name	否	文本值		工作表的新名称

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到工作表	指示找不到具有指定名称的工作表
无法重命名工作表	指示重命名指定工作表时出现问题

复制 Excel 工作表

从 Excel 文档复制工作表并将其粘贴到相同或不同 Excel 实例的 Excel 文档中。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须在“启动 Excel”操作中指定。
复制具有以下内容的工作表	不可用	索引、名称	客户	指定是按名称还是按索引查找工作表
Worksheet index	否	数值		要复制的工作表的索引。 编号从 1 开始，这意味着第一个工作表的索引为 1，第二个为 2，依此类推。
Worksheet name	否	文本值		要复制的工作表的名称。
目标 Excel 实例	Νο	Excel 实例		目标文件的 Excel 实例。 此变量必须在“启动 Excel”操作中指定。
Worksheet new name	否	文本值		工作表的新名称
将工作表粘贴为	不可用	第一个工作表、最后一个工作表	第一个工作表	指定是在现有工作表之前还是之后添加复制的 Excel 工作表

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法复制工作表	指示在 Excel 中复制工作表时出现问题
无法复制具有此名称的工作表	表示在复制后试图设置工作表名称时出现问题

激活 Excel 工作表中的单元格

通过提供列、行和偏移量来激活 Excel 实例的活动工作表中的单元格。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Activate	不可用	绝对指定单元格、相对指定单元格	绝对指定单元格	选择是指定单元格以绝对激活，还是通过使用偏移距离（即当前激活的引用单元格与实际激活单元格之间的单元格数）相对激活。
Column	否	文本值		单元格列的数值或字母。
Direction	不可用	左、右、上、下	Left	选择偏移方向。 根据当前活动单元格的位置，选择要在哪个位置查找要激活的单元格。
Offset from active cell	否	数值		当前活动单元格与所需单元格之间的距离（以单元格为单位）。 编号从 0 开始。
行	否	数值		单元格行的数值。 编号从 1 开始。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法激活单元格	指示激活 Excel 单元格时出现问题

选择 Excel 工作表中的单元格

在 Excel 实例的活动工作表中选择一组单元格。

使用选择 Excel 工作表中的单元格操作，通过 Excel 检索单元格范围时，您有三种选择。 首先，您需要一个有效的 Excel 实例，您可以使用启动 Excel 操作并提供相应的输入来创建该实例。

• 若要通过显式提供范围的坐标来选择单元格范围，请在选择属性中选择选项单元格范围，然后通过在以下属性中输入定义其开始和结束的单元格的数字或字母来提供范围：开始列、开始行、结束列、结束行。

• 要选择相对于当前活动单元格的单元格范围，首先在选择属性中选择选项相对于活动单元格的单元格范围。 然后，通过修改属性 X 轴方向、X 轴偏移、Y 轴方向和 Y 轴偏移，根据当前活动单元格的位置以及这两个轴上活动单元格的偏移来定义 X 轴和 Y 轴的方向。

• 要使用范围名称选择单元格区域，请在属性选择中选择选项命名单元格。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
选择	不可用	绝对指定单元格、相对指定单元格	绝对指定单元格	指定是选择显式指定的单元格区域还是相对于当前活动单元格的单元格区域。
X Axis Direction	不可用	左、右	Left	X 轴偏移方向。 根据当前激活单元格的位置，沿水平轴的哪个位置查找。
Start column	否	文本值		第一列的索引或字母。
X Offset	否	数值		X 轴偏移量。
Start row	否	数值		第一行的行号。 编号从 1 开始。
End column	否	文本值		最后一列的索引或字母。
Y Axis Direction	不可用	上、下	上方	Y 轴偏移方向。 根据当前活动单元格的位置，沿垂直轴的哪个位置查找。
End row	否	数值		最后一行的行号。 编号从 1 开始。
Y Offset	否	数值		Y 轴偏移量。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法选择单元格	指示选择指定单元格时出现问题

从 Excel 工作表中获取选定的单元格区域

在由第一列、第一行、最后一列和最后一行组成的结构中检索所选单元格区域。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。

生成的变量

参数	类型​​	说明
FirstColumnIndex	数值	该区域第一列的数值
FirstRowIndex	数值	该区域第一行的数值
LastColumnIndex	数值	该区域最后一列的数值
LastRowIndex	数值	该区域最后一行的数值

异常

例外	描述
无法检索所选单元格区域	指示检索所选单元格区域时出现问题

复制 Excel 工作表中的单元格

从 Excel 实例的活动工作表中复制一组单元格。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Copy mode	不可用	单个单元格的值、一组单元格中的值、选定区域中的值	单个单元格的值	指定是复制单个单元格、一组单元格还是当前所选单元格
Start column	否	文本值		第一列的索引或字母
Start row	否	数值		第一行的索引
End column	否	文本值		最后一列的索引或字母
End row	否	数值		最后一行的索引

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法复制单元格	指示从 Excel 文档中复制单元格时出现问题

将单元格粘贴到 Excel 工作表

将一组单元格粘贴到 Excel 实例的活动工作表。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Paste mode	不可用	在指定单元格上、在当前活动的单元格上	在指定单元格上	指定是粘贴到指定单元格上还是当前活动的单元格上
Column	否	文本值		单元格列的索引或字母
行	否	数值		行号

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法粘贴单元格	指示粘贴指定单元格时出现问题

从 Excel 工作表中删除

从 Excel 实例的可用工作表中删除一个单元格或一组单元格。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Retrieve	不可用	单个单元格的值、一系列单元格的值	单个单元格的值	是否从一组单元格中删除单个单元格或某个表
Start column	否	文本值		内容为数值或字母的单元格列(单个单元格的值)或第一列
Start row	否	数值		单元格行(单个单元格的值)或第一行的行号
End column	否	文本值		内容为数值或字母的最后一列
End row	否	数值		最后一行的行号
Shift direction	不可用	向左，向上	Left	移动方向

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法删除单元格	指示删除指定单元格时出现问题

将行插入 Excel 工作表

在 Excel 实例的所选行上方插入行。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
行索引	否	数值		要在上方添加新行的行的索引。 编号从 1 开始。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到行	指示找不到具有指定索引的行
无法插入行	指示在指定的 Excel 实例中插入行时出现问题

从 Excel 工作表中删除行

从 Excel 实例中删除所选行。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Delete row	否	数值		要删除的行的索引号。 编号从 1 开始。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到行	指示找不到具有指定索引的行
无法删除行	指示删除指定行时出现问题

将列插入 Excel 工作表

在 Excel 实例的所选列的左侧插入列。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Column	否	文本值		列的索引号或字母。 新列将显示在所指示列的左侧。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到列	指示找不到具有指定名称的列
无法插入列	指示在指定的 Excel 实例中插入列时出现问题

从 Excel 工作表中删除列

从 Excel 实例中删除所选列。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Delete column	否	文本值		要删除的列的索引号或字母。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到列	指示找不到具有指定名称的列
无法删除列	指示删除指定列时出现问题

查找并替换 Excel 工作表中的单元格

查找文本并将其替换为 Excel 实例的活动工作表中的另一文本。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Search mode	不可用	查找，查找并替换	Find	要用于搜索的模式
All matches	不适用	布尔值	错误	是在找到的所有匹配单元格中还是仅在第一个匹配单元格中查找/替换文本
Text to find	否	文本值		要在工作表中查找的文本
Text to replace with	否	文本值		用于替换匹配单元格的文本
Match case	不适用	布尔值	错误	是否搜索区分大小写的数据
Match entire cell contents	不适用	布尔值	错误	是否搜索仅包含指定文本的单元格
Search by	不适用	行，列	行数	搜索文本所采用的顺序

生成的变量

参数	类型​​	说明
FoundColumnIndex	数值	找到的列的索引
FoundRowIndex	数值	找到的行的索引
Cells	数据表	与条件匹配的单元格列表

异常

例外	描述
找不到文本并且/或者无法替换文本	指示查找和/或替换指定的文本时出现问题

获取 Excel 工作表中的列上的第一个空闲行

给定活动工作表的列，检索第一个空闲行。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Column	否	文本值		用于标识列的索引或字母。 列编号从索引 1 开始。

生成的变量

参数	类型​​	说明
FirstFreeRowOnColumn	数值	给定列的第一个完全空行的数值

异常

例外	描述
无法检索第一个空闲行	指示检索 Excel 实例的第一个空闲行时出现问题

从 Excel 中读取公式

读取 Excel 中单元格内的公式。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须在“启动 Excel”操作中指定。
Retrieve	不可用	单单元格的公式、命名单元格的公式	单个单元格的公式	指定是从指定单元格还是命名单元格中检索公式
Start column	否	文本值		内容为数值或字母的单元格列(单个单元格的值)或第一列
Start row	否	数值		单元格行(单个单元格的值)或第一行的行号
客户	否	文本值		单元格的名称

生成的变量

参数	类型​​	Description
CellFormula	文本值	单个单元格的公式

异常

例外	Description
无法从单元格读取公式	指示从 Excel 中的单元格读取公式时出现问题

从 Excel 工作表中获取表范围

检索 Excel 实例的活动工作表中的表范围。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须在“启动 Excel”操作中指定。
表名	否	文本值		在 Excel 中指定表的名称。
为数据透视表	不可用	布尔值	错误	确定指定的表是否是数据透视表。

生成的变量

参数	类型​​	Description
FirstColumnIndex	数值	表的第一列的数值
FirstRowIndex	数值	表的第一行的数值
LastColumnIndex	数值	表的最后一列的数值
LastRowIndex	数值	表的最后一行的数值

异常

例外	Description
无法从表获取范围	指示从 Excel 中的表获取范围时出现问题

自动填充 Excel 工作表中的单元格

在 Excel 实例的活动工作表中，根据另一个范围的数据用数据自动填充某个范围。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须在“启动 Excel”操作中指定。
范围格式	不可用	指定单元格，特定范围	命名单元格	指定引用范围的方式，方法包括使用指定单元格或绝对列/行索引
源单元格名称	否	文本值		表示自动填充的源范围的名称
目标单元格名称	否	文本值		表示要自动填充的目标范围的名称。 源范围应该从同一单元格开始，并且应该包含在目标范围中
Start column	否	文本值		两个范围第一列的索引或字母
Start row	否	数值		两个范围的第一行号。 编号从 1 开始
源结束列	否	文本值		源范围最后一列的索引或字母
源结束行	否	数值		源范围的最后一个行号。 编号从 1 开始
目标结束列	否	文本值		目标范围最后一列的索引或字母
目标结束行	否	数值		目标范围的最后一个行号。 编号从 1 开始

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法自动填充单元格	指示在 Excel 中自动填充单元格时出现问题

在 Excel 工作表中追加单元格

追加 Excel 实例的活动工作表中的一组单元格。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须在“启动 Excel”操作中指定。
追加模式	不可用	到活动表，到指定单元格	到活动表	指定是追加到表还是命名单元格范围
客户	否	文本值		单元格范围的名称
第一行具有页眉	不可用	布尔值	错误	指示目标的第一行包含列标题
起始列	是	文本值		起始列号或字母，数据从目标的第一个空行开始追加。 如果该字段留空，则改为使用指定目标的第一列。
起始列标题	是	文本值		起始列的标题，从目标的第一个空行开始追加数据。 如果该字段留空，则改为使用指定目标的第一列。

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法追加单元格	指示在 Excel 中追加单元格时出现问题

Excel 工作表中的查找范围

查找并返回 Excel 的 LOOKUP 函数结果。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须在“启动 Excel”操作中指定。
查找值	否	文本值		要在指定单元格范围中查找的值。
范围格式	不可用	指定单元格，特定范围	命名单元格	指定引用范围的方式，方法包括使用指定单元格或绝对列/行索引
单元格名称	否	文本值		要搜索查找值的单元格范围的名称。
Start column	否	文本值		要搜索查找值的范围中第一列的索引或字母。
Start row	否	数值		用于搜索查找值的范围的第一行号。 编号从 1 开始。
End column	否	文本值		要搜索查找值的范围中最后一列的索引或字母。
End row	否	数值		要搜索查找值的范围的最后一个行号。 编号从 1 开始。
数组形式	不可用	布尔值	错误	LOOKUP 的数组形式在数组的第一行或第一列中查找指定的值，并从数组的最后一行或最后一列的相同位置返回一个值。 当要匹配的值位于数组的第一行或第一列时，请使用这种形式的 LOOKUP。 如果此选项保持禁用状态，则使用矢量形式的 LOOKUP，即在单行或单列范围（称为矢量）中查找值，并从第二个单行或单列范围的相同位置返回一个值。
结果源的单元格名称	是	文本值		从中返回匹配值的单元格范围的名称。
结果源的起始列	否	文本值		返回匹配值的范围中第一列的索引或字母。
结果源的起始行	否	数值		从该范围中返回匹配值的第一行号。 编号从 1 开始。
结果源的结束列	否	文本值		返回匹配值的范围中最后一列的索引或字母。
结果源的结束行	否	数值		返回匹配值范围的最后一行号。 编号从 1 开始。

生成的变量

参数	类型​​	Description
LookupResult	文本值	LOOKUP 函数返回的值

异常

例外	Description
无法查找	指示在 Excel 中查找值时出现问题

在 Excel 工作表中设置单元格颜色

在 Excel 实例的可用工作表中，用指定颜色填充所选单元格的背景。

您可以通过输入十六进制代码来定义颜色，也可以从列表中选择提供的预定义颜色名称。 选择“透明”选项会使单元格没有任何颜色填充。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须在“启动 Excel”操作中指定。
设置颜色	不可用	单个单元格、单元格范围、命名单元格	单个单元格	指定是设置单个单元格、单元格范围还是命名单元格的背景颜色。
Start column	不可以	文本值		单元格列或范围的第一列的索引或字母。
Start row	不可以	数值		单元格行或区域的第一个行号。 编号从 1 开始。
End column	不可以	文本值		最后一列的范围索引或字母。
End row	不可以	数值		该范围的最后一个行号。 编号从 1 开始。
单元格名称	不可以	文本值		表示将用指定颜色填充的范围的名称。
颜色格式	不可用	名称，十六进制值	客户	选择是按名称还是十六进制值来指定颜色。
颜色名称	不可以	文本值		选择系统定义的一种颜色。
颜色十六进制值	不可以	文本值		指定颜色的十六进制 (RGB) 值。

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法设置颜色	指示在 Excel 中设置单元格颜色时出现问题

启动 Excel

启动新的 Excel 实例或打开 Excel 文档。

输入参数

参数	可选	接受	默认值	说明
Launch Excel	不可用	使用空白文档、并打开以下文档	使用空白文档	指定是打开新的 Excel 文档，还是打开现有的文档
Document path	否	文件		要打开的现有 Excel 文档的完整路径
Make instance visible	不适用	布尔值	TRUE	指定是使 Excel 窗口可见还是将其隐藏
嵌套在新 Excel 进程下	不可用	布尔值	错误	指定 Excel 电子表格是否应在唯一的 Excel 进程下。 无法访问其他电子表格中的宏和加载项。
Password	是	直接加密的输入或文本值		Excel 文档的密码(如果该文档受密码保护)
Open as ReadOnly	不可用	布尔值	错误	指定是否以只读模式打开存储的文档
Load add-ins and macros	不适用	布尔值	假	指定是否将加载项和宏加载到新的 Excel 实例中

生成的变量

参数	类型​​	说明
ExcelInstance	Excel 实例	用于以后的 Excel 操作的特定 Excel 实例。 这使用户可以指定要访问多个 Excel 电子表格中的哪一个

异常

例外	描述
无法启动 Excel	指示启动 Excel 实例时出现问题
无法打开 Excel 文档	指示在打开指定的 Excel 文档时出现问题

附加到正在运行的 Excel

附加到已打开的 Excel 文档。

输入参数

参数	可选	接受	默认值	说明
Document name	否	文件		要附加到的 Excel 文档的名称或路径

生成的变量

参数	类型​​	说明
ExcelInstance	Excel 实例	此操作附加到的 Excel 实例，用于以后的 Excel 操作

异常

例外	描述
找不到指定的 Excel 文档	指示找不到指定的 Excel 文档
无法附加到 Excel 文档	指示附加到 Excel 文档时出现问题

从 Excel 工作表中读取

从 Excel 实例的活动工作表读取单元格或一组单元格的值。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Retrieve	不可用	单个单元格的值、单元格范围的值、选择内容中的值、工作表中的所有可用值	单个单元格的值	是否从一组单元格或整个工作表中检索单个单元格或某个表的值
Start column	否	文本值		内容为数值或字母的单元格列(单个单元格的值)或第一列
Start row	否	数值		单元格行(单个单元格的值)或第一行的行号
End column	否	文本值		内容为数值或字母的最后一列
End row	否	数值		最后一行的行号
Get cell contents as text	不适用	布尔值	错误	指定是以纯文本形式还是以最接近的匹配类型(例如，以“日期时间”表示日期，以“数字”表示数字等)检索单元格的内容
First line of range contains column names	不可用	布尔值	假	指定是否将第一行视为列名。 在这种情况下，不会将名称作为数据读入表中，以后的操作可以按列名搜索数据。

生成的变量

参数	类型​​	说明
ExcelData	常规值	单个单元格的值
ExcelData	数据表	作为 DataTable 的单元格区域的值

异常

例外	Description
无法读取单元格值	指示读取指定 Excel 单元格的值时出现问题

获取 Excel 工作表上的活动单元格

获取 Excel 文档的活动工作表中的活动单元格。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。

生成的变量

参数	类型​​	说明
ActiveCellColumnIndex	数值	活动单元格列的数值
ActiveCellRowIndex	数值	活动单元格行的数值

异常

例外	描述
无法获取活动单元格	指示获取活动的单元格时出现问题

保存 Excel

保存先前启动的 Excel 实例。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要保存的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
保存模式	不可用	保存文档、文档另存为	保存文档	如何保存此实例的文档
Document format	不适用	默认值（来自扩展名）、Excel 工作簿 (.xlsx)、Excel 工作簿宏已启用 (.xlsm)、Excel 97-2003 工作簿 (.xls)、网页（.htm、.html）、Excel 模板 (.xltx)、Excel 模板宏已启用 (.xltm)、Excel 97-2003 模板 (.xlt)、文本 (.txt)、Unicode 文本 (.txt)、文本 Macintosh (.txt)、文本 DOS (.txt)、XML 电子表格 (.xml)、Excel 95 (.xls)、CSV (.csv)、DIF (.dif)、SYLK (.slk)、Excel 加载项 (.xlam)、Excel 97-2003 加载项 (.xla)、Strict Open XML 工作簿 (.xlsx)、OpenDocument 电子表格 (.ods)、XML 数据 (.xml)、Excel 二进制工作簿 (.xlsb)	默认值(来自扩展名)	将文档另存为的格式
Document path	否	文件		将文档另存为的完整路径

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法保存 Excel 文档	指示保存 Excel 文档时出现问题

写入 Excel 工作表

将值写入 Excel 实例的单元格或一组单元格中。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Value to write	否	常规值		输入要插入的文本、数字或变量。 如果变量包含表格，它将填充右侧和下方的单元格，覆盖其他单元格数据（如果需要），列表将填充下方的单元格。
Write mode	不可用	在指定单元格上、在当前活动的单元格上	在指定单元格上	是写入指定单元格还是当前活动的单元格
Column	否	文本值		要写入的单元格的列号或字母
Row	否	数值		要写入的单元格的行。 编号从 1 开始，这意味着第一个工作表的索引为 1，第二个为 2，依此类推。

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法将值写入 Excel	指示将指定的值写入 Excel 实例时出现问题

关闭 Excel

关闭 Excel 实例。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要关闭的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Before closing Excel	不可用	不保存文档、保存文档、文档另存为	不保存文档	在关闭此实例之前是否以及如何保存该实例的文档
Document format	不适用	默认值（来自扩展名）、Excel 工作簿 (.xlsx)、Excel 工作簿宏已启用 (.xlsm)、Excel 97-2003 工作簿 (.xls)、网页（.htm、.html）、Excel 模板 (.xltx)、Excel 模板宏已启用 (.xltm)、Excel 97-2003 模板 (.xlt)、文本 (.txt)、Unicode 文本 (.txt)、文本 Macintosh (.txt)、文本 DOS (.txt)、XML 电子表格 (.xml)、Excel 95 (.xls)、CSV (.csv)、DIF (.dif)、SYLK (.slk)、Excel 加载项 (.xlam)、Excel 97-2003 加载项 (.xla)、Strict Open XML 工作簿 (.xlsx)、OpenDocument 电子表格 (.ods)、XML 数据 (.xml)、Excel 二进制工作簿 (.xlsb)	默认值(来自扩展名)	文档的格式
Document path	否	文件		文档的完整路径

生成的变量

此操作不会生成任何变量。

异常

例外	说明
无法保存 Excel 文档	指示保存 Excel 文档时出现问题
无法关闭 Excel 实例	指示关闭 Excel 实例时出现问题

设置活动 Excel 工作表

激活 Excel 实例的特定工作表。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Activate worksheet with	不可用	索引、名称	Name	指定是按名称还是按索引查找工作表
Worksheet index	否	数值		要激活的工作表的索引号。 编号从 1 开始，这意味着第一个工作表的索引为 1，第二个为 2，依此类推。
Worksheet name	否	文本值		要激活的工作表的名称

生成的变量

此操作不会生成任何变量。

异常

例外	说明
找不到工作表	指示找不到具有指定名称的工作表
无法激活工作表	指示激活指定工作表时出现问题

添加新工作表

将新工作表添加到 Excel 实例的文档中。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
New worksheet name	否	文本值		指定新工作表的名称
Add worksheet as	不适用	第一个工作表、最后一个工作表	第一个工作表	指定是在现有工作表之前还是之后添加新的 Excel 工作表

生成的变量

此操作不会生成任何变量。

异常

例外	说明
已存在同名的工作表	指示无法添加工作表，因为已存在具有相同名称的工作表
无法添加工作表	指示添加工作表时出现问题

获取 Excel 工作表中的第一个空闲列/行

检索活动工作表的第一个空闲列和/或行。 这对于将新数据添加到已经有数据的工作表中很有用。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		指定 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。

生成的变量

参数	类型​​	说明
FirstFreeColumn	数值	第一个完全为空的列的数值。 例如，如果列 F 是第一个空列，则会将其存储为“6”。
FirstFreeRow	数值	第一个完全为空的行的数值。 例如，如果行 7 是第一个空行，则会将其存储为“7”。

异常

例外	说明
无法检索第一个空闲列/行	指示检索 Excel 实例的第一个空闲列/行时出现问题

获取 Excel 工作表上的列名称

获取列的名称。

输入参数

参数	可选	接受	默认值	说明
Column number	否	数值		列号

生成的变量

参数	类型​​	说明
ColumnName	文本值	列的名称

异常

此操作不包含任何例外。

清除 Excel 工作表中的单元格

在 Excel 实例的活动工作表中清除一组单元格或一个命名单元格。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在启动 Excel操作中指定。
Clear	不可用	单元格范围、相对于活动单元格的单元格范围、命名的单元格、单个单元格	单元格区域	指定是选择显式指定的单元格区域、相对于当前活动单元格的单元格区域、命名的单元格还是单个单元格。
X Axis Direction	不可用	左、右	Left	X 轴偏移方向。 根据当前激活单元格的位置，沿水平轴的哪个位置查找。
Start column	否	文本值		第一列的索引或字母。
X Offset	否	数值		X 轴偏移量。
Start row	否	数值		第一行的行号。 编号从 1 开始。
End column	否	文本值		最后一列的索引或字母。
Y Axis Direction	不可用	上、下	上方	Y 轴偏移方向。 根据当前活动单元格的位置，沿垂直轴的哪个位置查找。
End row	否	数值		最后一行的行号。 编号从 1 开始。
Y Offset	否	数值		Y 轴偏移量。
客户	否	文本值		单元格的名称。
Column	否	文本值		列的索引或字母。
行	否	数值		行号。 从 1 开始枚举。

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法清除单元格	指示在尝试清除 Excel 实例中指定的单元格时出现问题。

对 Excel 工作表中的单元格进行排序

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
列排序位置	不可用	活动工作表，表格，范围	活动表	指定要排序的列是表格的一部分，还是指定范围（按名称或绝对坐标）的一部分，或者是常规活动工作表的一部分。
表名	否	文本值		表的名称。
范围	不可用	指定单元格，特定范围	命名单元格	使用指定单元格或绝对列和行索引指定要排序的范围。
单元格名称	否	文本值		代表范围的名称。
Start column	否	文本值		第一列的索引或字母。
Start row	否	数值		第一行的行号。 编号从 1 开始。
End column	否	文本值		最后一列的索引或字母。
End row	否	数值		最后一行的行号。 编号从 1 开始。
Sort by	是	用户定义的排序规则	不可用	要应用的排序规则。
第一行是标头	是	布尔值		指示工作表的第一行是标题。

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法对工作表中的单元格排序	表示对工作表中的单元格进行排序时出现问题。

筛选 Excel 工作表中的单元格

筛选 Excel 工作表中的单元格允许制作者在活动工作表、表格或区域中对指定列的值创建和应用筛选。 要筛选活动工作表/表格/范围中的多列，必须使用多个筛选 Excel 工作表中的单元格操作，每个操作都应用相应的筛选器。

重要提示

要在特定的活动工作表/表格/范围中应用多个筛选器，请确保使用的所有筛选 Excel 工作表中的单元格操作都针对同一个源（活动工作表/表格/范围）。

在已有/已应用筛选器的活动工作表/范围中使用筛选 Excel 工作表中的单元格时：

• 如果目标范围与先前应用的筛选器的范围相同，则应用所有筛选器。
• 如果目标范围与之前应用的筛选器的范围不一致，则会清除之前的筛选器，只应用最新的筛选器。
• 如果目标范围是表格，则应用所有筛选器。

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
筛选的列在位于	不可用	活动工作表，表格，范围	活动表	指定要筛选的列是表格的一部分，还是指定范围（按名称或绝对坐标）的一部分，或者是常规活动工作表的一部分
表名	否	文本值		表的名称。
范围	不可用	指定单元格，特定范围	命名单元格	使用指定单元格或绝对列/行索引指定要筛选的范围
单元格名称	否	文本值		表示范围的名称
Start column	否	文本值		第一列的索引或字母。
Start row	否	数值		第一行的行号。 编号从 1 开始。
End column	否	文本值		最后一列的索引或字母。
End row	否	数值		最后一行的行号。 编号从 1 开始。
要筛选的列	否	文本值		要筛选的列的名称或索引。 如果该列是表格的一部分，则使用标题名称。
要应用的筛选器	是	用户定义的过滤规则	不可用	应用于定义的列的筛选规则

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法应用工作表中单元格上的筛选器	表示对工作表中的单元格应用指定筛选器时出现问题

清除 Excel 工作表中的筛选器

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
清除以下位置中的筛选器	不可用	活动工作表，表格	活动表	指定是从整个活动工作表还是从特定表中清除筛选器。
表名	否	文本值		表的名称。
清除特定列中的筛选器	是	布尔值		清除特定列中的筛选器。
清除列中的筛选器	否	文本值		用于清除已应用的筛选器的列名称。

生成的变量

此操作不会生成任何变量。

异常

例外	Description
无法清除工作表中单元格上的筛选器	表示对工作表中的单元格应用指定筛选器时出现问题

获取空单元格

输入参数

参数	可选	接受	默认值	说明
Excel instance	否	Excel 实例		要处理的 Excel 实例。 此变量必须之前已在“启动 Excel”操作中指定。
Operation	不可用	第一个空单元格、列中的第一个空单元格、行中的第一个空单元格、所有空单元格	第一个空单元格	指定是搜索第一个空单元格、列中的第一个空单元格、行中的第一个空单元格还是特定范围内的所有空单元格。
搜索方向	不可用	按行、按列	按行	指定是按行还是按列搜索来查找特定范围内的第一个空单元格。
搜索范围	不可用	指定单元格，特定范围	命名单元格	在指定的单元格或由起始列/行和终止列/行定义的范围内搜索空单元格。
单元格名称	否	文本值		代表范围的名称。
Column	否	文本值		列。
行	否	数值		列。
Start column	否	文本值		第一列的索引或字母。
Start row	否	数值		第一行的行号。 编号从 1 开始。
End column	否	文本值		最后一列的索引或字母。
End row	否	数值		最后一行的行号。 编号从 1 开始。

生成的变量

参数	类型​​	Description
EmptyCellColumnIndex	数值	找到第一个空单元格的列的索引。
EmptyCellRowIndex	数值	找到第一个空单元格的行的索引。
EmptyCells	数据表	找到的空单元格列表。

异常

例外	Description
获取空单元格失败	表示从工作表中检索空单元格时出现问题。

已知限制

使用通过 OneDrive 或 SharePoint 同步的 Excel 文件

与 OneDrive 或 SharePoint 中同步的文件夹中包含的 Microsoft Excel 文件的交互可能会导致错误的流。 Power Automate 桌面版利用 COM 对象进行 Excel 交互。 OneDrive 和 SharePoint 与通过 COM 启动的 Excel 实例不完全兼容。

因此，当您尝试打开存储在 OneDrive 或 SharePoint 目录下的 Excel 文件时，可能会遇到找不到文件错误。 要解决此问题，请使用以下解决方法之一：

解决方法 1

• 制作相应 Excel 文件的本地副本。
• 对于桌面的 Excel 自动化操作，使用 Power Automate 修改 Excel 文件的本地副本。
• 用包含最新更改的本地副本覆盖通过 OneDrive/ Sharepoint 同步的 Excel 文件副本。

解决方法 2

备注

一般情况下，当启动 Excel 操作无法执行时，可以使用此变通方法。

• 使用运行应用程序操作打开一个新的 Excel 实例。 确保在操作之间提供足够的等待时间，允许 Excel 进程完全加载，包括任何加载项。
• 使用操作附加到 Excel 来附加到新流程。