StudioX 用户指南

上次更新日期 2024年11月18日

Excel 自动化

关于 Excel 自动化

StudioX 提供了与 Microsoft Excel 的深度集成，并附带了许多活动，这些活动可以自动执行您在 Excel 中执行的任务。有关安装 Excel 加载项的信息，请参阅 Studio 指南。

首先，将要作为资源自动执行的 Excel 文件添加到自动化项目中，然后在文件中添加要执行的活动。配置使用此文件的活动时，您可以直接从 StudioX 中的“加号”菜单中选择工作表、表格、指定的范围和指定的单元格。您也可以从 StudioX 无缝切换到 Excel，以指明要直接从文件中使用的数据。

将活动配置为直接从文件中选择数据时，如果您在加号菜单中单击“在 Excel 中指定”，您的电子表格将在 Excel 中打开，并且 Excel 功能区中将显示 UiPath 选项卡。选择要使用的数据，例如一个单元格或一系列单元格，然后在“UiPath”选项卡中单击“确认”，以确认选择。

注意：如果您使用的是 Microsoft Excel 2010，请不要在 Excel 文件中指定整列（例如 B:G），请一律指定有限范围（例如 B1:G100）。由于旧版 Excel 中的限制，指定整列可能会导致执行项目时出错。

您还可以在加号菜单中选择“自定义输入”选项，以手动指定要使用的 Excel 数据。使用此选项，您可以输入单元格和范围引用、表格名称或工作表名称，当您使用具有动态名称的 Excel 文件或在设计时不存在且没有模板文件可用的文件时，这将很有用。

如果要对范围中的每一行重复相同的活动，请添加“遍历 Excel 行”活动，然后添加要在其中重复的活动。

要了解如何自动化 Excel 任务，请参阅以下教程：

可以在 StudioX 中进行以下 Excel 活动：

注意：在 runtime 和设计时，有几种不同的启动和预览 Excel 文件的方式。要了解更多信息，请参阅“项目设置”。

将 Excel 文件添加到自动化中

您可以通过两种方式将 Excel 文件作为资源添加到自动化中。它们之间的主要区别是项目中的哪些活动可以访问和修改 Excel 文件中的数据：

添加“使用 Excel 文件”资源活动。使用此选项时，只能通过资源活动内部添加的活动来提取或修改文件中的数据。执行“使用 Excel 文件”内部的所有活动后，该文件将关闭。当在运行时创建文件（例如，从电子邮件附件下载或保存）时，或者如果文件需要发送到另一个位置（例如，以电子邮件附件形式上传或发送），此功能将非常有用。
将项目连接到 Excel 文件。使用此选项，该文件将添加为全局资源，这意味着项目中的所有活动都可以访问和修改该文件。仅在自动化执行完成后，才会关闭与文件的连接。这适用于文件名和位置不会更改并且文件不需要用于其他目的（例如上传或作为电子邮件附件发送）的情况。

将项目连接到 Excel 文件

要连接到 Excel 文件并将其添加为全局资源，请执行以下操作：

单击“Data Manager”面板顶部的“连接到资源”，然后选择“连接到新的 Excel 文件”。
在“管理资源”窗口中，提供以下信息，然后单击“确定”：
- 选择 Excel 文件 - 单击该字段旁边的“浏览”，然后浏览至要添加到自动化的 Excel 文件并将其选中。
- 稍后为其命名 - 输入一个名称，以引用自动化项目中的文件。
- 保存更改 - 如果要在自动化结束时保存文件，请选择此选项。否则，项目执行后，文件将返回到初始状态。默认情况下，此选项处于选中状态。
  
  禁用“保存更改”选项后，加号菜单和“Data Manager”面板中 Excel 资源条目旁边会显示“保存已关闭”消息。
- “只读” - 如果要以只读模式打开文件，请选择此选项。如果文件被锁定以进行编辑或具有编辑密码，这使您可以执行数据提取操作。默认情况下未选中此选项。

管理 Excel 资源

您可以从“Data Manager”面板管理 Excel 资源，而不管它们如何添加到自动化中。右键单击 Excel 资源，然后在上下文菜单中选择一个选项：

“打开 Excel 文件” - 在 Excel 中打开文件。
“打开 Excel 文件的位置” - 打开包含 Excel 文件的文件夹。
“编辑” - 打开“管理资源”窗口，您可以在其中编辑资源属性。
“删除” - 从项目中删除资源。

关于项目笔记本

“项目笔记本”是一个 Excel 工作簿，您可以将其用作暂存器，用于保存公式和操作数据。其目的是在项目执行期间用于计算和临时数据存储。默认情况下，完成自动化执行后，不会保存对项目笔记本所做的更改。

默认情况下，项目笔记本是一个由 StudioX 在项目文件夹中创建的名为 Project_Notebook.xlsx 的文件，该文件带有一组预定义的公式，您可以在任何自动化项目中使用这些公式。根据适用区域不同，这些公式分为几个工作表。每张工作表都包含您可以在其中添加输入数据的单元格和操作该数据的公式。这些公式易于识别，您可以直接从“加号”菜单中选择要用于自动化的指定单元格。

配置项目笔记本

