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 . 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.
--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	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 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.
--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 (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 ( 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.
--traceLevel	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.
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:**

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:

Testes do Orchestrator:

• 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"

Testes do Test Manager:

• uipcli 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"
• uipcli 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.