automation-ops
LATEST
false
Automation Ops 用户指南
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 2024年10月23日

执行任务

在专为 Windows 设备设计的 UiPath CLI (UiPath.CLI.Windows) 中运行任务需要执行多个任务。

UiPath.CLI.Windows 过程与 UiPath.CLI (专为 Linux 设备设计的 UiPath CLI)过程之间的主要区别在于您可以在某些特定于您所使用的设备类型的任务中传递这些参数继续运行。

重要提示:
使用 UiPath CLI 时,必须确保已在 Studio 中关闭项目。否则会导致冲突,从而在 CLI 中显示以下错误消息:The action could not be performed because the project is already opened in another Studio instance. Please close it and try again.

API 访问应用程序作用域

下表显示了运行任何 CLI 任务所需的 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 中具有用户读取权限。

除了表中列出的作用域外,要突出显示的一个重要作用域是OR.DefaultOR.Default作用域充当通配符。 它在组织级别和文件夹级别提供特定于角色的精细访问权限。 这使您可以灵活地对应用程序权限进行精确控制,超出了预定义的组织范围权限。 有关更多详细信息,请参阅声明作用域

添加外部应用程序

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

  1. 转到“管理员”,然后选择左侧面板顶部的组织。
  2. 选择“外部应用程序”。
  3. 单击右上角的“添加应用程序”。
  4. 填写“应用程序名称”字段
  5. 为“应用程序类型”选择一个选项。

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

  6. 在“资源”下,单击“添加作用域”

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

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

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

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

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

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

  10. 单击“保存”

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

  11. 如果外部应用程序已在用户作用域中注册,则必须添加“重定向 URL”,外部应用程序应会从其中收到授权响应。

    如果选择应用程序作用域,则可选择提供重定向 URL

  12. 单击“添加”以创建注册。

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

Running UiPath.CLI.Windows

先决条件:要使用适用于 Windows 的 UiPath CLI 并执行任务,请安装 .NET 6.0.7,其中必须包含6.0.302 SDK 随附的 .NET 6.0.7 Desktop Runtime

您可以通过调用包含相应参数的uipcli.exe来执行任务。 要执行子任务,该命令需要具有以下格式: uipcli.exe <task name> <sub-task name> 。 要运行 CLI,请执行以下操作:
  1. 打开命令提示符并导航到从 NUPKG 文件中提取的文件夹。
  2. 键入uipcli.exe ,然后选择 Enter 键。

运行 UiPath.CLI

先决条件:要使用适用于跨平台的 UiPath CLI 并执行作业任务,请安装6.0.302 SDK随附的 .NET 6.0.7

您可以通过调用包含相应参数的uipcli.exe来执行任务。 要执行子任务,该命令需要具有以下格式: dotnet uipcli.dll <task name> <sub-task name> 。 要运行 CLI,请执行以下操作:
  1. 打开命令提示符并导航到从 NUPKG 文件中提取的文件夹。
  2. 输入 dotnet uipcli.dll,然后按“Enter”。

显示 CLI 版本

运行 uipcli --version 命令。

Deleting assets from Orchestrator

先决条件

  • 在 Orchestrator 中创建资产。
  • 创建一个 CSV 文件,其中包含要删除的资产。 CSV 文件必须包含以下列三列: nametypevaluetypevalue列下的数据单元格可以留空。
  • 运行 CLI exe (适用于 Windows)或dll (适用于 Linux)文件。
  • 添加所需的 Orchestrator API 访问应用程序作用域

有关 CSV 文件的更多信息,请查看下表中的示例:

name

类型

asset1_name

N/AN/A

asset2_name

Bool

true

asset3_name

整数

N/A

asset4_name

凭据

username:password

