Automação de Teste de API

O Studio aceita projetos de automação de teste de API por meio de sua integração com o Postman, uma ferramenta de desenvolvimento de software para realizar chamadas de teste para APIs. Essa integração também inclui o Newman, um executor de coleção de linha de comando para o Postman para executar e testar uma coleção diretamente da linha de comando.

Para importar uma coleção do Postman para o Studio, use o assistente Novo serviço para bibliotecas e acesse a coleção do Postman usando uma chave de API geral, que você pode gerar a partir da seção Chaves de API.

As coleções importadas podem ser usadas para projetos de teste. Detalhes sobre os pré-requisitos do Postman estão disponíveis aqui.

No contexto de testes, as coleções do Postman importadas nas bibliotecas do Studio podem ser publicadas como um pacote .nupkg localmente ou no Orchestrator e, em seguida, instaladas como dependências em projetos de automação de teste.

Exemplo de automação de teste de API

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.

   
   

   

   
   

Como usar um arquivo ou link do Swagger

Este exemplo mostra como executar uma Automação de teste 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ível:

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

Etapas

1. No projeto de sua biblioteca, na faixa de opções Design , selecione Novo Serviço.

   The Service Editor window is displayed.

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 para importação.
   • Se você estiver usando um link para um arquivo Swagger, insira o link Swagger diretamente no campo Arquivo ou link .
3. No Editor de Serviço, selecione Carregar.

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

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

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

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

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

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