Studio 用户指南

上次更新日期 2023年12月20日

创建基本库

以下教程将指导您完成下列步骤：在 Studio 中创建库、发布库，以及在其他自动化项目中使用库。

创建库的做法与创建基本流程类似。二者的区别在于包用于创建可重用组件，以便在其他项目环境中使用。

本示例从 Excel 电子表格获取数据，并将所获数据附加到另一个 Excel 文件。接下来，您还将了解如下步骤：打包、将项目发布到自定义订阅源、将此包安装到其他项目以及使用包中包含的活动。

本示例使用 Excel 活动，此类活动无需计算机安装 Microsoft Excel。

我们开始吧。

启动 Studio。在“主页”的后台视图中，单击“库”以新建库项目。系统将显示“新的空白库”窗口。
为项目键入名称，此示例中使用 QuickLibrary。添加简短描述并选择位置。

注意：项目名称不能超过 128 个字符，描述不能超过 500 个字符。
单击“创建”。系统随即会在 Studio 中打开新库。

在活动面板的“系统”>“文件”>“工作簿”下，搜索读取范围活动，并将其拖放到设计器面板。
- 在“workbook 路径”字段中，添加要从中获取数据的 Excel 文件的路径。
- 在工作表名称字段中添加工作表名称。在此示例中，名称仍为默认 Sheet1。
- 在“范围”字段中，添加要读取的单元格范围。对于本示例，将此字段留空以读取所有单元格。
在读取范围活动的属性面板中，单击“数据表”旁边的字段，然后使用 Ctrl + K 键盘快捷键打开该变量字段，并添加名称 GetRange。DataTable 类变量用于存储已读单元格中的数据。
在活动面板的“系统”>“文件”>“工作簿”下，搜索附加范围活动。将其添加到“读取范围”活动下方。
- 在“workbook 路径”中，添加要附加所复制数据的文件的路径。
- 在工作表名称字段中添加工作表名称。在此示例中，名称仍为默认 Sheet。
- 在数据表字段中，添加先前创建的用于存储信息的变量 GetRange。您的项目应如下图所示。
在功能区中，单击“运行文件”或使用 Ctrl + F6 以执行工作流。系统随即会将收集到的第一个 Excel 电子表格的数据附加到另一个电子表格。此操作不会替换第二个电子表格中的已有数据。

要将此库作为可重用组件添加到其他自动化项目，您需要将其打包为 .nupkg 文件，方法是发布项目。

在 Studio 中打开库项目。
在功能区中，单击“发布”按钮。发布库窗口随即打开。
- 在“包属性”选项卡中，输入包名称。在“发行说明”字段中，添加有关库的一些详细信息。这对于跟踪每个新发布版本中对库所做的更改非常有用。
- 在“发布选项”选项卡中，选择“发布到”>“自定义”，然后在“自定义 URL”字段中添加本地文件夹的路径。例如，可以在桌面上创建 myfeed 文件夹。
单击“发布”。现已在本地文件夹中以 .nupkg 文件的形式提供该包。