将包部署到 Orchestrator

先决条件：

• 创建包。
• 运行 CLI exe （适用于 Windows）或dll （适用于 Linux）文件。
• 添加所需的 Orchestrator API 访问应用程序作用域。

1. 使用uipcli package运行package任务。 您可以查看可用子任务的列表。
2. 指定所需参数并运行deploy子任务。

   请参阅下面的参数列表。

   参数	描述
   Package(s) Path (pos. 0)（必填项）	包文件的路径，或包含多个包的文件夹的路径。
   Orchestrator URL (pos. 1)（必填项）	Orchestrator 实例的 URL。
   `Orchestrator 租户 (pos.2) （必需）对于 SaaP 部署。 （可选）适用于 PaaS 部署。	要删除计算机的 Orchestrator 实例的租户。
   -u 或 --username（如果您通过用户名和密码使用基本身份验证	用于向 Orchestrator 进行身份验证的用户名。 您必须将其与相应的密码配对。
   -p 或 --password（如果您通过用户名和密码使用基本身份验证	用于对 Orchestrator 进行身份验证的密码。您必须将其与相应的用户名配对。
   -t或--token （如果使用 基于令牌的身份验证，则为必需）	用于对 Orchestrator 进行身份验证的 OAuth2 刷新令牌 。 您必须将其与 Account Name 和 Client ID配对。
   -a或--accountName （如果使用 基于令牌的身份验证，则为必需）	Orchestrator CloudRPA 帐户名称。 您必须将其与 OAuth2 刷新令牌 和 客户端 ID配对。
   -A 或 --accountForApp	Orchestrator CloudRPA 帐户名称（组织名称）。 您必须将其与外部应用程序的“应用程序 ID ”、“应用程序密码”和“应用程序作用域”配对
   -I或--applicationId （如果使用 外部应用程序身份验证，则为必需）	外部应用程序 ID。 您必须将其与“ 应用程序帐户”、“应用程序密码”和“ 应用程序作用域”配对。
   -S或--applicationSecret （如果使用 外部应用程序身份验证，则为必需）	外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。
   --applicationScope（如果使用外部应用程序身份验证，则为必填项）	应用程序作用域列表，以单个空格分隔。 您必须将其与外部应用程序的 应用程序帐户、应用程序 ID和 应用程序密码 配对。
   -c 或 --createProcess	当设置为 true时，它会在命令中传递的 Orchestrator 文件夹中创建一个流程。 其默认值为 True。 设置为 false时，它不会在 Orchestrator 文件夹中创建流程。 例如， --createProcess false.
   -e或--environments （适用于传统文件夹）	要将包部署到的环境列表，以逗号分隔。 如果环境不属于默认文件夹（组织单位），则必须在环境名称前加上文件夹名称。 例如，如果环境为 “TestEnvironment”，文件夹名称为“ AccountingTeam”，则将环境写入“ AccountingTeam\TestEnvironment”。
   -h 或 --entryPointsPath	定义用于创建或更新流程的特定入口点。这是始于项目根目录的入口点文件路径。 对于传统文件夹，只能为每个环境指定一个入口点。
   -o 或 --organizationUnit	Orchestrator 文件夹（组织单元）的名称。 要输入子文件夹，请确保同时输入父文件夹的名称和子文件夹的名称。例如，AccountingTeam/TeamJohn。
   -l 或 --language	Orchestrator 用户界面中使用的语言。
   -y 或 --disableTelemetry	禁用遥测数据。
   --traceLevel	显示事件的跟踪。
   --identityUrl （仅 PaaS 部署需要）	身份服务器的 URL。
   --help	显示此命令的参数和示例。

如果未指定入口点，则 uipcli 将创建一个具有 default 入口点的流程。如果指定了入口点，则系统将创建具有该入口点的流程，并将 _{entryPoint} 附加到流程名称。此外，与 package.Id 关联的所有流程都将更新为最新版本，无论流程是手动创建还是通过管道创建。

示例：

• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US。
• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -A myAccountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read"。
• package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US -h EntryPoint1,EntryPoint2。

添加外部应用程序

要注册外部应用程序，使其可以使用 OAuth 访问您的 UiPath 资源，请执行以下操作：

1. 以管理员身份登录租户。
2. 转到“ 租户 ” >“ 管理访问权限 ” >“ 分配角色” ，然后单击 “管理帐户和组”。

   系统将打开租户级别。

3. 在左侧，选择“ 外部应用程序”。

   “ 外部应用程序 ” 页面将打开，其中列出了为当前租户注册的所有现有外部应用程序：

   
   

   

   
   
4. 在表格上方的右侧，单击“添加应用程序”。
5. 填写“应用程序名称”字段。
6. 为“应用程序类型”选择一个选项。

   如果选择机密应用程序，您会在最后收到应用程序密码，因此请确保您的应用程序可以安全地存储该密码。如果无法访问，请选择“非机密应用程序”。

7. 在“资源”下，单击“添加作用域”。

   “编辑资源”面板会在右侧打开，您可以在其中选择应用程序应有权访问的资源。

8. 从“资源”下拉列表中，选择应用程序可以使用的 UiPath API。
   注意：您一次只能为一个资源添加作用域。如果要允许访问多个资源，请重复此过程以为每个资源添加作用域。
9. 在“用户作用域”选项卡上，根据需要选中要授予的逻辑 API 权限的复选框。

   在用户作用域内授予权限意味着外部应用程序可以在用户上下文中访问这些资源，并且具有相应权限的用户必须登录。

10. 如果这是机密应用程序，您可以切换到“应用程序作用域”选项卡，根据需要为所选资源授予应用程序级别的权限。

    借助应用程序作用域下的权限，外部应用程序可以访问选定作用域内应用程序范围内的数据，而无需用户交互。

    非机密应用程序无法访问应用程序作用域。

11. 单击“保存”。

    面板将关闭，选定的资源和范围将添加到表单中的“资源”表中。

12. 如果外部应用程序接受，则可以在“重定向 URL”字段中添加 URL，向其发送授权响应。然后，应用程序可以使用它来访问 UiPath 资源。
13. 单击“添加”以创建注册。

    系统随即会打开一条确认消息。对于机密应用程序，确认消息中包含已注册的外部应用程序可用于请求授权的应用程序密码。请务必将其保存在安全的位置，因为您无法再次查看密码。