Automação de Teste de API

O Studio é compatível com a automação de testes de API por meio do assistente de Novo Serviço. Você pode importar e testar definições de API em vários formatos de API, incluindo Swagger e outros. Os recursos de automação de testes de API do Studio permitem que você crie, gerencie e execute testes automatizados em diferentes serviços.

Após a importação, você pode usar definições de serviço em projetos de automação de testes para validar endpoints, respostas e comportamentos. Você também pode publicar bibliotecas de serviços como .nupkg pacotes, localmente ou no Orchestrator, e reutilizá-las como dependências em seus fluxos de trabalho de teste.

O Studio também suporta o Postman como uma opção adicional para importar coleções de APIs. Para importar uma coleção, gere uma chave de API em sua conta do Postman e use-a no assistente Novo Serviço . O Studio integra-se ao Newman, o executor de linha de comando do Postman, para que você possa validar coleções diretamente da linha de comando. Para obter mais detalhes sobre os requisitos do Postman, acesse Coleções do Postman.

Usando o assistente de novo serviço para automação de testes de API

Este exemplo mostra como usar o assistente Novo Serviço para começar a realizar automação de testes de API carregando um arquivo JSON do Swagger no Studio ou um link do Swagger.

Pré-requisitos

Para seguir esse exemplo, você precisa ter um dos seguintes recursos disponíveis:

• Um arquivo JSON exportado do Swagger, que está localizado em sua máquina.
• Um link para um arquivo Swagger.

Etapas

1. Em seu projeto de biblioteca, na guia Design, selecione Novo Serviço.

   A janela Editor de Serviço será exibida.

2. Escolha um recurso Swagger que você deseja usar:
   • Para um arquivo JSON Swagger local, selecione o menu Mais Opções adjacente ao campo Arquivo ou Link. Navegue e abra o arquivo Swagger desejado.
   • Se você estiver usando um link para um arquivo Swagger, insira o link do Swagger diretamente no campo Arquivo ou Link.
3. No Editor de Serviço, selecione Carregar.

   Todos os endpoints definidos do arquivo Swagger agora são carregados no Editor de Serviço.

4. Digite o método ou operação de que você precisa na caixa de pesquisa Pesquisar Operações e visualize os resultados retornados.

   Para arquivos Swagger, os métodos são marcados com cores diferentes para cada endpoint que você deseja carregar.

   O namespace é gerado automaticamente, mas você pode editá-lo.

5. Selecione Salvar para integrar o serviço em sua biblioteca.

Figura 1. Um arquivo Swagger carregado no Editor de Serviço

Exemplo de teste de API usando Postman

O exemplo a seguir usa uma coleção de dados definida no Postman, importa-a em uma biblioteca do Studio, publica a biblioteca com a coleção e a instala em um projeto de teste. Depois, usa atividades de teste que fazem parte do pacote UiPath.Testing.Activities para verificar o uso de dados.

Os casos de teste são projetados para um fluxo de trabalho que solicita empréstimos automaticamente e recupera dados de empréstimo para clientes bancários.

Para verificar os pré-requisitos de instalação do Postman e do Newman, leia as informações nesta página.

Defina uma coleção de dados

No Postman, defina uma coleção de dados ou importe uma existente para seu espaço de trabalho atual. Nós criamos uma coleção de dados para solicitar um empréstimo, recuperar e excluir as informações do empréstimo. Quando usado em um projeto de teste de API, essa coleção verifica se a lógica do nosso fluxo de trabalho está correta.

Importe coleções

Para importar uma coleção no Studio, crie um projeto de biblioteca e use a janela Novo Serviço. O acesso à coleção é concedido por meio da chave de API do Postman. Adicione essa chave no campo File or Link e clique em Carregar.

Selecione apenas os pontos de extremidade que você deseja carregar no seu projeto e adicione um novo Namespace se necessário.

Marque a caixa Coleções vinculadas para que um link seja usado e a versão mais recente da sua coleção seja executada no runtime, em vez de uma versão armazenada localmente. Clique em Salvar quando estiver concluído.

Como usar coleções de dados

Após a coleção ser importada na biblioteca do Studio, seus endpoints serão convertidos em atividades de forma automática e ficarão disponíveis na guia Atividades, no namespace que você definiu anteriormente.

No nosso exemplo, um arquivo de Sequência separado foi criado para cada atividade gerada a partir dos pontos de extremidade.

Depois de adicionar uma atividade, adicione o ambiente do Postman (entre aspas "") no painel Propriedades.

Os valores de dados definidos na coleção do Postman são importados como Argumentos:

As bibliotecas podem ser publicadas localmente ou no Orchestrator como um pacote .nupkg.

Carregue a biblioteca no projeto de teste de API

1. Crie um projeto de teste no Studio usando o tipo de projeto de Automação de teste.
   
   

   

   
   
2. Instale a biblioteca publicada como uma dependência usando a janela Gerenciar Pacotes.
   
   

   

   
   
3. Os arquivos de sequência definidos anteriormente na biblioteca agora estão disponíveis no painel Atividades no namespace da biblioteca, juntamente com as atividades geradas a partir da importação do Postman.
   
   

   

   
   
4. Use essas atividades no seu projeto de automação de teste de API, combinadas com as atividades que fazem parte do pacote UiPath.Testing.Activities. Nós criamos um projeto de teste para verificar os dados inseridos ao solicitar um empréstimo em nosso aplicativo de demonstração. Esse pequeno teste usa um conjunto de variáveis embutidas em código, que ficam visíveis aqui no painel Propriedades:
   
   

   

   
   

   Esse processo de teste simples foi usado como um smoke test, a fim de verificar se o aplicativo respondeu corretamente. Vários desses testes podem ser criados no Studio, dependendo das suas necessidades de automação.

5. Para verificar vários cenários em um projeto de teste, acesse a faixa de opções, Novo > Caso de Teste Orientado por Dados. Importe o conjunto de dados, conforme explicado aqui. Veja abaixo um exemplo de um caso de teste desse tipo. Os valores agora estão armazenados em argumentos, mapeados na atividade.
   
   

   

   
   
6. Selecione Executar arquivo ou Depurar arquivo com as variações de dados e escolha os dados para usar. Isso é útil ao testar vários cenários com vários conjuntos de dados.
   
   

   

   
   

7. Após a execução do processo, os resultados ficam visíveis no painel Saída.