UiPath Studio

UiPath Studio 指南

管理活动包

关于活动订阅源

Studio 使用 NuGet 订阅源来安装活动包。您可以在 Studio 中以两种方式处理这些订阅源:

  • application level - feeds are configured from the Settings > Manage Sources tab
  • 项目级别 - 通过功能区中的“管理包”按钮配置订阅源。

若要禁用活动订阅源,必须清除其相应复选框。启用或禁用订阅源功能适用于项目和应用程序级别。

Studio 中会默认配置以下活动订阅源:

  • Orchestrator - This activities feed is added by default if your Robot is connected to Orchestrator. For more info, see the About the Activities Feed chapter. This feed has the following source: https://[Orchestrator_host]/nuget/activities.
  • Local - The feed can be excluded when installing Studio with the .msi installer. If you choose not to install the local activities feed, the folder is still created but contains only the default activities, UiPath.UIAutomation.Activities, UiPath.System.Activities, UiPath.Excel.Activities and UiPath.Mail.Activities, together with dependencies previously set to a project. If installed, the feed has the following source: %ProgramFiles(x86)%\UiPath\Studio\Packages. Check out the list of default activities packages here.
  • Official - The official online UiPath feed, where you can find the activity packages that are officially supported by us. This feed has the following source: https://www.myget.org/F/workflow/.
  • Connect - The Connect public feed contains all the activities published on the UiPath Connect marketplace. Please note that whether or not packages are built and officially supported by UiPath is specifically stated in the Manage Packages window, Package Information tab. This feed has the following source: https://gallery.uipath.com/api/v2.
    Please be aware that UiPath has no control over the unlisting of packages created by partners or the Connect feed community. However, UiPath keeps unlisted packages active to ensure backward compatibility for runtime purposes.

Note:

Feed configuration is persisted upon upgrading to a later Studio version.

Feed management and configuration is available in the Manage Packages window if a governance policy was not enforced. If such a policy is enforced and contains restricted rights regarding feed management, then a message is displayed in the window. Read more about Governance.

添加自定义订阅源

Note:

在企业版安装中,自定义活动订阅源只能用于从该用户上的 Studio 开始的工作流中。如果从 Orchestrator 或代理(机器人托盘)在同一台计算机上开始作业,将导致机器人无法检索正确的包。为了避免这种情况,您应该在“活动订阅源”属性下的 UiPath.settings 文件中添加自定义订阅源,而不必使用下面的方法。

  1. 在“管理包”窗口中,单击“设置”。系统将显示包来源。
  1. Click on the 图像替代文本 button to add a feed to the User defined package sources category.
  2. 填写包来源的名称或 NuGet 订阅源的名称。
  3. 在“来源”字段中,键入本地驱动器文件夹路径、共享网络文件夹路径或 NuGet 订阅源 URL。
  4. 单击“添加”。新订阅源会添加到“管理包”窗口的“用户定义的包来源”和“所有包”类别中。默认情况下启用订阅源。
  5. 单击“保存”以应用所有更改。

可以从“管理包”窗口中启用或禁用用户定义及默认的包来源。

请注意,订阅源是当场添加的。添加订阅源后单击“关闭”或“取消”按钮不会还原更改。

Note:

如果自定义订阅源中包含损坏的包或当前正在编辑器中进行修改的包,“包管理器”便无法加载此订阅源中的任何包。

添加安全订阅源

如果要添加需要身份验证的自定义 NuGet 订阅源,您可以按照此处所述的步骤来操作。

您需要将 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>

请注意,在使用未加密的密码时,应当用 key="ClearTextPassword" 来取代 key="Password"

删除自定义订阅源

Note:

只有“用户定义的包来源”可以从“管理包”窗口中删除。

  1. 在“设置”类别中,单击“用户定义的包来源”部分下的任何订阅源。
  2. Press the Remove 图像替代文本 button. The feed is removed from the All Packages category and the User defined package sources section.
  3. 单击“保存”以应用更改。

请注意,订阅源是当场删除的。删除默认或自定义订阅源后单击“关闭”或“取消”按钮不会还原更改。

管理包

包管理器功能使您可以下载活动包、库、框架、包装器等等,查看已经为项目安装的项目并更新,以及添加和删除自己的包。包管理器显示了每个订阅源的可用包列表和每个当前项目的依赖项列表。“管理包”窗口每次打开时都显示“项目依赖项”列表。

活动包是一组活动,可以帮助您自动化某个应用程序 (UiPath.Excel.Activities, UiPath.Word.Activities) 或某一类应用程序 (UiPath.Mail.Activities, UiPath.Terminal.Activities),或者在自动化中使用某些技术 (UiPath.OCR.Activities, UiPath.FTP.Activities)。

有关包和库的详细信息显示在“管理包”窗口的右侧面板中,如上面的屏幕截图中所示。

Note:

由于 NuGet v3 限制的关系,“管理包”窗口中不显示活动包的发行说明。

选中搜索栏旁边的“包括预发行版”复选框时,此复选框将显示库包的 Beta 版本(如有)。
如果“管理包”窗口中未显示有关项目依赖项的说明,请勾选“包含预发行版”方框。

重要提示:

UiPath.UIAutomation.Activities and UiPath.System.Activities packages are compatible with Studio v2018.3 and above.

安装包

Note:

下载和安装活动包需要互联网连接。

  1. 在“管理包”窗口中,选择“所有包”类别。这将打开从您的订阅源收集的所有包的列表。
  1. 向下滚动列表以查找您要安装的包,或者在搜索栏中键入其名称。选中“包含预发行”方框,以在有活动包的 Beta 版本时将其包含在内。
  2. 选择一个活动包,以查看其说明、版本、依赖项、项目 URL 以及发布日期。
  3. Click on the drop-down list next to Version to pick a version of the package, and then set a Runtime Rule. To read more about runtime rules for project dependencies check the Managing Dependencies page.
  4. Click on the Install button. Alternatively, click on the 图像替代文本 icon next to the package name to mark it with the 图像替代文本 icon, making it ready for installation.
  5. The License Acceptance window displays licensing terms for each third-party package you wish to install. Click on View License to read licensing terms.
    • Click I Accept to agree with the license terms and install the packages.
    • 单击“我拒绝”,以取消安装并返回到“管理包”窗口。

Note:

Terms and conditions for UiPath packages and their dependencies are implicitly accepted when installing Studio. Read the UiPath Terms of Use and Privacy Policy.

  1. Click Save to install the packages or update the versions.

Note:

如果活动包的安装过程中路径受损,安装不会完成。建议备份并清除下列本地文件夹中的内容:%userprofile%\.nuget\packages%userprofile%\AppData\Local\UiPath\.cache

卸载包

To uninstall packages, go to the Project Dependencies category, and click the Uninstall button next to the package that you no longer want to use. The package is removed only after you click on Save.

运行自动化项目时,将禁用“管理包”按钮,这意味着在执行停止之前无法安装或删除活动包。

Updated 11 days ago



管理活动包


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.