- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 录制
- 用户界面元素
- 控制流程
- 选取器
- 对象存储库
- 数据抓取
- 图像与文本自动化
- Citrix 技术自动化
- RDP 自动化
- Salesforce 自动化
- SAP 自动化
- VMware Horizon 自动化
- 日志记录
- ScreenScrapeJavaSupport 工具
- Webdriver 协议
- 测试套件 - Studio
- 扩展程序
- 故障排除
管理活动包
Studio 使用 NuGet 订阅源来安装活动包。您可以在 Studio 中以两种方式处理这些订阅源:
- 应用程序级别 - 在“设置”>“管理来源”选项卡中配置订阅源;
- 项目级别 - 通过功能区中的“管理包”按钮配置订阅源。
若要禁用活动订阅源,必须清除其对应的复选框。启用或禁用订阅源功能同时适用于项目和应用程序级别。
Studio 中默认配置以下订阅源:
- Orchestrator 租户和 Orchestrator 主机 - 如果机器人已连接到 Orchestrator,则会默认添加这些活动订阅源,并且无法禁用它们。只有在 Orchestrator 中启用了租户库订阅源时,才可使用“Orchestrator 租户”选项。有关更多信息,请参阅 Orchestrator 指南中的活动订阅源。这些订阅源具有以下来源:
https://[Orchestrator_host]/nuget/activities
。 -
“本地”- 与 Studio 一起在本地安装的包的订阅源。此订阅源具有来源
%ProgramFiles%\UiPath\Studio\Packages
(对于为每台计算机安装)或%localappdata%\Programs\UiPath\Studio\Packages
(对于为每个用户安装)。注意:对于本地订阅源中的包,“管理包”窗口中显示的发布日期是指 Studio 安装程序的构建日期,而不是发布包的日期。 - 官方 - 官方在线 UiPath™ 订阅源,您可从中找到我们提供官方支持的活动包。此订阅源具有以下来源:
https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json
。 -
Marketplace - 此公共订阅源包含 UiPath Marketplace 上发布的所有活动。请注意,关于包是否由 UiPath 构建并提供官方支持,请前往“包信息”选项卡中的“管理包”窗口查看。此订阅源具有以下来源:
https://gallery.uipath.com/api/v3/index.json
。请注意,UiPath 不掌控由合作伙伴或 UiPath 市场订阅源社区创建的包的取消列出。不过,UiPath 会使取消列出的包保持活跃,以确保运行时目的所需的向后兼容性。
All Marketplace activities are verified by UiPath and must pass the Marketplace Security Certification.
注意:Studio 升级至更高版本后,订阅源配置将会保留。
如果未实施监管策略,则可以在“管理包”窗口中管理和配置订阅源。如果已经强制执行此类策略,并且其中包含与订阅源管理有关的限制权限,则系统将在窗口中显示一则消息。阅读有关监管的更多信息。
UiPath.settings
文件中添加自定义订阅源,而不必使用下面的方法。
可以从“管理包”窗口中启用或禁用用户定义及默认的包来源。
请注意,订阅源是当场添加的。添加订阅源后单击“关闭”或“取消”按钮不会还原更改。
如果要添加需要身份验证的自定义 NuGet 订阅源,您可以按照此处所述的步骤来操作。
NuGet.config
文件中,该文件位于以下路径:%AppData%\NuGet
。完成后,该订阅源应该会显示在“管理包”窗口中。
<packageSources>
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
<add key="FeedName" value="https://FeedSource" />
</packageSources>
<packageSourceCredentials>
<FeedName>
<add key="Username" value="YourUsername" />
<add key="Password" value="YourPassword" />
</FeedName>
</packageSourceCredentials>
<packageSources>
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
<add key="FeedName" value="https://FeedSource" />
</packageSources>
<packageSourceCredentials>
<FeedName>
<add key="Username" value="YourUsername" />
<add key="Password" value="YourPassword" />
</FeedName>
</packageSourceCredentials>
key="ClearTextPassword"
来取代 key="Password"
。
- 在“设置”类别中,单击“用户定义的包来源”部分下的任何订阅源。
- 按“删除”按钮。系统将从“所有包”类别和“用户定义的包来源”部分中删除订阅源。
- 单击“保存”以应用更改。
请注意,订阅源是当场删除的。删除默认或自定义订阅源后单击“关闭”或“取消”按钮不会还原更改。
包管理器功能使您可以下载活动包、库、框架、包装器等等,查看已经为项目安装的项目并更新,以及添加和删除自己的包。包管理器显示了每个订阅源的可用包列表和每个当前项目的依赖项列表。“管理包”窗口每次打开时都显示“项目依赖项”列表。
UiPath.Excel.Activities, UiPath.Word.Activities
) 或某一类应用程序 (UiPath.Mail.Activities, UiPath.Terminal.Activities
),或者在自动化中使用某些技术 (UiPath.OCR.Activities, UiPath.FTP.Activities
)。
有关包和库的详细信息显示在“管理包”窗口的右侧面板中,如上面的屏幕截图中所示。
The Include Prerelease checkbox next to the Search bar, displays the beta versions of library packages, if available, when selected. The visibility of the checkbox can be controlled using governance policies.
如果在“管理包”窗口中看不到项目依赖项的描述,请选中“包括预发行版”框。
UiPath.UIAutomation.Activities
and UiPath.System.Activities
packages are compatible with Studio v2018.3 and above.
卸载包
要卸载包,请转到“项目依赖项”类别,单击不想再使用的包旁边的“卸载”按钮。只有在您单击“保存”之后才会删除包。
运行自动化项目时,将禁用“管理包”按钮,这意味着在执行停止之前无法安装或删除活动包。
%userprofile%\.nuget\packages
文件夹中。您可以通过以下方式之一设置其他文件夹:
- 在安装过程中,通过在 命令行 中使用选项
PACKAGES_FOLDER
进行安装。 -
安装完成后,通过手动编辑
uipath.config
文件:- 在文本编辑器中打开
uipath.config
文件。默认情况下,该文件位于C:\Program Files\UiPath\Studio
。 - 在
packageSettings
节点中,添加packagesInstallationFolder
键,并将新文件夹的路径作为其值。 -
保存更改,如果将机器人作为服务安装,请重新启动服务。
例如,将以下代码添加到uipath.config
以将下载位置更改为C:\nuget
。<packageSettings> <add key="packagesInstallationFolder" value="C:\Nuget" /> </packageSettings>
<packageSettings> <add key="packagesInstallationFolder" value="C:\Nuget" /> </packageSettings>
- 在文本编辑器中打开
在未连接到互联网的计算机上使用 Studio 时,可以在另一台计算机上下载包,然后手动将其传输到已安装 Studio 的计算机。仅当 Orchestrator 连接不可用时,才需要执行此步骤。当 Studio 连接到 Orchestrator 时,可以从 Orchestrator 订阅源安装包。
要在离线 Studio 计算机上安装包,请执行以下操作:
- 在可以访问互联网的计算机上,下载并安装 NuGet 包资源管理器。
- 打开 NuGet 包资源管理器,然后选择“从在线订阅源打开包”。
- 在“包来源”字段中,输入要从中下载包的订阅源的 URL。官方 UiPath 包订阅源为
https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json
。 - 在订阅源中找到包并下载。
- 将 NUPKG 文件传输到 Studio 计算机中定义为 Studio 中包源的文件夹中。要将包添加到默认的本地订阅源,请将该文件复制到
%ProgramFiles%\UiPath\Studio\Packages
(对于为每台计算机安装)或%localappdata%\Programs\UiPath\Studio\Packages
(对于为每位用户安装)。
为了减小 Studio 安装程序的大小,从 2022.10 版本开始,UiPathStudio.msi 文件中不再包含多个活动包。为了方便在离线环境中工作或始终将所需包保存在本地存储中的用户,可以从 Customer Portal 下载一个 ZIP 存档文件,其中包含安装程序中不再包含的包及其依赖项,使您能够将包放在 Studio 或机器人计算机上。
该存档包含以下包的最新版本:
- UiPath.MobileAutomation.Activities
- UiPath.Terminal.Activities
- UiPath.Persistence.Activities
- UiPath.PDF.Activities
要将包添加到本地订阅源文件夹,请执行以下操作:
- 从 UiPath Customer Portal 下载 ZIP 存档。
- 将存档放在 Studio 或机器人计算机可访问的位置。
-
使用以下方法之一添加包:
- 安装过程中 - 在开始安装之前,请将存档放在 Studio MSI 安装程序所在的根文件夹中。安装程序会将包添加到本地订阅源文件夹。
- 安装后 - 默认情况下,将存档的内容解压缩到本地包文件夹:
- 对于按用户安装模式,文件夹为
%localappdata%\Programs\UiPath\Studio\Packages
。 - 对于按计算机安装模式,文件夹为
%ProgramFiles%\UiPath\Studio\Packages
。
- 对于按用户安装模式,文件夹为