Apidog Docs
🇧🇷 Português (Brasil)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇧🇷 Português (Brasil)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇧🇷 Português (Brasil)
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Executar cenários de teste
  • Centro de Aprendizado da Apidog
  • Primeiros passos
    • Introdução ao Apidog
    • Conceitos básicos no Apidog
    • Navegando pelo Apidog
    • Início rápido
      • Visão geral
      • Criando um Endpoint
      • Fazendo uma Requisição
      • Adicionando uma assertiva
      • Criação de Cenários de Teste
      • Compartilhamento da documentação da API
      • Explore Mais
    • Migração para o Apidog
      • Visão geral
      • Importação Manual
      • Importação Agendada (Vincular Fontes de Dados)
      • Opções de importação
      • Exportar Dados
      • Importar de
        • Importar do Postman
        • Importar especificação OpenAPI
        • Importar cURL
        • Importar Markdowns
        • Importar do Insomnia
        • Importar do apiDoc
        • Importar arquivo .har
        • Importar WSDL
  • Dados de API mock
    • Visão geral
    • Smart Mock
    • Mock personalizado
    • Sequência de Prioridade do Mock
    • Scripts de Mock
    • Mock na Nuvem
    • Mock do Runner Auto-hospedado
    • Idioma do Mock (Locales)
  • Conta e preferências
    • Configurações da Conta
    • Geração de Token de Acesso OpenAPI
    • Notificação
    • Configurações de idioma
    • Teclas de Atalho
    • Configuração de Proxy de Rede
    • Backup de Dados
    • Atualizando o Apidog
    • Exclusão da conta
    • Recursos Experimentais
  • Enviar requisições
    • Visão geral
    • Depuração de SSE
    • Cliente MCP
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP ou WebService
    • GraphQL
    • gRPC
    • Use Agentes de Proxy de Requisição para Depuração
    • Criar requisições
      • Histórico de Requisições
      • Conceitos Básicos de Requisições
      • Parâmetros e Corpo
      • Cabeçalhos da Requisição
      • Configurações da Requisição
      • Depurar Requisições
      • Salvando Requisições como Endpoints
      • HTTP/2
    • Autenticação e autorização
      • Visão geral
      • Certificados de CA e de Cliente
      • Tipos de autorização
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Autenticação Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Resposta e cookies
      • Visualização de respostas de API
      • Gerenciamento de Cookies
      • Visão geral
  • Desenvolver e depurar APIs
    • Visão geral
    • Gerando Requisições
    • Envio de Requisições
    • Casos de Depuração
    • Casos de teste
    • Valores Dinâmicos
    • Validação de Respostas
    • Design-First vs Request-First
    • Geração de Código
    • Ambientes e variáveis
      • Visão geral
      • Usando variáveis
      • Gerenciamento de Ambientes
    • Segredos do cofre
      • Visão geral
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Módulos de valores dinâmicos
      • Airline
      • Animal
      • Cor
      • Comércio
      • Empresa
      • Banco de Dados
      • Tipo de dados
      • Data
      • Finanças
      • Comida
      • Git
      • Hacker
      • Helpers
      • Imagem
      • Internet
      • Localização
      • Lorem
      • Música
      • Número
      • Pessoa
      • Telefone
      • Ciência
      • String
      • Sistema
      • Veículo
      • Palavra
    • Pré e pós-processadores
      • Visão geral
      • Assertiva
      • Extrair Variável
      • Espera
      • Segurança
      • Operações de banco de dados
        • Visão geral
        • MySQL
        • MongoDB
        • Redis
        • Cliente Oracle
      • Uso de scripts
        • Visão geral
        • Scripts de Pré-processador
        • Scripts de Pós-processamento
        • Scripts Públicos
        • Referência de Scripts do Postman
        • Chamando Outras Linguagens de Programação
        • Usando bibliotecas JS
        • Visualização de Respostas
        • Exemplos de scripts
          • Scripts de assertiva
          • Usando Variáveis
          • Modificando Requisições
          • Outros exemplos
    • Depuração de APIs
      • AI Agent Debugger
      • A2A Debugger
  • Projetar APIs
    • Visão geral
    • Criar um Novo Projeto de API
    • Conceitos Básicos de Endpoint
    • Diretrizes de Design de API
    • Módulo
    • Configurar vários exemplos de corpo da requisição
    • Componentes
    • Campos Comuns
    • Parâmetros Globais
    • Histórico de Alterações do Endpoint
    • Comentários
    • Gerenciamento de Endpoints em Lote
    • API de Protocolo Personalizado
    • Modo Spec-first (Beta)
    • Esquemas de segurança
      • Visão geral
      • Criar um esquema de segurança
      • Usar o Security Scheme
      • Esquema de segurança na documentação online
    • Recursos avançados
      • Campos de Endpoint Personalizados
      • Cenários de Teste Associados
      • Status do endpoint
      • Aparência das Listas de Parâmetros
      • Identificação Única de Endpoint
    • Schemas
      • Visão geral
      • Criar um Novo Schema
      • Criar um Schema
      • Gerar schemas a partir de JSON etc.
      • oneOf, allOf, anyOf
      • Usando Discriminator
  • Branches
    • Visão geral
    • Criando uma Branch de Sprint
    • Testando APIs em uma Branch
    • Projetando APIs em uma branch
    • Mesclando branches de sprint
    • Gerenciando Branches de Sprint
    • AI Branch (Beta)
  • Testes de API
    • Visão geral
    • Cenários de teste
      • Criar um cenário de teste
      • Passar Dados Entre Requisições
      • Condições de Controle de Fluxo
      • Sincronizar dados de endpoints e casos de endpoint
      • Importar Endpoints e Casos de Endpoint de Outros Projetos
      • Exportar Cenários de Teste
    • Relatórios de teste
      • Relatórios de teste
    • Executar cenários de teste
      • Executar um cenário de teste
      • Executar cenários de teste em lote
      • Testes Orientados por Dados
      • Dados de Teste Compartilhados
      • Tarefas agendadas
      • Gerenciar o ambiente de execução de APIs de outros projetos
    • Suíte de testes
      • Visão geral
      • Criar Uma Suíte de Testes
      • Orquestrar Suite de Testes
      • Executar Suítes de Teste Localmente
      • Executar Suítes de Teste Via CLI
      • Tarefas agendadas
    • Testar APIs
      • Teste de integração
      • Teste de desempenho
      • Testes de Ponta a Ponta
      • Teste de regressão
      • Teste de Contrato
    • Apidog CLI
      • Visão geral
      • Instalando e executando o Apidog CLI
      • Opções da CLI do Apidog
    • CI/CD
      • Visão geral
      • Integrar com Github Actions
      • Integre com o Gitlab
      • Integrar com o Jenkins
      • Acionar teste por commit do Git
  • Publicar documentação de API
    • Visão geral
    • Tecnologias de API Suportadas
    • Compartilhamento rápido
    • Visualização da documentação da API
    • Documentação em Markdown
    • Publicação de sites de documentação
    • Página de login personalizada
    • Layouts Personalizados
    • CSS, JavaScript e HTML personalizados
    • Domínio Personalizado
    • Recursos de IA
    • Configurações de SEO
    • Configurações avançadas
      • Pesquisa na documentação
      • Proxy CORS
      • Integração com o Google Analytics
      • Configurações da Árvore de Pastas
      • Configurações de Visibilidade
      • Incorporação de valores em URLs de documentação
    • Versões da API
      • Visão geral
      • Criando versões de API
      • Publicação de Versões da API
      • Compartilhamento de Endpoints com Versões da API
  • Recursos de IA
    • Visão geral
    • Habilitando recursos de IA
    • Geração de Casos de Teste
    • Modificando esquemas com IA
    • Verificação de conformidade de endpoint
    • Verificação de Completude da Documentação da API
    • Nomeação de Campos com IA
    • Perguntas frequentes
  • Servidor MCP do Apidog
    • Visão geral
    • Conectar projeto Apidog à IA
    • Conectar documentação publicada à IA
    • Conectar Arquivos OpenAPI à IA
  • Boas práticas
    • Como lidar com assinaturas de API
    • Acessando APIs protegidas por OAuth 2.0
    • Fluxo de Trabalho de Colaboração
    • Gerenciamento do Estado de Autenticação
  • Espaço offline
    • Visão geral
  • Administração
    • Gerenciamento de projetos
      • Gerenciamento de Projetos
      • Configurações de notificação
      • Gerenciamento de membros do projeto
      • Recursos do projeto
        • Conexão com Banco de Dados
        • Conexão Git
    • Gerenciamento de equipes
      • Gerenciando equipes
      • Gerenciando membros da equipe
      • Atividades da Equipe
      • Funções e permissões da equipe
      • Recursos da equipe
        • General Runner
        • Variáveis de Equipe
        • Agente de Proxy de Requisições
      • Colaborações em tempo real
        • Colaboração em Equipe
    • Checklist de integração
      • Conceitos Básicos
      • Guia de Onboarding
    • Gerenciamento da organização
      • Gerenciamento de Organização
      • Funções e permissões da organização
      • Gerenciamento de planos
        • Gerentes de cobrança em organizações
      • Single Sign-On (SSO)
        • Visão geral do SSO
        • Configurando o Microsoft Entra ID
        • Configurando o Okta
        • Configurando SSO para uma organização
        • Gerenciamento de contas de usuário
        • Mapeamento de Grupos para Equipes
      • Provisionamento SCIM
        • Introdução ao provisionamento SCIM
        • Microsoft Entra ID
        • Okta
      • Recursos da organização
        • Runner Auto-Hospedado
  • Apidog Europe
    • Apidog Europe
  • Cobrança
    • Visão geral
    • Créditos
    • Atualizando seu plano
    • Métodos de Pagamento Alternativos
    • Gerenciamento de assinaturas
    • Movendo equipes pagas para organizações
  • Complementos
    • Hub de APIs
    • Plugin Apidog Intellij IDEA
    • Extensão do navegador
      • Chrome
      • Microsoft Edge
    • Proxy de requisições
      • Proxy de Requisição na Web
      • Proxy de Requisição em Documentação Compartilhada
      • Proxy de Requisição no Cliente
  • Dados e segurança
    • Armazenamento e Segurança de Dados
    • Privacidade e Segurança dos Dados do Usuário
    • Roteamento de Requisições e Segurança de Dados
  • Referências
    • Abordagem API Design-First
    • Extensões da especificação OpenAPI do Apidog
    • JSONPath
    • XPath
    • Expressões Regulares
    • JSON Schema
    • Formato de Arquivo CSV
    • Instalando o ambiente Java
    • Ambiente de Implantação do Runner
    • Sintaxe Markdown do Apidog
    • Extensões Swagger do Apidog
      • Visão geral
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Extensões JSON Schema do Apidog
      • Visão geral
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Central de suporte
  1. Executar cenários de teste

