订阅

UiPath Studio

UiPath Studio 指南

关于发布自动化项目

发布自动化项目意味着将项目文件夹存档,以便将其发送到机器人,然后执行。

默认情况下,将发布项目文件夹中的所有文件。如果要防止特定文件包含在已发布的程序包中,请在“项目”面板中右键单击该文件,然后选择“从发布中忽略”。对于库,如果将发布的库安装在项目中,则从发布中忽略工作流文件会阻止它在“活动”面板中显示为可重用组件。

您可以将自动化项目发布到 Orchestrator、自定义 NuGet 订阅源或在本地发布。发布到 Orchestrator 后,已归档的项目将显示在“包”页面上,您可以创建要分发给机器人的流程。当您将自动化流程发布到 Orchestrator 个人工作区或发布测试用例时,如果一个流程不存在,则会自动创建一个流程,并且现有流程会自动更新为最新发布的版本。

此外,自动化项目可以发布到自定义 NuGet 订阅源,如果订阅源需要身份验证,还可以使用添加 API 密钥的选项。

如果在本地发布项目,那么会要求您在本地计算机上提供与发布流程包的位置不同的路径。从这里开始,您之后可以手动将包发送给机器人,这样就可以执行包了。默认的本地发布位置是 %ProgramData%\\UiPath\\Packages

You can publish projects from Studio or from the command line. To update dependencies for multiple projects and publish them all at once, use the Project Dependencies Mass Update Tool.

从 Studio 发布项目

要发布项目,请在Studio 的“设计”选项卡功能区中选择“发布”。请注意,如果 project.json 文件位于只读位置,则无法发布自动化项目。

要发布自动化项目,请执行以下操作:

  1. 在 Studio 中,创建一个新项目。
  2. 在“设计”功能区选项卡中,单击“发布”。系统将打开“发布”窗口。请注意,窗口的标题栏会根据上下文发生变化:
    • 发布流程(发布流程时);
    • 发布库(发布库项目时);
    • 发布用户界面库项目时发布用户界面库;
    • 发布测试用例(发布测试用例时)。
    • 发布模板时发布模板
  3. 在“包属性”选项卡中:
    • 输入包名称。下拉列表最多包含您先前发布的包的 5 个最新名称。
    • 在“版本”部分,查看项目的“当前版本”,并根据需要键入“新版本”。选中“为预发行版”方框以将该版本标记为 alpha。请注意,这会自动将项目的版本方案更改为语义版本。在本地发布文件的新版本时,请确保自定义位置中并未包含使用相同拟定版本号的文件。有关项目版本的更多详细信息,请参阅关于自动化项目页面。
    • (可选)使用“项目图标”选项来定义项目的自定义图标。您可以浏览并选择一个文件,或者为大小至多 1MB 的 icojpegjpgpng 文件输入路径或公共 URL。
      项目发布后,图标显示如下:
      • 对于进程,在“进程名称”旁的“助手”中显示,以便更轻松地在进程列表中识别进程。
      • 对于模板,在“主页(Studio 后台视图)”>“模板”中的模板旁边显示。
      • 对于库,在 Studio 中“管理程序包”窗口中的程序包旁边显示。
        :information-source: 如果将本地文件用于发布到 Orchestrator 或不支持嵌入式图标的 feed 的库,则该图标在“管理程序包”中不可见,在这种情况下,请使用 URL 指定该图标。
    • 在“发行说明”文本框中,输入有关版本的详细信息以及其他相关信息。已发布项目的发行说明可在 Orchestrator 的“包”部分中查看。请注意,“发行说明”字段最多可接受 10,000 个字符。
  1. 单击“下一步”
    如果要发布模板,则下一步将打开“模板信息”选项卡(步骤 5)。否则,请继续执行步骤 6。
  2. (仅适用于模板)在“模板信息”选项卡中,提供以下信息,然后单击“下一步”
    • 名称 - 模板的名称。
    • 说明 - 模板选项卡中的模板说明。
    • 默认项目名称 - 使用此模板创建新项目时的默认项目名称。
    • 默认项目说明 - 使用此模板创建新项目时的默认说明。
  1. 在“发布选项”选项卡中,选择发布项目的位置。可用的选项取决于您要发布的项目的类型:

    • 对于流程(包括 StudioX 项目):
      • Orchestrator 租户进程 FeedOrchestrator 个人工作区 Feed,以及文件夹层次结构的 Feed(如果是具有单独包的第一级文件夹,或者如果从 Studio 状态栏的文件夹菜单中选择了该文件夹的子文件夹)。如果 Studio 已连接到 Orchestrator,则这些选项可用。仅当您的用户在 Orchestrator 中启用了个人工作区功能时,Orchestrator 个人工作区 Feed 才可用。
        如果在 Studio 中选择了“个人工作区”或来自具有单独包 Feed 的层次结构中的文件夹,则该文件夹的 Feed 是默认选项。否则,租户 Feed 是默认选项。
      • Assistant(机器人默认值)- 机器人和 Assistant 的默认包位置,C:\ProgramData\UiPath\Packages。此处发布的项目会自动显示在 Assistant 中。如果 Studio 连接到 Orchestrator,则该选项不可用。
      • 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。
    • 对于测试用例
      • 可用于流程的相同选项,但 Orchestrator 个人工作区订阅源除外。
    • 对于用户界面库
      • Orchestrator 租户库订阅源Orchestrator 共享库订阅源 - 在 Studio 连接到 Orchestrator 时可用。可用选项取决于是否已在 Orchestrator 中启用租户库订阅源。
      • 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。
    • 对于模板
      • Orchestrator 租户库订阅源Orchestrator 共享库订阅源 - 在 Studio 连接到 Orchestrator 时可用。可用选项取决于是否已在 Orchestrator 中启用租户库订阅源。
      • 本地 - 默认情况下,在本地发布模板的位置:C:\Users\User\Documents\UiPath\.templates
      • 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。

    如果要发布库,则在“库设置”下的“发布选项”选项卡中可以使用其他设置:

    • 活动根类别 - 输入类别的名称,在该类别下可重用组件将在“活动”面板中列出。
    • 包含源 - 选择此选项可将所有 .xaml 源打包在生成的程序集文件中,包括以前设为私有的工作流。这在调试工作流期间很有用。
    • 编译活动表达式 - 选择此选项可将所有活动表达式编译并打包到库中。这样可以缩短执行时间。
      :information-source: 注意:要找出导致库无法成功发布的原因,请阅读发布库时的限制
  1. 单击“下一步”进入“证书签名”选项卡,或单击“发布”以发布您的项目。
  2. (可选)在“证书签名”选项卡中,在“证书”框旁边添加本地证书路径。此外,如果需要,添加证书密码和可选的证书时间戳。有关更多详细信息,请查看“签名包”页面。

