Microsoft Excel 命令

要将 Microsoft Excel® 工作簿作为链的一部分进行管理，请添加包含 Microsoft Excel 连接命令的步骤。

注意：Microsoft Excel 连接器支持启用宏的 Excel 工作簿 (XLSM) 文件，但不运行任何 VBA 宏或基于事件的宏，例如 Workbook Open、BeforeSave 或 SheetCalculate。

要启用这些命令，IT 管理员首先创建一个 Microsoft Excel 连接器。

从文件创建工作簿

要使用基于分隔符分隔值文件中的数据创建或更新 Excel 工作簿，请使用 从文件创建工作簿 命令。

请注意，根据连接器的配置方式，您有两种输出选项：

如果使用 GroundRunner，请输入 Javascript 对象表示法 (JSON) 对象。
如果使用 CloudRunner，请在链中指定其命令输出或资源。

属性

摘要信息	细节
文件	指定要在工作簿中创建为单独工作表的文件：对于基于链中输出或资源的文件，单击添加为每个文件，选择其输出或资源，然后输入其工作表的名称（最多 31 个字符）。提示：要从网络位置检索文件，请在操作链的前面部分使用 “文件实用工具 ”连接器的 “获取文件 ”命令。要将文件指定为 JSON，请选择启用变量，然后输入 JSON 或从先前命令的输出中选择 JSON 对象。将 JSON 格式化为： [ {"file":"fullPathToFile_1","name":"sheetName_1"}, {"file":"fullPathToFile_2","name":"sheetName_2"} ] 注意：要将先前命令的输出文件包含在 JSON 中，请输入该文件在 GroundRunner 处理文件夹中的完整路径。
分隔符号	选择文件中使用的分隔符。
工作簿名称	要基于这些文件创建新的工作簿，请输入一个唯一的名称以便于识别。注：如果未提供扩展名，该命令会自动创建带有 `.xlsx` 扩展名的文件。
现有工作簿	要将文件数据添加到现有工作簿而不是新工作簿中，请选择要更新的工作簿文件。任何名称输入在文件中的工作表都将被覆盖。重要提示：当对受保护的文件使用此命令时，生成的工作簿将不受保护。这意味着在处理受保护的文件时，必须手动重新添加加密。

输出

输出	输出类型
XLSX 工作簿	文件

退出代码

代码	类型	细节
0	成功	命令执行成功
1	错误	普遍失败

清单表

要创建 Excel 工作簿中所有工作表的 JSON 列表，请使用 List Sheets 命令。

属性

摘要信息	细节
工作簿文件	输入 XLS 或 XLSX 工作簿以列出其中的工作表。
密码	如果工作簿文件是受密码保护的 XLSX 工作簿，请输入其密码。

输出

输出	输出类型
Sheets JSON	文件

退出代码

代码	类型	细节
0	成功	命令执行成功
1	错误	普遍失败

工作表转 CSV

要将 Excel 工作簿工作表中的数据转换为表格文件，请使用 Worksheet to CSV 命令。

注意：工作表到 CSV 命令提取工作表中最后计算的值；不会运行任何公式计算来更新值。对于已禁用自动计算的工作表，请在运行链之前手动计算并保存值，以确保准确性。

属性

摘要信息	细节
工作簿文件	输入包含要转换为表格文件的 XLS 或 XLSX 工作簿。
密码	如果工作簿文件是受密码保护的 XLSX 工作簿，请输入其密码。
分隔符号	选择输出文件中使用的分隔符。
工作表名称	输入要转换的工作簿中的工作表名称。如需通过索引来识别工作表，请留空。
索引页	输入要转换的工作簿中工作表的索引位置，第一个工作表用 `1` 输入，最后一个工作表用 `-1` 输入。如需按名称识别工作表，请留空。
起始细胞	输入要转换的工作表数据的第一行和第一列的单元格。
结束列	在 A1 表示法中，输入要转换的数据结束的列的字母（例如 A、B 或 C，不带行号）。注意：该命令会忽略此列之后工作表中的所有数据。
最后一行	在 A1 单元格中，输入要转换的数据结束的行号（例如 10、200、3000，不带列字母）。要忽略该行，请输入 `0`。注意：该命令会忽略此行之后列中的所有数据。
使用格式化单元格值	要转换单元格的显示值而不是其原始值（例如用于日期/时间处理），请选中此框。
预览结果	要启用输出文件的预览，请选中此框。
流媒体模式	仅适用于大型 XLSX 文件。建议用于大于 20MB 的文件。分小窗口读取文件，以减少内存使用。当此设置与格式化值选项结合使用时，某些公式（特别是引用文件中较远单元格的公式）可能无法正常工作。

