- 发行说明
- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 录制
- 用户界面元素
- 选取器
- 对象存储库
- 数据抓取
- 图像与文本自动化
- Citrix 技术自动化
- RDP 自动化
- VMware Horizon 自动化
- Salesforce 自动化
- SAP 自动化
- macOS 用户界面自动化
- ScreenScrapeJavaSupport 工具
- Webdriver 协议
- 扩展程序
- 测试套件 - Studio
- 故障排除
管理活动包
Studio 使用 NuGet 订阅源来安装活动包。您可以在 Studio 中以两种方式处理这些订阅源:
- 应用程序级别 - 在“设置”>“管理来源”选项卡中配置订阅源;
- 项目级别 - 通过功能区中的“管理包”按钮配置订阅源。
若要禁用活动订阅源,必须清除其对应的复选框。启用或禁用订阅源功能同时适用于项目和应用程序级别。
Studio 中默认配置以下订阅源:
- 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
。 -
UiPath 市场 - 此公共订阅源包含在 UiPath 市场上发布的所有活动。请注意,关于包是否由 UiPath 构建并提供官方支持,请前往“包信息”选项卡中的“管理包”窗口查看。此订阅源具有以下来源:
https://gallery.uipath.com/api/v3/index.json
。请注意,UiPath 不掌控由合作伙伴或 UiPath 市场订阅源社区创建的包的取消列出。不过,UiPath 会使取消列出的包保持活跃,以确保运行时目的所需的向后兼容性。
所有 UiPath Marketplace 活动均需通过 UiPath 验证,并且必须通过 UiPath Marketplace 安全认证。
注意:Studio 升级至更高版本后,订阅源配置将会保留。
其他订阅源可以单独添加,例如:
- 公共部门 - 此订阅源专门用于公共部门 Automation Cloud,托管在美国。此订阅源具有以下来源:
https://govcloud.uipath.us/nuget/v3/_shared/libraries/index.json
。
如果未实施监管策略,则可以在“管理包”窗口中管理和配置订阅源。如果已经强制执行此类策略,并且其中包含与订阅源管理有关的限制权限,则系统将在窗口中显示一则消息。阅读有关监管的更多信息。
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
)。
有关包和库的详细信息显示在“管理包”窗口的右侧面板中,如上面的屏幕截图中所示。
选中搜索栏旁边的“包括预发行”复选框时,此复选框将显示库包的 beta 版本(如果有)。可以使用监管策略控制复选框的可见性。
如果在“管理包”窗口中看不到项目依赖项的描述,请选中“包括预发行版”框。
UiPath.UIAutomation.Activities
和 UiPath.System.Activities
包兼容 Studio v2018.3 和更高版本。
卸载包
要卸载包,请转到“项目依赖项”类别,单击不想再使用的包旁边的“卸载”按钮。 只有在您单击 “保存”之后才会删除包。
运行自动化项目时,将禁用“管理包”按钮,这意味着在执行停止之前无法安装或删除活动包。
降级软件包
不建议降级活动包。 主要原因是它可能对依赖项产生的负面影响。 在每个版本中都会精心管理不同活动包之间的依赖项。 因此,降级可能会导致不一致,甚至工作流功能障碍。 此外,新版活动包提供了旧版中可能不可用的改进特性和功能。 因此,为确保最佳性能并避免潜在的错误,建议将活动包保留为当前版本或升级到最新版本。
%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 计算机上安装包,请执行以下操作:
- 在可以访问互联网的计算机上,下载并安装 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
。
- 对于按用户安装模式,文件夹为