Dados de Teste Compartilhados

Em testes automatizados, muitos cenários de teste podem precisar usar os mesmos dados de teste, como informações de login de usuário, dados de produto ou parâmetros de configuração. O Apidog oferece suporte à criação de Dados de Teste Compartilhados que podem ser usados em vários cenários. Isso reduz o trabalho repetitivo, garante a consistência dos dados e torna o gerenciamento de recursos de teste mais eficiente.

Principais vantagens dos Dados de Teste Compartilhados:#

1.
Compartilhamento entre cenários: Mantenha um conjunto de dados de teste no nível do projeto para que vários cenários possam referenciá-lo.
2.
Gerenciamento unificado: Armazenamento centralizado de dados de teste; modificar em um único local atualiza todos os cenários que referenciam os dados.
3.
Garantia de consistência: Garante que diferentes cenários usem os mesmos dados base para evitar desvios nos resultados.
4.
Fluxo de trabalho padronizado: Estabelece padrões de dados de teste para melhorar a colaboração da equipe e a manutenibilidade do fluxo de trabalho de testes.

Criando Dados de Teste Compartilhados#

Método 1: Dados de Teste Estáticos#

1
No seu projeto, clique em Tests no menu à esquerda e selecione a aba Test Data.
image.png
2
Clique no botão Create Test Data (Static) e insira um nome.
image.png
3
Importe ou edite os dados manualmente. Há suporte para importações em CSV e JSON, edição manual de tabela ou geração em massa.
bulk-test-data-generation.gif
4
Clique em Save para criar dados de teste compartilhados.

