Orquestrar Suite de Testes

Após criar uma suite de testes, você precisa adicionar conteúdo de teste. O Apidog oferece modos flexíveis "Estático" e "Dinâmico" para atender a diferentes necessidades de gerenciamento de testes.

Importar Conteúdo de Teste

Na página de detalhes da suite de testes, na aba Orchestration, clique em + Add Endpoint Test Case ou + Add Test Scenario. Na janela pop-up de seleção, você pode alternar entre o modo Static ou Dynamic.

1. Modo Estático

O modo estático é usado para especificar com precisão os itens de teste que serão executados.

🎯 Lógica Principal

O sistema registra os IDs dos casos de teste específicos que você seleciona. Mesmo que novos casos de teste sejam adicionados à categoria de origem, o escopo de execução desta suite não será alterado, garantindo a controlabilidade dos resultados dos testes.

🚀 Melhores Cenários de Uso

Verificação de Correção de Bug (Hotfix): Selecione de 3 a 5 casos de teste fortemente relacionados ao bug, forme um "pacote de verificação" e verifique rapidamente o resultado da correção, sem perder tempo executando casos não relacionados.

Estabilização do Negócio Principal (Caminho Principal): Para processos extremamente essenciais e estáveis, como "pedido-pagamento". Não queremos que alertas de monitoramento sejam acionados porque um recém-chegado adicionou acidentalmente um caso de teste incompleto.

Teste de Compatibilidade com Versões Antigas: Selecione um lote de casos de teste de endpoints antigos especificamente para verificar a compatibilidade de clientes de versões antigas.

⚠️ Características de Manutenção

Alto Custo de Manutenção: Se novos casos precisarem ser incluídos neste teste especializado, eles deverão ser adicionados manualmente.

2. Modo Dinâmico

O modo dinâmico é usado para filtrar automaticamente, por meio de regras, os itens de teste que serão executados.

🎯 Lógica Principal

O sistema salva "Regras de Filtro" (Escopo e Filtro). A cada execução, o sistema verifica todo o projeto em tempo real e inclui no plano de execução todos os casos mais recentes que atendem aos critérios.

🚀 Melhores Cenários de Uso

Teste de Regressão em Nível de Módulo: Defina a pasta "Central de Negociação" como a pasta de origem. Os testadores só precisam escrever novos casos na pasta, e a suite os incluirá automaticamente durante a execução.

Teste de Fumaça: Crie uma suite dinâmica com a regra Priority = P0. Execute antes de cada release para cobrir automaticamente todos os casos-chave marcados como P0.

Verificação de Iteração de Versão: Use o recurso de tags e defina a regra como Tag = v2.5.0. Após a conclusão do desenvolvimento, execute esta suite para verificar todos os novos recursos desta versão.

⚠️ Características de Manutenção

Custo de Manutenção Zero: Depois que as regras forem configuradas, não será necessário manter a própria suite posteriormente; basta manter os atributos dos casos (localização, tags, prioridade).

Ajustar a Ordem de Execução

O conteúdo importado será exibido em uma lista, e você poderá arrastar os itens da lista para ajustar a ordem de execução.

Para itens adicionados "estaticamente", você pode usar Edit para excluir casos de teste individualmente ou excluir o grupo inteiro.

Para grupos adicionados "dinamicamente", você só pode excluir o grupo inteiro ou editar os critérios de filtro, e não pode excluir itens individuais dentro do grupo.

Configuração Avançada

No lado direito da página de design da suite de testes, você pode expandir Advanced Config para ter um controle mais granular sobre como a suite de testes é executada.

Ambiente

Definição: Por padrão, herda o ambiente de execução já definido na suite de testes. Se um ambiente for especificado aqui, essa configuração de ambiente terá prioridade durante a execução.

Caso de Uso: Adequado para cenários em que você precisa reutilizar o mesmo conjunto de etapas de teste em diferentes ambientes.

Dados de Teste

Usado para especificar se os dados de teste devem ser usados durante a execução.

Sem Dados de Teste: As etapas de teste são executadas apenas uma vez, sem executar testes orientados por dados.

Usar Dados de Teste: Executa várias vezes com base nos dados de teste, comumente usado para testes parametrizados.

Em Caso de Erro

Configure como o teste deve lidar com erros, que podem incluir falhas de assertivas, falhas de validação de formato de dados, exceções de requisição de endpoint, erros de servidor etc.

