Depois de construir o cenário de teste, você pode executá-lo para gerar um relatório de teste.Selecionar o método de execução adequado#
O Apidog oferece várias maneiras de executar cenários de teste, adequadas a diferentes requisitos de teste.Este método é iniciado a partir de uma máquina local e é adequado para testes rápidos e de pequena escala. Ele é particularmente eficaz quando o desenvolvimento e os testes ocorrem simultaneamente, permitindo monitoramento em tempo real e ajustes imediatos.Ideal para lidar com dados em grande escala ou cenários iterativos, este método oferece maior velocidade de execução. Ele é capaz de executar offline, o que é adequado para ambientes com recursos restritos ou que não exigem uma interface gráfica do usuário.Este estilo de execução é integrado ao pipeline de CI/CD, tornando-se uma ótima opção para processos de integração automatizada e implantação contínua. Ele é especialmente útil em ambientes nos quais os testes são executados com frequência para confirmar a estabilidade das APIs após cada atualização de código.4.
Execução com runner auto-hospedado:
Em cenários de teste, se variáveis de ambiente/globais forem usadas, os valores reais dessas variáveis podem diferir dependendo do método de execução escolhido, o que pode levar a resultados de teste inconsistentes. Saiba mais. Primeiros passos#
1
Acesse o cenário de teste desejado e selecione o ambiente no qual você deseja que as requisições sejam executadas.
3
Você verá um relatório de teste exibindo informações como taxa de aprovação, tempo de execução e outros dados da execução atual. Você pode expandir cada requisição para visualizar validações e assertivas.
4
Clique em "mais" para inspecionar os detalhes reais da requisição e da resposta.
Opções de execução em cenários de teste#
Ao executar um cenário de teste no Apidog, várias configurações e opções podem ser configuradas para adaptar a execução do teste a requisitos específicos.A seguir, exploramos os aspectos críticos dessas configurações:Ambiente#
Especifique o serviço (URL base) para o qual as requisições no cenário devem ser direcionadas e o conjunto de variáveis a ser usado. Saiba mais detalhes em ambientes e serviços.Observe que requisições personalizadas têm sua própria URL completa e NÃO serão direcionadas ao ambiente definido neste contexto, diferentemente das etapas importadas.Dados de teste#
O cenário de teste oferece suporte à importação de conjuntos externos de dados de teste. Quando o cenário de teste é executado, o sistema percorre todos os conjuntos de dados no arquivo de dados e atribui os dados dos conjuntos de dados às variáveis correspondentes; consulte testes orientados por dados para obter detalhes.Iterações#
Configure o número de vezes que todas as etapas dentro do cenário serão executadas em um loop.Se houver uma quantidade significativa de dados a processar, recomenda-se usar o Apidog CLI para a execução em vez do cliente Apidog, a fim de otimizar o desempenho.Threads#
Execute todas as etapas em várias threads, nas quais os dados entre threads permanecem isolados para evitar interferência.Observe que este recurso está em Beta e pode exigir otimização adicional de desempenho. Para testes de carga rigorosos, recomenda-se usar a funcionalidade de teste de desempenho.
Threads não são compatíveis com a CLI.Executa em#
A máquina que realmente consome recursos de hardware para executar cenários de teste. Todas as requisições iniciadas nos cenários de teste serão enviadas a partir da máquina especificada aqui. Portanto, diferenças no ambiente de rede da máquina que faz a requisição podem levar a resultados de teste variáveis.Esta configuração não será salva como parte da configuração de execução do cenário de teste. A cada vez, a máquina local será usada por padrão para executar os cenários de teste. Além disso, esta configuração não terá efeito durante execuções em lote ou execuções via CLI. Nesses casos, as requisições serão iniciadas usando os recursos da máquina atual.
Notificações#
Habilitar este recurso enviará notificações aos destinatários especificados assim que o cenário de teste manual for concluído. A notificação incluirá uma visão geral dos resultados do teste e um link para o relatório detalhado. Você pode configurar se deseja enviar a notificação assim que o teste terminar ou somente quando ocorrer uma falha, ajudando a minimizar alertas desnecessários. Consulte configurações de notificação para obter informações mais detalhadas.Compartilhado#
Ao habilitar a opção "Compartilhar" no lado direito das Configurações avançadas, o relatório de teste gerado após cada execução do cenário de teste será compartilhado automaticamente com outros membros do projeto. Você pode visualizar todos os relatórios de teste que foram compartilhados dentro da equipe na aba Compartilhado na seção Relatórios de teste. Consulte relatórios de teste para obter mais detalhes.Configurações avançadas#
Em caso de erro#
Configure como o teste deve lidar com erros, que podem incluir falhas de assertiva, falhas de validação de formato de dados, erros de servidor etc. As opções são:Ignorar: Continuar executando a próxima etapa quando ocorrer um erro (configuração padrão).
Continuar: Encerrar a iteração atual e iniciar a próxima quando ocorrer um erro.
Encerrar execução: Interromper toda a execução quando um erro for encontrado.
Atraso#
Defina uma pausa entre o envio de cada etapa para gerenciar e controlar a velocidade de execução.Salvar requisições/respostas#
Por padrão, o Apidog salva todas as requisições e respostas. Em casos nos quais as requisições ou respostas sejam significativamente grandes (potencialmente vários MBs), elas podem ocupar um espaço considerável em disco. Você pode habilitar esta opção para não salvar todas as requisições e respostas, mas salvar apenas os resultados de assertivas e validações.Como alternativa, você pode optar por salvar apenas requisições e respostas com falha para economizar espaço.Manter valores de variáveis#
Esta opção é habilitada por padrão, garantindo que o valor atual das variáveis globais e de ambiente, quando modificado durante o teste, mantenha o último resultado modificado. Se esta opção for desabilitada, as variáveis globais e de ambiente não serão alteradas após a execução do teste; elas manterão o valor que tinham antes da execução.Variáveis locais não são afetadas por esta configuração e serão limpas após cada execução.No canto inferior direito do Apidog, o ícone Cookies leva ao gerenciamento de cookies. O Apidog salva cookies automaticamente ao fazer requisições de API. Se você quiser usar os cookies salvos durante a execução do cenário de teste, habilite esta opção.Salvar cookies após a execução#
Semelhante ao item acima, se você quiser atualizar os cookies salvos após executar um cenário de teste, habilite esta opção.Ao configurar essas configurações avançadas no Apidog, você pode ajustar suas execuções de teste para atender às suas necessidades específicas de teste, garantindo execuções de teste eficientes e precisas.Configurações de runtime no modo de design do cenário de teste#
Se você estiver no modo de design do cenário de teste, as configurações de runtime relevantes ficarão recolhidas no lado direito do botão "Executar". Passe o mouse sobre este botão de configurações para ver as configurações detalhadas de runtime deste cenário de teste.Executar testes funcionais#
Após executar testes funcionais, você será direcionado para a página de execução do cenário de teste. O gráfico de pizza na imagem abaixo fornece uma visão geral dos resultados do teste, atualizando em tempo real à medida que o cenário de teste é executado. Abaixo do gráfico de pizza, você encontrará as etapas de teste detalhadas sendo executadas, com o status de cada etapa exibido durante a execução.Assim que a execução do teste funcional for concluída, você poderá clicar no endpoint relevante para visualizar suas métricas e status durante o teste. Isso inclui o nome do endpoint, método da requisição, URL da requisição, código de status da resposta, tempo de resposta, conteúdo da resposta, validação de dados e resultados de assertivas. Para obter mais detalhes, consulte relatórios de teste.Regras para usar variáveis de ambiente/globais em diferentes métodos de execução#
Variáveis de ambiente e globais são persistentes, o que significa que podem ser salvas para uso de longo prazo em várias execuções ou em diferentes cenários de teste. No entanto, os valores reais das variáveis usados podem variar dependendo do método de execução selecionado. Por exemplo:Se um cenário de teste usar uma variável de ambiente Token, ele poderá ser executado com sucesso quando executado dentro do cliente, mas falhar quando executado usando um Runner auto-hospedado porque o valor do Token está incorreto.Essa discrepância pode ocorrer porque o valor real da variável de ambiente Token é obtido do valor armazenado localmente dentro do cliente durante a execução. No entanto, ao executar em um Runner auto-hospedado, o Runner não tem o mesmo Token armazenado localmente, levando a uma falha.Para resolver esse problema, o Apidog fornece um conjunto de regras para gerenciar valores da variável de ambiente/global em diferentes métodos de execução:| Método de execução | Uso de variáveis de ambiente/globais | Local de armazenamento das variáveis |
|---|
| Local (Cliente, Web) | Usa os valores atuais das variáveis de ambiente/globais para execução. | Armazenados localmente. Podem ser modificados manualmente ou atualizados por meio de pré/pós-processadores. Visíveis em Gerenciamento de Ambiente > Variáveis de Ambiente/Globais > Valores Atuais. |
| CLI, CI/CD | Para execução online em tempo real:- Usa os valores iniciais das variáveis de ambiente/globais para execução (padrão).
- Especifique o uso de valores de variáveis de ambiente/globais armazenados em um arquivo na máquina que executa o cenário de teste por meio da opção
--variables path. Saiba mais.
Para execução com dados exportados:- Usa os valores de variáveis de ambiente/globais incluídos no arquivo exportado para execução.
| - Os valores iniciais são armazenados no Apidog Cloud e só podem ser modificados manualmente dentro do cliente.
- Armazenados no arquivo especificado pela opção
--variables path, permitindo modificação manual ou atualizações por meio de pré/pós-processadores. - Armazenados no arquivo exportado. Podem ser modificados manualmente ou atualizados por meio de pré/pós-processadores.
|
| Runner auto-hospedado | - Usa os valores iniciais das variáveis de ambiente/globais para execução (padrão).
- Usa os valores armazenados localmente dentro do Runner para execução. Saiba mais.
| - Os valores iniciais são armazenados no Apidog Cloud e só podem ser modificados manualmente dentro do cliente.
- Armazenados dentro do Runner especificado. Podem ser modificados manualmente ou atualizados por meio de pré/pós-processadores. Visíveis por meio da interface de usuário do produto ou no arquivo dentro do Runner em
/opt/runner/variables.
|
Quando um cenário de teste inclui endpoints importados de outros projetos, as URLs de requisição desses endpoints durante a execução são determinadas pela configuração que você define em Associações de ambiente.Se o "Ambiente de Desenvolvimento" do projeto atual estiver associado ao "Ambiente de Produção" de outro projeto, ao executar o cenário de teste usando o "Ambiente de Desenvolvimento", o endpoint importado será enviado para a URL do "Ambiente de Produção". Todos os outros endpoints usarão a URL do "Ambiente de Desenvolvimento" do projeto atual.Implementar vários testes#
As etapas mencionadas representam a execução básica de um cenário de teste. Ao configurar cenários de teste, você pode incorporar várias configurações avançadas para atender a diversos requisitos de teste.Testes orientados por dados: Conduza testes usando diversos conjuntos de dados para validar o comportamento do sistema em vários cenários. Teste de desempenho: Avalie o desempenho do sistema sob condições de carga variáveis para analisar escalabilidade e responsividade. Tarefas agendadas: Estabeleça planos estruturados detalhando escopo, abordagem e cronograma das atividades de teste. Integração de CI/CD: Automatize processos de build, teste e implantação para garantir lançamentos de software confiáveis e frequentes. 
