将资产部署到 Orchestrator

先决条件：

• 创建一个 CSV 文件，其中包含要部署到 Orchestrator 的资产。
  CSV 文件必须包含以下列三列： name 、 type 、 value和description 。
• 运行 CLI exe （适用于 Windows）或dll （适用于 Linux）文件。
• 在下方添加 Orchestrator API 访问应用程序作用域：

  应用程序作用域	描述
  OR. 资产	在 Orchestrator 中具有资产读取和写入权限。
  OR.BackgroundTasks	在 Orchestrator 中的后台任务读取和写入权限。
  OR. 执行	在 Orchestrator 中具有执行读取和写入权限。
  OR. 文件夹	在 Orchestrator 中具有文件夹读取和写入权限。
  OR. 作业	在 Orchestrator 中具有作业读取和写入权限。
  OR. 计算机. 读取	在 Orchestrator 中具有计算机读取权限。
  或. 监控	在 Orchestrator 中具有监控读取和写入权限。
  OR.Robots.Read	Orchestrator 中的机器人具有读取权限。
  OR.设置.读取	在 Orchestrator 中具有设置读取权限。
  OR.测试集	在 Orchestrator 中具有测试集读取和写入权限。
  OR.TestSet 执行次数	在 Orchestrator 中具有测试集执行读取和写入权限。
  OR.TestSet 计划	测试集计划在 Orchestrator 中具有读取和写入权限。
  OR.Users.Read	在 Orchestrator 中具有用户读取权限。

有关 CSV 文件的详细信息，请参阅下面的示例。

name	类型	值	描述
asset_1_name	text	“我有意见”	asset_1_description
asset_2_name	整数	1	asset_2_description
asset_3_name	Bool	false	asset_3_description
asset_4_name	凭据	username:password	asset_4_description

要将资产部署到 Orchestrator：

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

   请参阅下面的参数列表。

   参数	描述
   Assets File (pos. 0)（必填项）	包含要删除的资产的 CSV 文件的名称。
   Orchestrator URL (pos.1)（必填项）	Orchestrator 实例的 URL。
   Orchestrator Tenant (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 帐户名称。 您必须将其与外部应用程序的 Application ID、Application Secret和 Application 作用域 配对。
   -I 或 --applicationID（如果使用外部应用程序身份验证，则为必填项）	外部应用程序 ID。 您必须将其与“ 应用程序帐户”、“应用程序密码”和“ 应用程序作用域”配对。
   -S 或 --applicationSecret（如果使用外部应用程序身份验证，则为必填项）	外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。
   --applicationScope（如果使用外部应用程序身份验证，则为必填项）	应用程序作用域列表，以单个空格分隔。 您必须将其与外部应用程序的 应用程序帐户、应用程序 ID和 应用程序密码 配对。
   -o 或 --organizationUnit	Orchestrator 文件夹（组织单元）的名称。 要输入子文件夹，请确保同时输入父文件夹的名称和子文件夹的名称。例如，AccountingTeam\TeamJohn。
   -l 或 --language	Orchestrator 用户界面中使用的语言。
   -y 或 --disableTelemetry	禁用遥测数据。
   --traceLevel	显示事件的跟踪。
   --identityUrl （仅 PaaS 部署需要）	身份服务器的 URL。

示例：

• asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -l en-US。
• asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -o OurOrganization。
• asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount。
• asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read"。

添加外部应用程序

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

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

   系统将打开租户级别。

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

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

   
   

   

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

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

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

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

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

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

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

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

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

11. 单击“保存”。

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

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

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