Método 2: Conexão com banco de dados#

Isso permite que você extraia dados dinamicamente de um banco de dados, ideal para manter a consistência com dados do mundo real.
1
Na aba Test Data, clique em Create Test Data (Database).
image.png
2
Se nenhuma conexão com banco de dados estiver configurada no momento, clique em Set Data Source Config para adicionar ou selecionar um banco de dados.
3
Escreva uma consulta SQL para obter os dados de teste. Você também pode usar variáveis no SQL. Por exemplo:
creating-shared-data-using-database-connection.gif
4
Clique em Save para criar dados de teste compartilhados.
Depois que os dados são extraídos, eles permanecem estáticos até que você os atualize manualmente.
img_v3_02v9_77e7ef9f-11e8-4d44-9816-cede3a69d97g.jpg

Usando Dados de Teste Compartilhados em cenários#

Depois de criar dados de teste compartilhados, você pode referenciá-los em qualquer cenário de teste.
1
Acesse um Test Scenario e, no painel de configuração de execução, clique no menu suspenso Test Data para selecionar seus dados compartilhados.
image.png
2
Depois de referenciados, você pode usar os dados nas etapas de teste usando a sintaxe {{variable_name}}.
image.png

Gerenciando Dados de Teste Compartilhados#

Editando Dados de Teste Compartilhados#