在 StudioX 功能区中选择“笔记本”>“配置笔记本”。您可以配置以下设置：

笔记本文件 - 选择另一个 Excel 文件用作项目笔记本。
稍后为其命名 - 输入一个名称，活动与之交互时将使用该名称引用项目中的 Excel 文件。默认名称为 Notes。
“访问密码”- 如果适用，请输入打开文件所需的密码。
“编辑密码”- 如果适用，请输入编辑文件所需的密码。
自动保存文件 - 如果要在自动化结束时保存文件，请选择此选项。否则，项目执行后，文件将返回到初始状态。默认情况下，此选项为非选中状态。

禁用“保存更改”选项后，加号菜单和“Data Manager”面板中“项目笔记本”条目旁边会显示“保存更改：关闭”消息。
“只读” - 如果要以只读模式打开文件，请选择此选项。如果文件被锁定以进行编辑或具有编辑密码，这使您可以执行数据提取操作。默认情况下未选中此选项。

项目笔记本的公式

下面详细介绍了项目笔记本中可用的公式。要了解如何将公式添加到项目笔记本中，请参阅教程：将自己的公式添加到项目笔记本中。

日期

在单元格 B4 (Date_Input) 中输入一个基准日期（默认为今天的日期），并在单元格 B6（天）中输入一个天数（默认为 7 天），稍后将其添加到工作表的 B4 单元格中的日期。可以使用以下公式：

日期加天数 (DatePlusDays) - 返回单元格 B6 中的天数与单元格 B4 中的输入日期相加得出的日期。
日期加工作日天数 (DatePlusWorkingDays) - 返回单元格 B6 中的天数与单元格 B4 中的输入日期相加得出的日期（不含周末）。
日期格式 (YYYYMMDD) - 返回单元格 B4 中的输入日期，该日期已转换为 YYYYMMDD 格式的文本。
今天 - 返回今天的日期。
上周的日期（星期一、星期五、星期日） - 返回上周的星期一 (LastWeekMonday)、星期五 (LastWeekFriday) 和星期日 (LastWeekSunday) 的日期。
上个月的日期（第一天和最后一天） - 返回上个月的第一天 (LastMonthStartDate) 和最后一天 (LastMonthEndDate) 的日期。
本月的第一个/最后一个工作日 - 返回当月的第一个工作日 (ThisMonthFirstWorkingDay) 和最后一个工作日 (ThisMonthLastWorkingDay) 的日期。

以与语言环境无关的方式将文本转换为日期

在单元格 B18 (DateText) 中输入一个日期，其中包含在数字后插入的年、月和日的日语字符。日期转换为 MM/DD/YYYY 格式，并在单元格 B29 (ReformattedDate) 中返回。

有关如何使用“日期”表中公式的示例，请参见教程：使用文件和文件夹。

文本

在单元格 B4 (Text_Input) 中输入文本。要在单元格 B4 中搜索特定文本，请在单元格 B10（搜索）中输入要搜索的文本。要将搜索到的文本替换为另一文本，请在单元格 B11（替换）中输入替换文本。可以使用以下公式：

修剪 - 返回单元格 B4 中的文本，并删除所有多余的空格。
长度 - 返回单元格 B4 中文本的字符数。
大写字母 - 返回单元格 B4 中的文本，所有字符均转换为大写字母。
小写字母 - 返回单元格 B4 中的文本，所有字符均转换为小写字母。
结果 - 返回单元格 B4 中的文本，并通过将单元格 B10 中添加的文本替换为单元格 B11 中添加的文本加以修改。
包含 - 检查单元格 B10 中添加的文本是否出现在单元格 B4 中的文本中。如果找到该文本，则返回 TRUE，否则返回 FALSE。
名字 - 返回单元格 B4 中文本中最后一个空格字符之前的文本。
名字 - 返回单元格 B4 中文本中最后一个空格字符之后的文本。

从文本中提取值

要从单元格 B4 至单元格 F5 中添加的文本中提取特定值，请在单元格 D5 中的值左侧和/或在单元格 E5 中的值右侧添加文本。要提取多个值，请使用第 6-9 行同一列中的单元格。您可以在自动化中使用它来从遵循相同模板的文本块中提取变量值。例如，您可以从自动电子邮件通知（之前带有相同的标签）中提取发票编号和金额之类的值。

有关如何使用“文本”工作表中公式的示例，请参见教程：从自动电子邮件中提取数据并将其移至桌面应用程序。

数字

在单元格 B4 (Number_Input) 中输入一个数字。可以使用以下公式来操作该数字：

清理 (CleanNumber) - 返回在单元格 B4 中添加的数字，并删除所有换行符和不间断空格。
整数 - 返回单元格 B4 中数字的整数部分。
2 位小数 (TwoDecimals) - 返回在单元格 B4 中添加的带有 2 位小数的数字。

以与语言环境无关的方式将文本转换为数字

在单元格 B11 (NumberText_Input) 中输入一个没有组分隔符或以点 (.) 作为组分隔符并以逗号 (,) 作为十进制分隔符的数字。该数字在单元格 B15 (ReformattedNumber) 中返回，并转换为使用逗号 (,) 作为组分隔符，使用点 (.) 作为十进制分隔符。