Depois de construir o cenário de teste, pode executá-lo para gerar um relatório de teste.Selecionar o método de execução adequado#
O Apidog disponibiliza várias formas 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. É particularmente eficaz quando o desenvolvimento e os testes ocorrem em simultâneo, permitindo monitorização 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. É capaz de funcionar offline, o que é adequado para ambientes com recursos limitados ou que não exigem uma interface gráfica de utilizador.Este estilo de execução é integrado no pipeline CI/CD, tornando-o uma excelente opção para processos de integração automatizada e implementação contínua. É especialmente útil em contextos em que os testes são executados frequentemente para confirmar a estabilidade das APIs após cada atualização de código.4.
Execução com runner autoalojado:
Em cenários de teste, se forem utilizadas variáveis de ambiente/globais, os valores reais destas variáveis podem diferir dependendo do método de execução escolhido, o que pode levar a resultados de teste inconsistentes. Saiba mais. Introdução#
1
Aceda ao cenário de teste pretendido e selecione o ambiente no qual pretende que os pedidos sejam executados.
3
Verá um relatório de teste que apresenta informações como a taxa de aprovação, o tempo de execução e outros dados da execução atual. Pode expandir cada pedido para ver validações e asserções.
4
Clique em "more" para inspecionar os detalhes reais do pedido e da resposta.
Opções de execução em cenários de teste#
Ao executar um cenário de teste no Apidog, podem ser configuradas várias definições e opções para adaptar a execução do teste a requisitos específicos.Abaixo, exploramos os aspetos críticos destas definições:Ambiente#
Especifique o serviço (URL base) para o qual os pedidos do cenário devem ser direcionados e o conjunto de variáveis a utilizar. Saiba mais detalhes em ambientes e serviços.Tenha em atenção que os pedidos personalizados têm o seu próprio URL completo e NÃO serão direcionados para o ambiente definido neste contexto, ao contrário dos passos importados.Dados de teste#
O cenário de teste suporta a importação de conjuntos de dados de teste externos. Quando o cenário de teste é executado, o sistema percorre todos os conjuntos de dados no ficheiro 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 todos os passos dentro do cenário serão executados em ciclo.Se houver uma quantidade significativa de dados a processar, recomenda-se utilizar o Apidog CLI para a execução, em vez do cliente Apidog, para otimizar o desempenho.Threads#
Execute todos os passos em várias threads, mantendo os dados entre threads isolados para evitar interferências.Tenha em atenção que esta funcionalidade está em Beta e pode exigir otimização adicional de desempenho. Para testes de carga rigorosos, aconselha-se utilizar a funcionalidade de teste de desempenho.
As threads não são suportadas na CLI.Executa em#
A máquina que efetivamente consome recursos de hardware para executar cenários de teste. Todos os pedidos iniciados nos cenários de teste serão enviados a partir da máquina especificada aqui. Por conseguinte, diferenças no ambiente de rede da máquina que efetua o pedido podem conduzir a resultados de teste variáveis.Esta definição não será guardada como parte da configuração de execução do cenário de teste. Sempre que executar, a máquina local será utilizada por predefinição para executar os cenários de teste. Além disso, esta definição não terá efeito durante execuções em lote ou execuções CLI. Nestes casos, os pedidos serão iniciados utilizando os recursos da máquina atual.
Notificações#
Ativar esta funcionalidade enviará notificações aos destinatários especificados assim que o cenário de teste manual estiver concluído. A notificação incluirá uma visão geral dos resultados do teste e uma ligação para o relatório detalhado. Pode configurar se pretende enviar a notificação assim que o teste terminar ou apenas quando ocorrer uma falha, ajudando a minimizar alertas desnecessários. Consulte definições de notifica ções para obter informações mais detalhadas.Partilhado#
Ao ativar a opção "Share" no lado direito de Advanced Settings, o relatório de teste gerado após cada execução do cenário de teste será automaticamente partilhado com outros membros do projeto. Pode ver todos os relatórios de teste que foram partilhados dentro da equipa no separador Shared na secção Test Reports. Consulte relatórios de teste para obter mais detalhes.Definições avançadas#
Em caso de erro#
Configure como o teste deve lidar com erros, que podem incluir falhas de asserção, falhas de validação do formato dos dados, erros do servidor, etc. As opções são:Ignorar: continuar a executar o passo seguinte quando ocorrer um erro (definição predefinida).
Continuar: terminar a iteração atual e iniciar a seguinte quando ocorrer um erro.
Terminar execução: parar toda a execução quando for encontrado um erro.
Atraso#
Defina uma pausa entre o envio de cada passo para gerir e controlar a velocidade de execução.Guardar pedidos/respostas#
Por predefinição, o Apidog guarda todos os pedidos e respostas. Nos casos em que os pedidos ou respostas sejam significativamente grandes (potencialmente vários MB), estes podem ocupar uma quantidade considerável de espaço em disco. Pode ativar esta opção para não guardar todos os pedidos e respostas, guardando apenas os resultados de asserção e validação.Em alternativa, pode optar por guardar apenas pedidos e respostas com falha para poupar espaço.Manter valores das variáveis#
Esta opção está ativada por predefinição, garantindo que o valor atual das variáveis globais e de ambiente, quando modificado durante o teste, conserva o último resultado modificado. Se esta opção for desativada, as variáveis globais e de ambiente não serão alteradas após a execução do teste; conservarão o valor que tinham antes da execução.As variáveis locais não são afetadas por esta definição e serão limpas após cada execução.No canto inferior direito do Apidog, o ícone Cookies conduz à gestão de cookies. O Apidog guarda cookies automaticamente ao efetuar pedidos de API. Se pretender utilizar os cookies guardados durante a execução do cenário de teste, ative esta opção.Guardar cookies após a execução#
De forma semelhante ao descrito acima, se pretender atualizar os cookies guardados após executar um cenário de teste, ative esta opção.Ao configurar estas definições avançadas no Apidog, pode ajustar com precisão as suas execuções de teste para satisfazer as suas necessidades específicas de teste, garantindo execuções de teste eficientes e precisas.Definições de runtime no modo de desenho do cenário de teste#
Se estiver no modo de desenho do cenário de teste, as configurações de runtime relevantes ficam recolhidas no lado direito do botão "Run". Passe o rato sobre este botão de definições para ver as configurações de runtime detalhadas deste cenário de teste.Executar testes funcionais#
Depois de executar testes funcionais, será direcionado para a página de execução do cenário de teste. O gráfico circular 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 circular, encontrará os passos de teste detalhados que estão a ser executados, com o estado de cada passo apresentado durante a execução.Assim que a execução do teste funcional estiver concluída, pode clicar no endpoint relevante para ver as suas métricas e o seu estado durante o teste. Isto inclui o nome do endpoint, método do pedido, URL do pedido, código de estado da resposta, tempo de resposta, conteúdo da resposta, validação de dados e resultados das asserções. Para obter mais detalhes, consulte relatórios de teste.Regras para utilizar variáveis de ambiente/globais em diferentes métodos de execução#
As variáveis de ambiente e globais são persistentes, o que significa que podem ser guardadas para utilização a longo prazo em várias execuções ou diferentes cenários de teste. No entanto, os valores reais das variáveis utilizados podem variar dependendo do método de execução selecionado. Por exemplo:Se um cenário de teste utilizar uma variável de ambiente Token, poderá ser executado com sucesso dentro do cliente, mas falhar quando for executado utilizando um Runner autoalojado porque o valor de Token está incorreto.Esta discrepância pode ocorrer porque o valor real da variável de ambiente Token é obtido a partir do valor armazenado localmente no cliente durante a execução. No entanto, ao executar num Runner autoalojado, o Runner não tem o mesmo Token armazenado localmente, o que leva a uma falha.Para resolver este problema, o Apidog fornece um conjunto de regras para gerir valores da variável de ambiente/global em diferentes métodos de execução:| Método de execução | Utilização de variáveis de ambiente/globais | Localização de armazenamento das variáveis |
|---|
| Local (Cliente, Web) | Utiliza os valores atuais das variáveis de ambiente/globais para a execução. | Armazenadas localmente. Podem ser modificadas manualmente ou atualizadas através de pré/pós-processadores. Visíveis em Environment Management > Environment/Global Variables > Current Values. |
| CLI, CI/CD | Para execução online em tempo real:- Utiliza os valores iniciais das variáveis de ambiente/globais para a execução (predefinição).
- Especifique a utilização de valores de variáveis de ambiente/globais armazenados num ficheiro na máquina que executa o cenário de teste através da opção
--variables path. Saiba mais.
Para execução com dados exportados:- Utiliza os valores de variáveis de ambiente/globais incluídos no ficheiro exportado para a execução.
| - Os valores iniciais são armazenados no Apidog Cloud e só podem ser modificados manualmente dentro do cliente.
- Armazenados no ficheiro especificado pela opção
--variables path, permitindo modificação manual ou atualizações através de pré/pós-processadores. - Armazenados no ficheiro exportado. Podem ser modificados manualmente ou atualizados através de pré/pós-processadores.
|
| Runner autoalojado | - Utiliza os valores iniciais das variáveis de ambiente/globais para a execução (predefinição).
- Utiliza os valores armazenados localmente no Runner para a execução. Saiba mais.
| - Os valores iniciais são armazenados no Apidog Cloud e só podem ser modificados manualmente dentro do cliente.
- Armazenados no Runner especificado. Podem ser modificados manualmente ou atualizados através de pré/pós-processadores. Visíveis através da interface de utilizador do produto ou no ficheiro dentro do Runner em
/opt/runner/variables.
|
Quando um cenário de teste inclui endpoints importados de outros projetos, os URLs dos pedidos para estes endpoints durante a execução são determinados pela configuração que definiu em Environment associations.Se o "Develop Env" do projeto atual estiver associado ao "Prod Env" de outro projeto, ao executar o cenário de teste utilizando "Develop Env", o endpoint importado será enviado para o URL de "Prod Env". Todos os outros endpoints utilizarão o URL de "Develop Env" do projeto atual.Implementar vários testes#
Os passos mencionados representam a execução básica de um cenário de teste. Ao configurar cenários de teste, pode incorporar várias definições avançadas para cumprir diversos requisitos de teste.Testes orientados por dados: realize testes utilizando diversos conjuntos de dados para validar o comportamento do sistema em vários cenários. Testes de desempenho: avalie o desempenho do sistema sob condições de carga variáveis para analisar a escalabilidade e a capacidade de resposta. Tarefas agendadas: estabeleça planos estruturados que detalhem o âmbito, a abordagem e o calendário das atividades de teste. Integração CI/CD: automatize os processos de compilação, teste e implementação para garantir lançamentos de software fiáveis e frequentes. 