Na lista "Dados de Teste Compartilhados", clique no nome de um dado para abrir a tela de edição. Você pode:
Alterar o nome dos dados
Adicionar, excluir ou editar linhas de dados
Adicionar ou remover colunas de dados (variáveis)
Importar novos dados para sobrescrever os dados existentes
Exportar os dados atuais como CSV ou JSON
Depois que você atualiza os dados de teste compartilhados, todos os casos de cenário que referenciam esses dados usam automaticamente os valores mais recentes — nenhuma sincronização manual é necessária.
Limites de edição para dados de teste compartilhados do tipo banco de dados:
O conteúdo dos dados é somente leitura; você não pode editar valores individuais diretamente
Há suporte para atualização manual: os dados são buscados novamente no banco de dados vinculado e sobrescrevem o conjunto atual
Você pode alterar o nome dos dados de teste
Você pode alterar as configurações de conexão com o banco de dados ou a consulta SQL

Configurando dados por ambiente#

Dados de teste compartilhados podem ser configurados por ambiente. Você pode manter um conjunto de dados separado para desenvolvimento, testes e outros ambientes; quando você alterna os ambientes, os dados desse ambiente são usados automaticamente.
image.png

Usando Dados de Teste Compartilhados em scripts#

Você pode acessar dados de teste compartilhados em scripts de pré-processador ou pós-processador:
O nome da variável deve corresponder ao nome da coluna nos dados de teste compartilhados.

Dados de Teste Compartilhados vs. Dados de Teste do Cenário#

ComparaçãoDados de Teste CompartilhadosDados de Teste do Cenário
Escopo dos dadosNível do projeto; pode ser usado por vários cenários de testeSomente o cenário de teste atual
Sincronização dos dadosAs alterações são aplicadas automaticamente a todos os cenários que os referenciamAfeta somente o cenário atual
Caso de usoDados base comuns, por exemplo, informações de usuário, dados de produtoDados específicos de um cenário
ManutençãoBaixa; gerenciada em um único localMais alta; mantida por cenário

Melhores práticas#

1. Use a granularidade de dados correta
Use dados de teste compartilhados para dados base altamente reutilizáveis; mantenha os dados específicos do cenário dentro do cenário.
2. Use nomes claros
Dê nomes descritivos aos dados de teste compartilhados (por exemplo, "Dados de login de usuário", "Dados da lista de produtos") para que a equipe possa entendê-los e escolhê-los facilmente.
3. Limpe dados não utilizados regularmente
Verifique periodicamente quais dados de teste compartilhados ainda são referenciados e remova os dados que não são mais usados para manter a lista organizada.
4. Use com variáveis de ambiente
Mantenha as configurações relacionadas ao ambiente (por exemplo, URLs, chaves) em variáveis de ambiente e os dados de negócio em dados de teste compartilhados para uma separação clara de responsabilidades.

Perguntas frequentes#

Qual é a diferença entre dados de teste compartilhados e variáveis de ambiente?
Variáveis de ambiente são mais adequadas para configuração (por exemplo, URL base da API, chaves), geralmente com um valor por variável. Dados de teste compartilhados são mais adequados para dados de negócio e oferecem suporte a várias linhas para testes orientados por dados. Você pode usar ambos em conjunto.
Alterar dados de teste compartilhados afeta testes que já estão em execução?
Não. Um teste em execução usa um snapshot dos dados do momento em que a execução foi iniciada. Suas alterações afetam apenas novas execuções de teste iniciadas depois disso.
Quantos registros os dados de teste compartilhados podem conter?
Dados de teste compartilhados oferecem suporte a um grande número de registros; o limite exato depende do plano da sua equipe. Recomenda-se manter cada conjunto de dados em um tamanho razoável (por exemplo, menos de 1000 linhas) para obter o melhor desempenho.
Modified at 2026-06-11 10:21:25
Previous
Testes Orientados por Dados
Next
Tarefas agendadas
Built with