Teste de um pacote ou execução de um conjunto de testes

Pré-requisitos

• Crie um pacote ou um conjunto de testes.
• Execute o arquivo CLI exe (para Windows Legacy) ou dll (para Windows/Linux/macOS).
• Adicione os escopos de aplicativos de acesso à API do Orchestrator necessários.

Para testar um pacote, siga as seguintes etapas:

1. Execute a tarefa test , usando uipcli test. Você pode ver uma lista das subtarefas disponíveis.
2. Especifique os parâmetros necessários e execute a subtarefa run . A tabela a seguir descreve os parâmetros necessários:

Parâmetro	Description
Orchestrator URL (pos. 0) ( Necessário )	O URL da instância do Orchestrator.
Orchestrator Tenant (pos. 1)	The tenant inside which the package, or Test Set are. Required when targeting Automation Cloud. Optional for Automation Suite and standalone Orchestrator (on-premises MSI), where the tenant is part of the URL.
-P , or --project-path	O caminho para o arquivo do pacote Testing que você deseja testar.
-s , or --testset	O nome mostrado para o Conjunto de teste que você deseja executar. Certifique-se de que o Conjunto de teste inclua a versão mais recente dos Casos de teste. Se o projeto não tiver uma pasta padrão definida, certifique-se de atribuir uma pasta de teste no nível do Conjunto de testes.
--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.
--repositoryUrl	A URL do repositório onde o projeto é versionado.
--repositoryCommit	A confirmação do repositório de onde o projeto foi criado.
--repositoryBranch	A ramificação do repositório de onde o projeto foi criado.
--repositoryType	Tipo de repositório do sistema VCS.
--projectUrl	URL da ideia do Automation Hub.
--releaseNotes	Adicione notas da versão.
--author	O autor do pacote.
--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.
--excludeConfiguredSources	Excludes the built-in feeds and the NuGet sources configured at the user and machine level on the host running the CLI. The CLI resolves packages only from the feeds defined in --nugetConfigFilePath. See Managing NuGet feeds.
--retryCount	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.
-l , or --language	O idioma usado na interface do usuário do Orchestrator.
--traceLevel	Exibir o rastreamento dos eventos.
--identityUrl	The URL of your identity server. Required when the Orchestrator runs on UiPath Automation Suite or standalone Orchestrator (on-premises MSI). Not needed for Automation Cloud — the CLI resolves the identity server from the cloud URL.
--ca-cert	Um ou mais arquivos de certificado de CA raiz confiáveis (pem, 5 ou PKCS#7DER) usados ao validar os certificados TLS do Orchestrator e do Identity Server. Repete o sinalizador ou vários caminhos separados por vírgulas. Consulte Confiança em certificados personalizados para obter mais detalhes.
--pinnedpubkey	Fixe a chave pública do certificado leaf do servidor. Formato: sha256//<base64>. Verificado além da validação de certificado padrão. Consulte Confiança em certificados personalizados para obter mais detalhes.

Dica:

Para instâncias do Orchestrator assinadas por uma Autoridade de Certificação privada (como o UiPath Automation Suite), esse comando também aceita parâmetros --ca-cert e --pinnedpubkey . Consulte Confiança em certificados personalizados para cenários e exemplos.

Observação: Escopos de aplicativos padrão para testes

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>]

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