要从 Orchestrator 中删除资产,请执行以下步骤:

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

    请参阅下面的参数列表。

    参数

    描述

    -u,--username (如果使用 基本身份验证,则为必需,通过用户名和密码) 用于向 Orchestrator 进行身份验证的用户名。 您必须将其与相应的密码配对。
    -p--password(如果您通过用户名和密码使用基本身份验证 用于对 Orchestrator 进行身份验证的密码。您必须将其与相应的用户名配对。
    -t--token (如果使用 基于令牌的身份验证,则为必需) 用于对 Orchestrator 进行身份验证的 OAuth2 刷新令牌 。 您必须将其与 Account NameClient ID配对。
    -a--accountName (如果使用 基于令牌的身份验证,则为必需) Orchestrator CloudRPA 帐户名称。 您必须将其与 OAuth2 刷新令牌客户端 ID配对。
    -A--accountForApp

    Orchestrator CloudRPA 帐户名称(组织名称)。您必须将其与外部应用程序的应用程序 ID应用程序密码应用程序作用域配对。

    -I--applicationId (如果使用 外部应用程序身份验证,则为必需)

    外部应用程序 ID。您必须将其与“应用程序帐户”、“应用程序密码”和“应用程序作用域”配对。

    -S--applicationSecret (如果使用 外部应用程序身份验证,则为必需)

    外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。

    --applicationScope(如果使用外部应用程序身份验证,则为必填项

    应用程序作用域列表,以单个空格分隔。您必须将其与外部应用程序的应用程序账号应用程序 ID应用程序密码配对

    -o--organizationUnit

    Orchestrator 文件夹(组织单元)的名称。

    要输入子文件夹,请确保同时输入父文件夹的名称和子文件夹的名称。例如,AccountingTeam\TeamJohn
    -l--language

    Orchestrator 用户界面中使用的语言。

    -y--disableTelemetry

    禁用遥测数据。

    --traceLevel

    显示事件的跟踪。

    --identityUrl (仅 PaaS 部署需要)

    身份服务器的 URL。

    --help

    显示此命令的参数和示例。

    --version

    显示版本信息。

    Assets File (pos. 0)必填项包含要删除的资产的 CSV 文件的名称。
    Orchestrator URL (pos.1)必填项Orchestrator 实例的 URL。

    Orchestrator Tenant (pos.2)

    • 必需)对于 SaaP 部署。
    • 可选)适用于 PaaS 部署。
    要管理资产的 Orchestrator 实例的租户。

用法:

uipcli asset delete <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>] uipcli asset delete <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]

最小命令示例

  • UiPath CLI 资产删除“C:\userprofile\assets.csv” “https://orch-23-10-paas.cloudapp.azure.com/” "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName"--traceLevel "Information"
  • UiPath CLI 资产删除“C:\userprofile\assets.csv” “https://orch-23-10-paas.cloudapp.azure.com/” TenantName -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********"--applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/身份" -o "FolderName" --traceLevel "Information"
  • UiPath CLI 资产删除“C:\userprofile\assets.csv” "https://automation-suite.base.url.com/" TenantName -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information"
  • UiPath CLI 资产删除“C:\userprofile\assets.csv” "https://cloud.uipath.com/" TenantName -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information"

Deploying assets to Orchestrator

先决条件

  • 创建一个 CSV 文件,其中包含要部署到 Orchestrator 的资产。
    CSV 文件必须包含以下列三列: nametypevaluedescription
  • 运行 CLI exe (适用于 Windows)或dll (适用于 Linux)文件。
  • 添加所需的 Orchestrator API 访问应用程序作用域