📘

Note:

目前,接受将 .pfx.p12 证书扩展程序用于为项目签名。

  1. 单击“发布”。整个项目文件夹被归档到一个 .nupkg 文件中,并上传到 Orchestrator、自定义 NuGet 订阅源或保存在本地目录中。
  2. 如果项目已成功发布,则将显示“信息”对话框,并且项目将复制到 UiPath.settings 文件中的 NuGetServerUrl 参数中设置的 NuGet 位置。

系统将显示“信息”对话框:

  • 包发布时采用的名称。
  • 包发布时采用的版本号。
  • 如果是在本地或在机器人默认位置发布项目,则其即为项目的发布位置。单击路径可转至包,除非发布位置是 Orchestrator。
  • “详情”选项中会列出已发布的项目文件的名称列表。
  • “复制到剪贴板”选项。

在发布过程中添加的信息(例如发布位置)将会保留在窗口中,以便将其用于后续针对同一类型项目执行的发布操作。每次单击“发布”时,都会创建项目的新版本,并将其发送到包订阅源。发布到安全订阅源时,可以通过机器人密钥、Orchestrator 凭据、Windows 身份验证或 API 密钥进行身份验证。

🚧

重要提示:

已发布的项目一定不能解压缩。要进行任何更改,请在 Studio 中打开最初的 .xaml 文件执行更改,然后再次发布项目。

通过命令行发布项目

您可以使用 UiPath.Studio.CommandLine.exe publish 命令发布项目。

UiPath.Studio.CommandLine.exe 位于安装文件夹中:

  • 对于 Windows 安装程序 (.msi) 版 Studio,默认路径是 C:\Program Files\UiPath\Studio\
  • 对于使用社区版安装程序(.exe)安装的 Studio,默认路径为 %LocalAppData%\UiPath\[Studio_version]\

以下参数可用于发布命令:

ArgumentDescription
-p, --project-pathThe path to the project.json to publish. The argument is mandatory.
-g, --targetWhere to publish the project:
Custom - Custom URL or local folder. Define the location using the -f, --feed argument.
Robot - Default publish location for the Robot, if not connected to Orchestrator. Not available for publishing libraries or templates.
OrchestratorTenant - Orchestrator Tenant Processes Feed (for processes and test cases) or Orchestrator Libraries Feed (for libraries and templates).
OrchestratorPersonalFolder - Orchestrator Personal Workspace Feed. Not available for publishing libraries, templates, or test cases.
OrchestratorFolderHierarchy - If a first-level folder with a separate package feed or one if its subfolders is selected from the folders menu in the Studio status bar, the feed for that folder hierarchy. Not available for publishing libraries or templates.
-f, --feedThe custom URL for publishing the project. This can also be a custom local directory, similar to the path in the Publish options tab in Studio.
-a, --api-keyThe API key for publishing the project. This argument can be used for a custom target.
-i, --iconPath to the custom icon to use for the package.
-n, --notesRelease notes that contain changes brought to the project.
-v, --new-versionThe new version for the project. If not provided, the version is automatically incremented.
-t, --timeoutSpecifies the timeout value for publishing projects. The default timeout is 30 seconds. This setting only applies for the package transfer to Orchestrator duration.
--cer-pathThe local path to the certificate for package signing.
--cer-passwordThe password for the certificate.
--timestamper-urlThe URL to the timestamper.
--incl-all-feedsNot required.
--helpView the arguments available for each command.
--versionCheck the version of UiPath.Studio.CommandLine.exe.

例如:

  • The following command publishes the Sample process to the Orchestrator Tenant Processes Feed:
    UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" publish --target OrchestratorTenant --notes "Fixed a couple of bugs."
  • The following command publishes the same process to a local folder:
    UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Fixed a couple of bugs."

For more information about the CommandLine.exe utility, see Mass Update Command Line Parameters.

Updated 11 days ago

关于发布自动化项目


建议的编辑仅限用于 API 参考页面

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