Ignorar: Continua executando as etapas subsequentes quando ocorre um erro, sem interromper a execução atual.

Continuar: Quando ocorre um erro, pula as etapas restantes da rodada atual e entra diretamente na próxima rodada de execução.

Encerrar execução: Encerra imediatamente as etapas subsequentes assim que ocorre um erro.

Iterações

Definição: O número de vezes que cada thread percorre todas as etapas em loop.

Caso de Uso: Comumente usado para verificação de estabilidade ou cenários simples de teste de carga.

Atraso

Definição: Defina quantos milissegundos (ms) aguardar após a conclusão de cada etapa de teste antes de executar a próxima etapa.

Caso de Uso: Evita acionar mecanismos de limitação de taxa ou circuit breaker no servidor de destino devido à alta frequência de requisições, garantindo uma execução de teste sem problemas.

Salvar Requisições/Respostas

Definição: Controla se o relatório de teste inclui dados detalhados de requisições e respostas (como Header, Body etc.).

Opções:

Todas: Salva os detalhes completos de todas as etapas, independentemente de aprovação/falha. Grande volume de dados, adequado para depuração aprofundada.

Somente com Falha: Salva apenas os detalhes das etapas que falharam durante a execução. Recomendado, economiza espaço de armazenamento e facilita a identificação rápida dos motivos da falha.

Não Salvar: Não salva nenhum detalhe; registra apenas o status de aprovação/falha e a duração.

Valores de Variáveis de Ambiente/Globais

Os valores de variáveis de ambiente/globais especificam quais valores reais usar para variáveis de ambiente/globais neste cenário de teste. Há duas opções. Informações detalhadas podem ser visualizadas aqui. Ao escolher usar valores de variáveis salvos no Runner, você precisará selecionar adicionalmente o escopo de variáveis a ser usado.

A finalidade desse escopo é ajudar os usuários a separar melhor as variáveis de acordo com necessidades reais, evitando situações em que a execução de uma tarefa agendada faça com que outras tarefas falhem devido a alterações de variáveis. Após selecionar o escopo, você também pode visualizar os valores das variáveis dentro desse escopo por meio da entrada que aparece na interface do produto.

Escopo de Variáveis no Runner	Ler/Gravar Variáveis de Ambiente/Globais	Descrição
Compartilhar apenas no cenário de teste atual	No Runner especificado atual, este cenário de teste tem um arquivo dedicado para armazenar persistentemente suas variáveis de ambiente/globais. Somente o cenário de teste atual pode ler e gravar variáveis neste arquivo.	O menor escopo de variáveis, com impacto mínimo. Adequado para casos em que os resultados da execução anterior deste cenário de teste precisam ser usados na próxima execução. Os arquivos de variáveis para cenários de teste, tarefas e pastas de tarefas são todos salvos no caminho do contêiner do Runner `/opt/runner/variables`.
Compartilhar entre todos os cenários de teste na tarefa agendada atual	No Runner especificado atual, a tarefa agendada tem um arquivo para armazenar variáveis de ambiente/globais que podem ser usadas em todos os seus cenários de teste. Todos os cenários de teste na tarefa agendada atual podem ler e gravar variáveis neste arquivo.	Um escopo de variáveis recomendado, com impacto moderado. Adequado para casos em que dados precisam ser compartilhados entre diferentes cenários de teste dentro da mesma tarefa agendada.
Compartilhar entre todas as tarefas agendadas na pasta de tarefas agendadas atual	No Runner especificado atual, a pasta de tarefas agendadas tem um arquivo para armazenar variáveis de ambiente/globais que podem ser usadas em todas as suas tarefas agendadas e cenários de teste. Todos os cenários de teste em todas as tarefas agendadas dentro da pasta atual podem ler e gravar variáveis neste arquivo.	O maior escopo de variáveis, com o impacto mais significativo. É possível que a execução de uma determinada tarefa agendada modifique o valor da variável, levando à falha de outras tarefas agendadas. Adequado quando os dados precisam ser compartilhados entre várias tarefas na mesma pasta.

Orquestrar Suite de Testes

Importar Conteúdo de Teste#

1. Modo Estático#

2. Modo Dinâmico#

Ajustar a Ordem de Execução#

Configuração Avançada#

Ambiente#

Dados de Teste#

Em Caso de Erro#

Iterações#

Atraso#

Salvar Requisições/Respostas#

Valores de Variáveis de Ambiente/Globais#