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) ou dll (para Linux).
• 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 . Consulte a lista de parâmetros abaixo.

Parâmetro	Description
-P , or --project-path	O caminho para o arquivo do pacote Testing que você deseja testar.
--projectKey	A chave do projeto exibida em Test Manager > guia Painel > Projetos > Todos os projetos. A chave do projeto é o prefixo para todas as chaves de objeto. Necessário ao usar o Test Manager.
--testsetkey	A chave do conjunto de testes exibida na guia Test Manager > Conjuntos de testes > coluna Chave. Certifique-se de que o Conjunto de teste inclua a versão mais recente dos Casos de teste. Se o Conjunto de teste não estiver na pasta padrão, certifique-se de incluir o nome da pasta relevante antes dele. Por exemplo, use AccountingTeam\\TestSet.
-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.
--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.
--disableBuiltInNugetFeeds	Desabilitar feeds integrados do NuGet.
--retryCount	Número de novas tentativas para casos de teste com falha.
-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 ( Necessário se você usar autenticação de aplicativo externo )	A lista de escopos do aplicativo, separada por espaços únicos. Você deve combiná-lo com a Conta do aplicativo , ID do aplicativo e Segredo do aplicativo para um aplicativo externo. Ao usar o Test Manager, inclua: TM.Projects TM.TestSets TM.TestExecutions além dos escopos do Orchestrator.
-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.
-y , or --disableTelemetry	Desabilitar dados de telemetria.
--traceLevel	Exibir o rastreamento dos eventos.
--identityURL ( Necessário para implantações PaaS ou MSI )	A URL do seu servidor de identidade.
--help	Exibe os parâmetros e exemplos para este comando.
--version	Exibe informações da versão.
Orchestrator URL (pos. 0) ( Necessário )	O URL da instância do Orchestrator.
Orchestrator Tenant (pos. 1) ( Obrigatório ) para implantações do SaaP. ( Opcional ) para implantações do PaaS.	O locatário dentro do qual está o pacote ou conjunto de teste.

Uso:**

test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <package>] [-s <testset>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <account_for_app> -I <application_id> -S <application_secret> --applicationScope] [-e <environment>] [-o <folder_organization_unit>] [-l <language>]

Exemplos:

Testes do Orchestrator:

• test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
• 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"
• 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"
• 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
• test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" --out junit
• test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" --out uipath

Testes do Test Manager:

• test run "https://cloud.uipath.com/" "TenantName" --projectKey "MyTestProject" --testsetkey "MyTestSet" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" -o "FolderName" --out "junit" --result_path "C:\TestResults"
• test run "https://cloud.uipath.com/" "TenantName" --projectKey "MyTestProject" -P "C:\userprofile\AutomationProjectWithTestCases\project.json" -e "TestEnvironment" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions OR.Assets OR.BackgroundTasks OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read" -o "FolderName" --out "uipath" --result_path "C:\TestResults"

Observação:

Para obter mais detalhes sobre como usar o Test Manager com o UiPath CLI, consulte Testando um pacote ou executando um conjunto de testes no Test Manager.