有关 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子任务。

    请参阅下面的参数列表。

    参数

    描述

    -u--username(如果您通过用户名和密码使用基本身份验证

    用于向 Orchestrator 进行身份验证的用户名。 您必须将其与相应的密码配对。

    -p--password(如果您通过用户名和密码使用基本身份验证

    用于对 Orchestrator 进行身份验证的密码。您必须将其与相应的用户名配对。

    -t--token (如果使用 基于令牌的身份验证,则为必需)

    用于对 Orchestrator 进行身份验证的 OAuth2 刷新令牌 。 您必须将其与 Account NameClient ID配对。

    -a--accountName (如果使用 基于令牌的身份验证,则为必需)

    Orchestrator CloudRPA 帐户名称。 您必须将其与 OAuth2 刷新令牌客户端 ID配对。

    -A--accountForApp

    Orchestrator CloudRPA 帐户名称(组织名称)。您必须将其与外部应用程序的应用程序 ID应用程序密码应用程序作用域配对。

    -I--applicationId (如果使用 外部应用程序身份验证,则为必需)

    外部应用程序 ID。您必须将其与“应用程序帐户”、“应用程序密码”和“应用程序作用域”配对。

    -S--applicationSecret (如果使用 外部应用程序身份验证,则为必需)

    外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。

    --applicationScope(如果使用外部应用程序身份验证,则为必填项

    应用程序作用域列表,以单个空格分隔。您必须将其与外部应用程序的应用程序账号应用程序 ID应用程序密码配对

    -o--organizationUnit

    Orchestrator 文件夹(组织单元)的名称。

    要输入子文件夹,请确保同时输入父文件夹的名称和子文件夹的名称。例如,AccountingTeam\TeamJohn
    -l--language

    Orchestrator 用户界面中使用的语言。

    --traceLevel

    显示事件的跟踪。

    --identityUrl (仅 PaaS 部署需要)

    身份服务器的 URL。

    --help

    显示此命令的参数和示例。

    --version

    显示版本信息。

    Assets File (pos. 0)必填项包含要删除的资产的 CSV 文件的名称。
    Orchestrator URL (pos.1)必填项Orchestrator 实例的 URL。

    Orchestrator Tenant (pos.2)

    • 必需)对于 SaaP 部署。
    • 可选)适用于 PaaS 部署。
    要在其中管理资产的 Orchestrator 实例的租户。

用法:

uipcli asset deploy <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]uipcli asset deploy <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]

最小命令示例:

  • uipcli 资产部署“C:\userprofile\assets.csv” “https://orch-23-10-paas.cloudapp.azure.com/” "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName"--traceLevel "Information"
  • uipcli 资产部署“C:\userprofile\assets.csv” “https://orch-23-10-paas.cloudapp.azure.com/” "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings .Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure。 com/identity” -o "FolderName" --traceLevel "Information"
  • uipcli 资产部署“C:\userprofile\assets.csv” "https://automation-suite.base.url.com/" "TenantName"-A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********"--applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR .TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information
  • uipcli 资产部署“C:\userprofile\assets.csv” "https://cloud.uipath.com/" "TenantName"-A "organizationName"-I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********"--applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR .TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information"

在 Orchestrator 中运行作业

先决条件
  • 在 Orchestrator 中创建流程。
  • 运行 CLI exe (适用于 Windows)或dll (适用于 Linux)文件。
  • 添加所需的 Orchestrator API 访问应用程序作用域

