- Visão geral
- UiPath CLI
- Sobre o UiPath CLI
- Baixando o UiPath CLI
- Matriz de compatibilidade
- Executando o UiPath CLI
- Gerenciando feeds do NuGet
- Suporte do Test Manager
- Empacotando projetos em um pacote
- Assinatura de pacotes de projetos
- Análise de um projeto
- Implantação de um pacote no Orchestrator
- Executando um trabalho dentro do Orchestrator
- Teste de um pacote ou execução de um conjunto de testes
- Teste de vários pacotes
- Formato JSON dos parâmetros de entrada
- Implantação de ativos no Orchestrator
- Exclusão de ativos do Orchestrator
- Executando tarefas usando a configuração JSON
- Restaurando dependências de automação
- Solução de problemas do UiPath CLI
- Extensão do Azure DevOps
- Plug-in do Jenkins

Guia do usuário de integrações de CI/CD
Teste de um pacote ou execução de um conjunto de testes
Prerequisites:
- Crie um pacote ou um conjunto de testes.
- Execute o arquivo CLI
exe(para Windows Legacy) oudll(para Windows/Linux/macOS). - Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.
Para testar um pacote, siga as seguintes etapas:
- Execute a tarefa
test, usandouipcli test. Você pode ver uma lista das subtarefas disponíveis. - Especifique os parâmetros necessários e execute a subtarefa
run. A tabela a seguir descreve os parâmetros necessários:
| Parâmetro | Description |
|---|---|
-P , or --project-path | O caminho para o arquivo do pacote Testing que você deseja testar. |
-s , or --testset | The name shown for the Test Set you wish to execute. Ensure that the Test Set includes the most recent version of the Test Cases. If the project does not have a default folder set, make sure you assign a test folder at the Test Set level. |
--out | O tipo do arquivo de resultado \<junit|uipath\>. |
-r , or --result_path | O caminho de destino do arquivo onde você deseja armazenar os resultados. |
-e ou --environment ( necessário para pastas clássicas) | O ambiente em que você deseja implantar o pacote. Você deve combiná-lo com o project path . |
-w , or --timeout | O tempo (em segundos) que você quer esperar para o Conjunto de teste ser executado. O valor padrão é de 7200 segundos . |
-i ou --input_path ( obrigatório se o fluxo de trabalho do entry-point tiver parâmetros de entrada que você deseja passar por meio da linha de comando) | O caminho completo para um arquivo de entrada JSON. Consulte Formato JSON dos Parâmetros de Entrada para obter detalhes sobre a estrutura do arquivo. |
--attachRobotLogs | Anexa logs do robô para cada caso de teste executado e um relatório de teste JUnit. |
|
| A URL do repositório onde o projeto é versionado. |
|
| A confirmação do repositório de onde o projeto foi criado. |
|
| A ramificação do repositório de onde o projeto foi criado. |
|
| Tipo de repositório do sistema VCS. |
|
| URL da ideia do Automation Hub. |
--releaseNotes | Adicione notas da versão. |
--nugetConfigFilePath | Caminho para o arquivo NuGet.Config que contém os feeds. A tag <clear /> do arquivo especificado será ignorada e apenas as origens serão consideradas. |
--disableBuiltInNugetFeeds | Desabilitar feeds integrados do NuGet. |
|
| Número de novas tentativas para casos de teste com falha (por padrão, nenhuma nova tentativa é definida). |
-u ou --username ( necessário se você usar a Autenticação Básica , por meio de um nome de usuário e uma senha) | O nome de usuário usado para autenticação no Orchestrator. Você deve emparelhá-lo com a senha correspondente. |
-p ou --password ( necessário se você usar a Autenticação Básica , por meio de um nome de usuário e uma senha) | A senha usada para autenticação ao Orchestrator. Você deve combiná-lo com o nome de usuário correspondente. |
-t ou --token ( obrigatório se você usar autenticação baseada em token ) | O token de atualização do OAuth2 usado para autenticação ao Orchestrator. Você deve combiná-lo com o Nome da conta e ID do cliente . |
-a ou --accountName ( obrigatório se você usar autenticação baseada em token ) | O nome da conta CloudRPA do Orchestrator. Você deve combiná-lo com o token de atualização do OAuth2 e o ID do cliente . |
-A , --accountForApp | O nome da conta do Orchestrator CloudRPA (nome da organização). Você deve combiná-lo com a ID do aplicativo, Segredo do aplicativo e Escopo do aplicativo para um aplicativo externo. |
-I ou --applicationId ( obrigatório se você usar autenticação de aplicativo externo ) | A ID do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, Segredo do aplicativo e Escopo do aplicativo. |
-S ou --applicationSecret ( obrigatório se você usar autenticação de aplicativo externo ) | O Segredo do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, ID do aplicativo e Escopo do aplicativo. |
--applicationScope ( Opcional para autenticação de aplicativos externos ) | A lista de escopos do aplicativo, separada por espaços únicos. Opcional ao usar autenticação de aplicativo externo, pois os escopos padrão são aplicados automaticamente. Você deve combiná-lo com a Conta do aplicativo , ID do aplicativo e Segredo do aplicativo para um aplicativo externo |
-o , or --organizationUnit | A pasta do Orchestrator onde você deseja executar os conjuntos de teste. |
--author | O autor do pacote. |
-l , or --language | O idioma usado na interface do usuário do Orchestrator. |
|
| Exibir o rastreamento dos eventos. |
--identityURL ( Necessário para implantações PaaS ou MSI ) | A URL do seu servidor de identidade. |
Orchestrator URL (pos. 0) ( Necessário ) | O URL da instância do Orchestrator. |
|
| O locatário dentro do qual está o pacote ou conjunto de teste. |
Ao usar a autenticação de aplicativos externos sem especificar o parâmetro --applicationScope , a CLI aplica automaticamente esses escopos do Orchestrator padrão:
OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read
Para operações do Test Manager, consulte Testando um pacote ou executando um conjunto de testes no Test Manager , que usa diferentes escopos padrão.
Uso:**
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>]
Exemplos:
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" --author ExampleAuthor