Testando um pacote/Executando um conjunto de teste

Pré-requisitos:

• Crie um pacote ou conjunto de testes.
• Execute o arquivo CLI exe (para Windows) ou dll (para Linux).
• Adicione os escopos de aplicativos de acesso à API do Orchestrator abaixo:

  Escopo do aplicativo	Description
  OU. Ativos	Acesso de leitura e gravação de ativos no Orchestrator.
  OR.BackgroundTasks	Acesso de leitura e gravação de BackgroundTasks no Orchestrator.
  OU. Execução	Acesso de leitura e gravação de execução no Orchestrator.
  OU.Pastas	Acesso de leitura e gravação de pastas no Orchestrator.
  OU.Empregos	Acesso de leitura e gravação de trabalhos no Orchestrator.
  OR.Machines.Read	Acesso de leitura de máquinas no Orchestrator.
  OU.Monitoramento	Acesso de leitura e gravação de monitoramento no Orchestrator.
  OU.Robôs.Leitura	Acesso de leitura de robôs no Orchestrator.
  OU.Configurações.Ler	Acesso de leitura de configurações no Orchestrator.
  OR.TestSets	Acesso de leitura e gravação de TestSets no Orchestrator.
  OR.TestSetExecutions	Acesso de leitura e gravação de TestSetExecutions no Orchestrator.
  OR.TestSetSchedules	Acesso de leitura e gravação de TestSetSchedules no Orchestrator.
  OU.Usuários.Leitura	Acesso de leitura de usuários no Orchestrator.

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 .

   Veja a lista de parâmetros abaixo.

   Parâmetro	Description
   Orchestrator URL (pos. 0) (necessário)	O URL da instância do Orchestrator.
   Orchestrator Tenant (pos. 1) (Obrigatório) para implantações SaaP. (Opcional) para implantações de PaaS.	O locatário dentro do qual está o pacote ou conjunto de teste.
   -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(Necessário se você usar a autenticação baseada em token)	O token de atualização OAuth2 usado para autenticação no Orchestrator. Você deve emparelhá-lo com o nome da conta e o ID do cliente.
   -a, ou --accountName(Necessário se você usar a autenticação baseada em token)	O nome da conta do Orchestrator CloudRPA. Você deve emparelhá-lo com o token de atualização OAuth2 e o Client ID.
   -A, --accountForApp	O nome da conta CloudRPA do Orchestrator. Você deve combiná-lo com a ID do aplicativo, Segredo do aplicativo e Escopo do aplicativo para um aplicativo externo.
   -I, ou --applicationId(Necessário se você usar a autenticação por 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(Necessário se você usar a autenticação por aplicativo externo)	O Segredo do aplicativo externo. Você deve combiná-lo com a Conta do aplicativo, ID do aplicativo e Escopo de aplicativo.
   --applicationScope (Necessário se você usar a autenticação do 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
   -Pou --project-path	O caminho para o arquivo do pacote Testing que você deseja testar.
   -sou --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 que retorna os resultados.
   -rou --result_path	O caminho de destino do arquivo onde você deseja armazenar os resultados.
   -eou --environment (obrigatório para pastas clássicas)	O ambiente onde você deseja implantar o pacote. Você deve emparelhá-lo com o project path.
   -wou --timeout	O tempo (em segundos) que você deseja aguardar a execução do conjunto de testes. O valor padrão é 7200 segundos.
   -iou --input_path (obrigatório se o fluxo de trabalho do ponto de entrada tiver parâmetros de entrada que você deseja passar pela linha de comando)	O caminho completo para um arquivo de entrada JSON.
   --attachRobotLogs	Anexa logs do robô para cada caso de teste executado e um relatório de teste JUnit.
   -oou --organizationUnit	A pasta do Orchestrator onde você deseja executar os conjuntos de teste.
   -lou --language	O idioma usado na interface do usuário do Orchestrator.
   -you --disableTelemetry	Desabilitar dados de telemetria.
   --traceLevel	Exibir o rastreamento dos eventos.
   --identityURL (exigido apenas para implantações de PaaS)	A URL do seu servidor de identidade.
   --help	Exibe os parâmetros e exemplos para este comando.

Exemplos:

• test run "https://uipath-orchestrator.myorg.com" default -A myAccountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read" -s "MyRobotTests".
• test run "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -P "C:\UiPath\Project\project.json" -e TestingEnv -r "C:\results.json" --out uipath -l en-US.
• test run "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -P "C:\UiPath\Project\project.json" -e TestingEnv -r "C:\results.json" -i "C:\UiPath\Project\input-params.json" --out uipath -l en-US --attachRobotLogs "true".

Adição de um aplicativo externo

Para registrar um aplicativo externo, de forma que ele possa acessar seus recursos da UiPath usando o OAuth:

1. Faça logon no tenant como um Administrador.
2. Acesse Tenant > Gerenciar acesso > Atribuir funções e clique em Gerenciar contas e grupos.

   O nível de tenant é aberto.

3. À esquerda, selecione Aplicativos externos.

   A página Aplicativos externos é aberta, listando todos os aplicativos externos existentes registrados para o tenant atual:

   
   

   

   
   
4. Acima da tabela, à direita, clique em Adicionar aplicativo.
5. Preencha o campo Application Name.
6. Selecione uma opção para o Tipo de aplicativo.

   Se você selecionar Aplicativo confidencial, receberá um segredo do aplicativo no final, portanto, certifique-se de que seu aplicativo pode armazená-lo com segurança. Se não for possível, selecione Aplicativo não confidencial.

7. Em Recursos, clique em Adicionar escopos.

   O painel Editar recurso será aberto à direita, no qual você pode selecionar os recursos que o aplicativo deve ter acesso.

8. Na lista suspensa Recurso, selecione a API do UiPath que o aplicativo pode usar.
   Nota: Você só pode adicionar escopo para um recurso por vez. Se você quiser permitir acesso a vários recursos, repita esse processo para adicionar escopo para cada recurso.
9. Na guia Escopo(s) do usuário, marque as caixas de seleção para as permissões de API lógica que você deseja conceder, conforme necessário.

   A concessão de permissões no escopo do usuário significa que o aplicativo externo pode acessar esses recursos dentro de um contexto de usuário e um usuário com as permissões adequadas deve estar logado.

10. Se esse for um aplicativo confidencial, você pode alternar para a guia Escopo(s) do aplicativo para também conceder permissões de nível de aplicativos para o recurso selecionado, conforme necessário.

    Com permissões sob o escopo do aplicativo, o aplicativo externo tem acesso aos dados de nível de aplicativo dos escopos selecionados sem a necessidade de interação do usuário.

    Os aplicativos não confidenciais não podem acessar o escopo do aplicativo.

11. Clique em Salvar.

    O painel será fechado e o recurso e os escopos selecionados serão adicionados à tabela Recursos no formulário.

12. Se o aplicativo externo puder aceitá-lo, você pode adicionar uma URL no campo Redirecionar URL e a resposta de autorização será enviada para ela. O aplicativo pode usá-la para acessar recursos da UiPath.
13. Clique em Adicionar para criar o registro.

    Uma mensagem de confirmação será aberta. Para aplicativos confidenciais, a mensagem de confirmação inclui o segredo do aplicativo que o aplicativo externo registrado pode usar para solicitar autorização. Certifique-se de salvá-lo em um local seguro porque não poderá exibi-lo novamente.