要在 Orchestrator 中运行作业,请执行以下步骤:

  1. 使用 uipcli job 运行 job 任务。现在,您可以看到可用子任务的列表。
  2. 指定所需参数并运行run子任务。
    请参阅下面的参数列表。
    参数描述
    -i--input_path (仅当工作流的入口点具有输入参数时才需要与要运行的流程对应的 JSON 输入文件的完整路径。

    JSON 文件格式示例:

    {
      "StringArgument_In": "MyConfigurationValue",
      "IntArgument_In": 1,
      "DictionaryArgument_In": {
        "Key1": "Value1",
        "Key2": "Value2"
      }
    }{
      "StringArgument_In": "MyConfigurationValue",
      "IntArgument_In": 1,
      "DictionaryArgument_In": {
        "Key1": "Value1",
        "Key2": "Value2"
      }
    }
    -P--priority要运行作业的优先级:- 低。- 正常(默认)。- 高。
    -r--robots特定机器人名称的列表,以逗号分隔。
    -j--jobscount要运行流程的次数。 流程运行的默认次数为 1。
    -U--user用户名。此用户不可为计算机用户或 Orchestrator 用户。对于本地用户,用户名格式应为“计算机名称\\UserN用户名”。
    -M--machine要在其上运行流程的计算机的名称。
    -R--result_path要存储作业结果的 JSON 文件或文件夹的完整路径。 结果以 JSON 文件形式返回。
    -W--timeout作业执行的超时 (秒)。 默认值为 1800 秒。
    -f--fail_when_job_fails当一个作业失败时,该命令将失败,默认值为 True
    -w--wait该命令等待作业完成。 默认值为 True
    -b--job_type (仅适用于新式文件夹) 作业的运行时类型。 您可以选择:- Unattended - NonProduction
    -u--username(如果您通过用户名和密码使用基本身份验证 用于向 Orchestrator 进行身份验证的用户名。 您必须将其与相应的密码配对。
    -p--password(如果您通过用户名和密码使用基本身份验证 用于对 Orchestrator 进行身份验证的密码。您必须将其与相应的用户名配对。
    -t--token (如果使用 基于令牌的身份验证,则为必需) 用于对 Orchestrator 进行身份验证的 OAuth2 刷新令牌 。 您必须将其与 Account NameClient ID配对。
    -a--accountName (如果使用 基于令牌的身份验证,则为必需) Orchestrator CloudRPA 帐户名称。 您必须将其与 OAuth2 刷新令牌客户端 ID配对。
    -A--accountForAppOrchestrator CloudRPA 帐户名称(组织名称)。 您必须将其与外部应用程序的“应用程序 ID ”、“应用程序密码”和“应用程序作用域”配对。
    -I--applicationId(如果使用外部应用程序身份验证,则为必填项外部应用程序 ID。您必须将其与“应用程序帐户”、“应用程序密码”和“应用程序作用域”配对。
    -S--applicationSecret(如果使用外部应用程序身份验证,则为必填项外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。
    --applicationScope(如果使用外部应用程序身份验证,则为必填项应用程序作用域列表,以单个空格分隔。您必须将其与外部应用程序的应用程序账号应用程序 ID应用程序密码配对
    -o--organizationUnitOrchestrator 文件夹(组织单元)的名称。
    要输入子文件夹,请确保同时输入父文件夹的名称和子文件夹的名称。例如,AccountingTeam\TeamJohn
    -l, --language

    Orchestrator 语言。

    -y, --disableTelemetry
    禁用遥测数据。

    --traceLevel

    显示事件的跟踪。
    --identityUrl (仅适用于PaaS部署)

    身份服务器的 URL。

    Process Name (pos.0)必填项要运行的流程的名称。
    Orchestrator URL (pos.1)必填项Orchestrator 实例的 URL。
    Orchestrator Tenant (pos.2)
    • 必需)对于 SaaP 部署。

    • 可选)适用于 PaaS 部署。

    要在其中运行流程的 Orchestrator 实例的租户。

用法:

uipcli job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <Low|Normal|High>] [-r <robots>] [-f <false|true>] [-W <timeout>] [-w <false|true>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--user <machine_user> --machine <machine_host_name>] [--job_type <Unattended|NonProduction>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]uipcli job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <Low|Normal|High>] [-r <robots>] [-f <false|true>] [-W <timeout>] [-w <false|true>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--user <machine_user> --machine <machine_host_name>] [--job_type <Unattended|NonProduction>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

最小命令示例:

  • uipcli job run ProcessName "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"

  • uipcli job run ProcessName "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel "Information"

  • uipcli job run ProcessName "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information"

  • UiPath CLI 作业运行流程名称“https://cloud.uipath.com/” "TenantName"-A "organizationName"-I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********"--applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR .TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information"

Analyzing a project

先决条件

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

要分析项目,请执行以下步骤:

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

    请参阅下面的参数列表。

备注:

UiPath CLI 的“打包”或“分析”任务不执行项目验证。

图例:(*) - 可选,建议在使用其他包订阅源时使用。

参数

描述

--analyzerTraceLevel

选择分析后要输出的消息类型:

  • 关闭 = 不显示任何消息
  • 错误

    -警告

    -信息

    -详细

-stopOnRuleViolation

违反任何规则时,作业将失败。

--treatWarningsAsErrors

将警告视为错误。

--resultPath

要存储结果的 JSON 文件的完整路径。

如果不将其添加为参数,则结果将仅在标准控制台中打印。

--governanceFilePath

传递包含工作流分析器规则的监管策略。 可以从Automation Ops 监管下载策略,也可以从Studio导出的压缩 zip 文件中提取策略。

备注:

如果您指定使用策略,但策略文件不在上述路径中,则任务将失败。

--ignoredRules

要在分析期间忽略的规则列表,以逗号分隔。

-u--orchestratorUsername (*)

(如果您通过用户名和密码使用基本身份验证,则为必填项)

用于向 Orchestrator 进行身份验证的用户名。 您必须将其与相应的密码配对。

-p--orchestratorPassword (*)

(如果您通过用户名和密码使用基本身份验证,则为必填项)

用于对 Orchestrator 进行身份验证的密码。您必须将其与相应的用户名配对。

-t-orchestratorAuthToken (*)

(如果您使用基于令牌的身份验证,则为必填项

用于对 Orchestrator 进行身份验证的 OAuth2 刷新令牌 。 您必须将其与 Account NameClient ID配对。

-a--orchestratorAccountName (*)

(如果您使用基于令牌的身份验证,则为必填项

Orchestrator CloudRPA 帐户名称。 您必须将其与 OAuth2 刷新令牌客户端 ID配对。

-A--orchestratorAccountForApp (*)

Orchestrator CloudRPA 帐户名称(组织名称)。您必须将其与外部应用程序的应用程序 ID应用程序密码应用程序作用域配对。

-I--orchestratorApplicationId (*)

(如果使用外部应用程序身份验证,则为必填项

外部应用程序 ID。您必须将其与**“应用程序帐户”、“应用程序密码”和“应用程序作用域。

-S--orchestratorApplicationSecret (*)

(如果使用外部应用程序身份验证,则为必填项

外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。

--orchestratorApplicationScope (*)

(如果使用外部应用程序身份验证,则为必填项

应用程序作用域列表,以单个空格分隔。您必须将其与外部应用程序的应用程序账号应用程序 ID应用程序密码配对

--orchestratorFolder (*)

目标 Orchestrator 文件夹的名称。

要输入子文件夹,请确保同时输入父文件夹的名称和子文件夹的名称。例如,AccountingTeam\TeamJohn
--orchestratorUrl (*)

Orchestrator 实例的 URL。

--orchestratorTenant (*)

要删除计算机的 Orchestrator 实例的租户。

-l, --language

Orchestrator 语言。

--traceLevel

显示事件的跟踪。

-identityUrl (仅 PaaS 部署需要身份服务器的 URL。

--disableBuiltInNugetFeeds

禁用内置 NuGet 订阅源。

Project(s) Path (pos.0) (必填) project.json文件的路径,或包含多个project.json文件的文件夹的路径。

用法:

uipcli package analyze <project_path> [--analyzerTraceLevel <analyzer_trace_level>] [--stopOnRuleViolation] [--treatWarningsAsErrors] [--resultPath <result_path>] [--governanceFilePath <governance_file_path>] [--ignoredRules <rule_id_1,rule_id_2>] [--orchestratorUrl <orchestrator_url> --orchestratorTenant <orchestrator_tenant>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --orchestratorApplicationScope <application_scope>] [--orchestratorFolder <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>] [--disableBuiltInNugetFeeds] uipcli package analyze <project_path> [--analyzerTraceLevel <analyzer_trace_level>] [--stopOnRuleViolation] [--treatWarningsAsErrors] [--resultPath <result_path>] [--governanceFilePath <governance_file_path>] [--ignoredRules <rule_id_1,rule_id_2>] [--orchestratorUrl <orchestrator_url> --orchestratorTenant <orchestrator_tenant>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --orchestratorApplicationScope <application_scope>] [--orchestratorFolder <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>] [--disableBuiltInNugetFeeds]

最小命令示例:

  • uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json"

  • uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --orchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"

  • uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --orchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --orchestratorFolder "FolderName" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"

  • uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://automation-suite.base.url.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --orchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --orchestratorFolder "FolderName"

  • uipcli package analyze "C:\userprofile\AutomationProject\project.json" --traceLevel Information --resultPath "C:\userprofile\result.json" --orchestratorUrl "https://cloud.uipath.com/" --orchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --orchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --orchestratorFolder "FolderName"

Deploying a package to Orchestrator

先决条件

要将包部署到 Orchestrator,请执行以下步骤:

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

    请参阅下面的参数列表。

    参数

    描述

    -c--createProcess

    的默认值为true

    当设置为true时,它会在 Orchestrator 文件夹中创建一个在命令中传递的流程。
    设置为 false时,它不会在 Orchestrator 文件夹中创建流程。 例如, --createProcess false.

    --processNames

    (可选)提供一个 .csv 为要创建/更新的流程添加自定义名称。

    以下示例说明如何将 .csv 文件 结构必须如下所示: 列名称/标头:包名称入口点名称和流程名称为必填项!

    PackageNameEntryPointName流程名称

    我的包

    Main.xaml

    我的流程

    另一个包

    自定义入口点.xaml

    另一个流程

    --processName

    (可选)为要更新/创建的流程提供自定义名称。

    -e--environments (适用于传统文件夹)

    要将包部署到的环境列表,以逗号分隔。

    如果环境不属于默认文件夹(组织单位),则必须在环境名称前加上文件夹名称。 例如,如果环境为 “TestEnvironment”,文件夹名称为“ AccountingTeam”,则将环境写入“ AccountingTeam\TestEnvironment”

    -h--entryPointsPath

    定义用于创建或更新流程的特定入口点。这是始于项目根目录的入口点文件路径。

    对于传统文件夹,只能为每个环境指定一个入口点。

    -u--username(如果您通过用户名和密码使用基本身份验证

    用于向 Orchestrator 进行身份验证的用户名。 您必须将其与相应的密码配对。

    -p--password(如果您通过用户名和密码使用基本身份验证

    用于对 Orchestrator 进行身份验证的密码。您必须将其与相应的用户名配对。

    -t--token (如果使用 基于令牌的身份验证,则为必需)

    用于对 Orchestrator 进行身份验证的 OAuth2 刷新令牌 。 您必须将其与 Account NameClient ID配对。

    -a--accountName (如果使用 基于令牌的身份验证,则为必需)

    Orchestrator CloudRPA 帐户名称。 您必须将其与 OAuth2 刷新令牌客户端 ID配对。

    -A--accountForApp

    Orchestrator CloudRPA 帐户名称(组织名称)。 您必须将其与外部应用程序的“应用程序 ID ”、“应用程序密码”和“应用程序作用域”配对

    -I--applicationId (如果使用 外部应用程序身份验证,则为必需)

    外部应用程序 ID。 您必须将其与“ 应用程序帐户”、“应用程序密码”和“ 应用程序作用域”配对。

    -S--applicationSecret (如果使用 外部应用程序身份验证,则为必需)

    外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。

    --applicationScope(如果使用外部应用程序身份验证,则为必填项

    应用程序作用域列表,以单个空格分隔。 您必须将其与外部应用程序的 应用程序帐户应用程序 ID应用程序密码 配对。

    -o--organizationUnit

    Orchestrator 文件夹(组织单元)的名称。

    要输入子文件夹,请确保同时输入父文件夹的名称和子文件夹的名称。例如,AccountingTeam/TeamJohn
    -l--language

    Orchestrator 用户界面中使用的语言。

    -y--disableTelemetry

    禁用遥测数据。

    --traceLevel

    显示事件的跟踪。

    --identityUrl (仅 PaaS 部署需要)

    身份服务器的 URL。

    Package(s) Path (pos. 0)必填项包文件的路径,或包含多个包的文件夹的路径。
    Orchestrator URL (pos. 1)必填项
    Orchestrator 实例的 URL。

    Orchestrator 租户 (pos.2)

    • 必需)对于 SaaP 部署。
    • 可选)适用于 PaaS 部署。
    要删除计算机的 Orchestrator 实例的租户。
如果未指定入口点,则 uipcli 将创建一个具有 default 入口点的流程。如果指定了入口点,则系统将创建具有该入口点的流程,并将 _{entryPoint} 附加到流程名称。此外,与 package.Id 关联的所有流程都将更新为最新版本,无论流程是手动创建还是通过管道创建。

用法:

uipcli package deploy <packages_path> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-c <false|true>] [-e <environment_list>] [-l <language>] [--ignoreLibraryDeployConflict] [--entryPointsPath <entry_points_path_list>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]uipcli package deploy <packages_path> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-c <false|true>] [-e <environment_list>] [-l <language>] [--ignoreLibraryDeployConflict] [--entryPointsPath <entry_points_path_list>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

最小命令示例

  • uipcli package deploy "C:\userprofile\AutomationPackages" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"

  • uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"n

  • uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml"

  • uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information --processNames "C:\userprofile\processNames.csv"

  • uipcli package deploy "C:\userprofile\AutomationPackage.1.0.171447983.nupkg" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information --entryPointsPath "Main.xaml" --processName "MyProcessName"

Packing projects into a package

先决条件

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

要将项目打包到包中,请执行以下步骤:

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

    请参阅下面的参数列表。

备注:

UiPath CLI 的“打包”或“分析”任务不执行项目验证。

图例:(*) - 可选,仅当您在 Orchestrator 中具有库的依赖项时才有用。

参数

描述

-o--output必填项

要在其中打包项目的目标 Orchestrator 文件夹。

-v--version

设置包版本。

--autoVersion

自动生成包版本。

--outputType

强制输出为指定的类型。

--splitOutput

启用到运行时库和设计库的输出拆分。

--repositoryUrl

项目进行版本控制时所在的存储库 URL。

--repositoryCommit

从中提交构建项目的存储库。

--repositoryBranch

从中构建项目的存储库分支。

--repositoryType

VCS 系统存储库类型。

--projectUrl

Automation Hub 概念 URL。

--releaseNotes

添加发行说明。

-u--libraryOrchestratorUsername (*)

(如果您通过用户名和密码使用基本身份验证,则为必填项)

用于向 Orchestrator 进行身份验证的用户名。 您必须将其与相应的密码配对。

如果您的包引用 Orchestrator 订阅源中的库,则这是必需的

-p--libraryOrchestratorPassword (*)

(如果您通过用户名和密码使用基本身份验证,则为必填项)

用于对 Orchestrator 进行身份验证的密码。您必须将其与相应的用户名配对。

如果您的包引用 Orchestrator 订阅源中的库,则这是必需的

-t--libraryOrchestratorAuthToken (*)

(如果您使用基于令牌的身份验证,则为必填项

用于对 Orchestrator 进行身份验证的 OAuth2 刷新令牌 。 您必须将其与 Account NameClient ID配对。

如果您的包引用 Orchestrator 订阅源中的库,则这是必需的

-a--libraryOrchestratorAccountName (*)

(如果您使用基于令牌的身份验证,则为必填项

Orchestrator CloudRPA 帐户名称。 您必须将其与 OAuth2 刷新令牌客户端 ID配对。

如果您的包引用 Orchestrator 订阅源中的库,则这是必需的

-A--libraryOrchestratorAccountForApp (*)

Orchestrator CloudRPA 帐户名称(组织名称)。您必须将其与外部应用程序的应用程序 ID应用程序密码应用程序作用域配对

如果包从 Orchestrator 订阅源引用库,则这是必需的。

-I--libraryOrchestratorApplicationId (*)

(如果使用外部应用程序身份验证,则为必填项

外部应用程序 ID。您必须将其与“应用程序帐户”、“应用程序密码”和“应用程序作用域”配对。

如果包从 Orchestrator 订阅源引用库,则这是必需的。

-S--libraryOrchestratorApplicationSecret (*)

(如果使用外部应用程序身份验证,则为必填项

外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。

如果包从 Orchestrator 订阅源引用库,则这是必需的。

--libraryOrchestratorApplicationScope (*)

(如果使用外部应用程序身份验证,则为必填项

应用程序作用域列表,以单个空格分隔。您必须将其与外部应用程序的应用程序账号应用程序 ID应用程序密码配对

如果包从 Orchestrator 订阅源引用库,则这是必需的。

--libraryOrchestratorFolder (*)

目标 Orchestrator 文件夹的名称。

要输入子文件夹,请确保同时输入父文件夹的名称和子文件夹的名称。例如,AccountingTeam\TeamJohn
--libraryOrchestratorUrl (*)

Orchestrator 实例的 URL。

--libraryOrchestratorTenant (*)

要删除计算机的 Orchestrator 实例的租户。

--libraryIdentityUrl(仅适用 PaaS 部署 )
身份服务器的 URL。

--traceLevel

显示事件的跟踪。

-l--language

Orchestrator 用户界面中使用的语言。

--disableBuiltInNugetFeeds

禁用内置 NuGet 订阅源。

Project(s) Path (pos. 0) (必填) project.json文件或包含project.json文件的文件夹的路径。

用法:

uipcli package pack <project_path> -o <destination_folder> [-v <version>] [--autoVersion] [--outputType <Process|Library|Tests|Objects>] [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--splitOutput] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]uipcli package pack <project_path> -o <destination_folder> [-v <version>] [--autoVersion] [--outputType <Process|Library|Tests|Objects>] [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--splitOutput] [--repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]

示例:

  • uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output"

  • uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"

  • uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName" --libraryIdentityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"

  • uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://automation-suite.base.url.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"

  • uipcli package pack "C:\userprofile\AutomationProject\project.json" --traceLevel Information -o "C:\userprofile\Packages\Output" --libraryOrchestratorUrl "https://cloud.uipath.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"

测试包或运行测试集

先决条件

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

要测试包,请执行以下步骤:

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

    请参阅下面的参数列表。

    参数

    描述

    -P--project-path要测试的测试包文件的路径。
    -s--testset

    要执行的测试集的显示名称。 确保测试集包含最新版本的测试用例。如果测试集不在默认文件夹中,请确保在其前面添加相关文件夹名称。 例如,使用“AccountingTeam\TestSet”。

    --out结果文件 <junit|uipath> 的类型。
    -r--result_path要存储结果的文件的目标路径。
    -e--environment (传统文件夹为必需要部署包的环境。 您必须将其与project path配对。
    -w--timeout要等待测试集执行的时间(以秒为单位)。 默认值为 7200 秒
    -i--input_path (如果入口点工作流具有要通过命令行传递的输入参数,则为必需json 输入文件的完整路径。
    --attachRobotLogs附加每个已执行测试用例的机器人日志和 JUnit 测试报告。

    --repositoryUrl

    项目进行版本控制时所在的存储库 URL。

    --repositoryCommit

    从中提交构建项目的存储库。

    --repositoryBranch

    从中构建项目的存储库分支。

    --repositoryType

    VCS 系统存储库类型。

    --projectUrl

    Automation Hub 概念 URL。

    --releaseNotes添加发行说明。
    --disableBuiltInNugetFeeds禁用内置 NuGet 订阅源。

    --retryCount

    失败的测试用例的重试次数(默认情况下,未设置重试次数)。

    -u--username(如果您通过用户名和密码使用基本身份验证

    用于向 Orchestrator 进行身份验证的用户名。 您必须将其与相应的密码配对。

    -p--password(如果您通过用户名和密码使用基本身份验证

    用于对 Orchestrator 进行身份验证的密码。您必须将其与相应的用户名配对。

    -t--token (如果使用 基于令牌的身份验证,则为必需)

    用于对 Orchestrator 进行身份验证的 OAuth2 刷新令牌 。 您必须将其与 Account NameClient ID配对。

    -a--accountName (如果使用 基于令牌的身份验证,则为必需)

    Orchestrator CloudRPA 帐户名称。 您必须将其与 OAuth2 刷新令牌客户端 ID配对。

    -A, --accountForApp

    Orchestrator CloudRPA 帐户名称(组织名称)。您必须将其与外部应用程序的应用程序 ID应用程序密码应用程序作用域配对。

    -I--applicationId (如果使用 外部应用程序身份验证,则为必需)

    外部应用程序 ID。您必须将其与“应用程序帐户”、“应用程序密码”和“应用程序作用域”配对。

    -S--applicationSecret (如果使用 外部应用程序身份验证,则为必需)

    外部应用程序密码。您必须将其与“应用程序帐户”、“应用程序 ID”和“应用程序作用域”配对。

    --applicationScope(如果使用外部应用程序身份验证,则为必填项

    应用程序作用域列表,以单个空格分隔。您必须将其与外部应用程序的应用程序账号应用程序 ID应用程序密码配对

    -o--organizationUnit

    要在其中执行测试集的 Orchestrator 文件夹。

    -l--language

    Orchestrator 用户界面中使用的语言。

    --traceLevel

    显示事件的跟踪。

    --identityURL (仅 PaaS 部署需要

    身份服务器的 URL。

    Orchestrator URL (pos. 0)必填项Orchestrator 实例的 URL。

    Orchestrator Tenant (pos. 1)

    • 必需)对于 SaaP 部署。
    • 可选)适用于 PaaS 部署。
    包或测试集所在的租户。

用法:

uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

示例:

  • uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" "C:\userprofile\AutomationProjectWithTestCases\project.json"

  • uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"

  • uipcli test run "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"

  • uipcli test run "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。