输出

输出	输出类型
输出 CSV 文件	文件

退出代码

代码	类型	细节
0	成功	命令执行成功
1	错误	普遍失败

支持

社区

Workiva支持中心

Microsoft Excel 命令

注意：Microsoft Excel 连接器支持启用宏的 Excel 工作簿 (XLSM) 文件，但不运行任何 VBA 宏或基于事件的宏，例如 Workbook Open、BeforeSave 或 SheetCalculate。

从文件创建工作簿

属性

提示：要从网络位置检索文件，请在操作链的前面部分使用 “文件实用工具 ”连接器的 “获取

注意：要将先前命令的输出文件包含在 JSON 中，请输入该文件在 GroundRunner 处理文件夹中的完整路径。

注：如果未提供扩展名，该命令会自动创建带有 `.xlsx` 扩展名的文件。

重要提示：当对受保护的文件使用此命令时，生成的工作簿将不受保护。这意味着在处理受保护的文件时，必须手动重新添加加密。

输出

退出代码

清单表

属性

输出

退出代码

工作表转 CSV

注意：工作表到 CSV 命令提取工作表中最后计算的值；不会运行任何公式计算来更新值。对于已禁用自动计算的工作表，请在运行链之前手动计算并保存值，以确保准确性。

属性

注意：该命令会忽略此列之后工作表中的所有数据。

注意：该命令会忽略此行之后列中的所有数据。

输出

退出代码

Workiva支持中心

Microsoft Excel 命令

注意：Microsoft Excel 连接器支持启用宏的 Excel 工作簿 (XLSM) 文件，但不运行任何 VBA 宏或基于事件的宏，例如 Workbook Open、BeforeSave 或 SheetCalculate。

从文件创建工作簿

属性

提示：要从网络位置检索文件，请在操作链 的前面部分使用 “文件实用工具 ”连接器的 “获取

注意： 要将先前命令的输出文件包含在 JSON 中，请输入该文件在 GroundRunner 处理文件夹中的完整路径。

注： 如果未提供扩展名，该命令会自动创建带有 .xlsx 扩展名的文件。

重要提示： 当对受保护的文件使用此命令时，生成的工作簿将不受保护。这意味着在处理受保护的文件时，必须手动重新添加加密。

输出

退出代码

清单表

属性

输出

退出代码

工作表转 CSV

注意：工作表到 CSV 命令提取工作表中最后计算的值；不会运行任何公式计算来更新值。对于已禁用自动计算的工作表，请在运行链之前手动计算并保存值，以确保准确性。

属性

注意： 该命令会忽略此列之后工作表中的所有数据。

注意： 该命令会忽略此行之后列中的所有数据。

输出

退出代码

提示：要从网络位置检索文件，请在操作链的前面部分使用 “文件实用工具 ”连接器的 “获取

注意：要将先前命令的输出文件包含在 JSON 中，请输入该文件在 GroundRunner 处理文件夹中的完整路径。

注：如果未提供扩展名，该命令会自动创建带有 `.xlsx` 扩展名的文件。

重要提示：当对受保护的文件使用此命令时，生成的工作簿将不受保护。这意味着在处理受保护的文件时，必须手动重新添加加密。

注意：该命令会忽略此列之后工作表中的所有数据。

注意：该命令会忽略此行之后列中的所有数据。