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.

   
   

   

   
   

Using a Swagger file or link

This example shows how to perform API Test Automation by loading either a Swagger JSON file in Studio or a Swagger link.

Pré-requisitos

To follow this example, you need to have one of the following resources available:

• A JSON file exported from Swagger, that is located on your machine.
• A link to a Swagger file.

Etapas

1. In your library project, from the Design ribbon, select New Service.

   The Service Editor window is displayed.

2. Choose a Swagger resource you want to use:
   • For a local JSON Swagger file, select the More Options menu adjacent to the File or Link field. Browse and open the desired Swagger file to import.
   • If you are using a link to a Swagger file, enter the Swagger link directly into the File or Link field.
3. In the Service Editor, select Load.

   All defined endpoints from the Swagger file are now loaded in the Service Editor.

4. Type in the method or operation you need in the Search Operations search box and view the returned results.

   For Swagger files, the methods are marked with different colors for each endpoint that you want to load.

   The namespace is generated automatically, but you can edit it.

5. Select Save to integrate the service into your library.

Figure 1. A loaded Swagger file in the Service Editor