Linha RM

Atalhos

Páginas filhas
  • 2.3.3 - Script SQL

O que é?

A Atividade de Script SQL permite executar sentenças SQL diretamente em uma base de dados durante a execução de um Projeto de Teste. É utilizada para realizar operações como inclusão, alteração, ou exclusão de dados, facilitando a construção e a preparação de cenários de teste.

Para que serve?

Essa atividade serve para interagir com o banco de dados em um contexto de testes, possibilitando manipulação de dados de forma automatizada. Pode ser usada para:

  • Alterar informações de uma base de dados em uma coligada específica.
  • Ajustar parâmetros da base onde serão executados os scripts automatizados.
  • Manipular registros para preparar ou validar cenários de teste.

Exemplo de Uso 

     1. Navegue no menu do TestFlow e clique em: Atividades → Banco de Dados→ Script SQL. 

     2. Na tabela que será mostrada, clique no botão verde em destaque para iniciar o cadastro.

    Clique aqui para obter as informações do cabeçalho

    Especifica a versão da atividade em questão. O objetivo de versionar uma atividade é para quando necessitamos ter mais de uma atividade em versões diferentes. Isso irá nos auxiliar a ter um histórico de atualizações e assegurar que as mudanças feitas sejam rastreáveis e reversíveis, se necessário.

    Se for necessário utilizar mais de uma versão do RM no seu ambiente, é recomendado que a versão da atividade seja compatível com o sistema RM em uso. Caso contrário, pode-se optar por uma versão padrão de sua preferência.

    Exemplo utilizando a versão do RM

    Exemplo utilizando a versão padrão

    Fornece uma descrição detalhada da atividade, explicando seu propósito e operações, facilitando a compreensão e manutenção futura.

    Escolha o tipo do seu banco de dados: 

    1. SQL;
    2. Oracle

    O campo Cenário define onde a sentença SQL será executada durante a execução do projeto de teste. Existem duas opções:

    Contexto: Quando selecionado o cenário Contexto, a sentença SQL será executada diretamente na base de dados restaurada durante o Projeto de Teste. Ou seja, a base de dados configurada previamente no fluxo do projeto será utilizada como o ambiente para a execução do script SQL.

    • Uso: Ideal quando o projeto envolve a restauração de uma base específica antes da execução do script SQL.

    Utilizado em testes que dependem da base de dados já definida no projeto.

    Específico: .Ao escolher o cenário Específico, a sentença SQL será executada em uma base de dados informada manualmente. Nesse caso, é necessário fornecer a String de Conexão com os detalhes do banco de dados onde o comando SQL será executado, independentemente do banco restaurado pelo Projeto de Teste.

    • Uso: Utilizado quando a execução precisa ocorrer em uma base de dados diferente da restaurada pelo projeto.

    Recomendado para cenários onde o script SQL deve ser executado em um banco externo ou dedicado.

    Caso a opção selecionada anteriormente for Usar Contexto, escreva os parâmetros de conexão com o banco de dados que será utilizado para executar o ScriptSQL na base de dados

    Os parâmetros mais comuns são:

    • Data Source: SERVIDOR DO BANCO
    • User ID: USUÁRIO DE CONEXÃO
    • Password: SENHA DE CONEXÃO

    Estes parâmetros devem ser informados separados por ponto e vírgula.

    Se preferir não criar a string manualmente, você pode utilizar o Gerador de Strings de Conexão disponível ao lado deste campo. Basta abri-lo, selecionar a opção +PADRÃO SQLSERVER, preencher os valores e salvar para criar sua conexão.

    Caso precise adicionar parâmetros adicionais à sua string de conexão, clique no botão +Adicionar Parâmetro. 

    Além disso, também é possível excluir qualquer parâmetro adicionado anteriormente clicando no ícone 

    Utilize esse campo para escrever o Script Sql que deve ser executado na sua base.

    Evite utilizar em suas sentenças a expressão SELECT * FROM TABELA, uma vez que o uso de uma sentença tão genérica pode causar problemas, como por exemplo:

    1. Campos novos forem criados e seu script não for atualizado.
    2. Se sua tabela contiver campos que não são fixos, ou seja, que atualizam o seu valor no momento da criação ou edição. Campos como: Data de criação, Data de Atualização, Data de Deleção.

    Usar contexto: O script Sql fornecido será na base restaurada pelo projeto de teste.

    Usar bases específicas: O Script será executado na base de teste que foi informada na string de conexão.

    As variáveis de ambiente na comparação de arquivos no TestFlow são utilizadas para configurar e personalizar o comportamento da atividade de comparação. Elas permitem definir valores específicos que podem ser usados durante a execução dos testes, assegurando que a comparação ocorra conforme o ambiente em que o teste está sendo executado.

    Consulte as variáveis de ambiente permitidas nessa Atividade:

    Script SQl - Variáveis de Ambiente.

    Saiba mais sobre Ambientes.

    Imagine que um analista precisa validar um processo em um ambiente de testes do RM. Antes de executar o teste, é necessário atualizar alguns parâmetros específicos na base de dados, como habilitar uma funcionalidade que está sendo testada ou limpar registros antigos que poderiam interferir nos resultados.

    Solução: Usar a Atividade de Script SQL para inserir, atualizar ou excluir dados da base de testes, garantindo que a configuração necessária esteja pronta para o teste.

    Saiba mais

    Você pode montar a string de conexão de três maneiras: 1 - Digitando manualmente a string; 2 - Através do gerador de conexão informando os campos necessários; 3 - Através do gerador de conexão carregando o padrão do SQLServer.

    A atividade suporta o uso de variáveis de ambiente para configurar e personalizar a execução de scripts SQL. Isso é útil para adaptar a execução a diferentes configurações e cenários, sem a necessidade de alterar o código do script.

    FAQ

    P: Como posso garantir que meu script SQL seja seguro e eficiente?

    R: Sempre teste suas sentenças SQL em um ambiente de desenvolvimento antes de executá-las em produção. Use cláusulas WHERE quando necessário e evite SELECT * em tabelas grandes. Garanta que suas consultas não afetem todos os registros da tabela por engano.

    P: Qual a melhor prática para usar o Script SQL em testes de parâmetros no RM?

    R: Ao utilizar o Script SQL para definir parâmetros no RM, é importante lembrar que muitos processos do RM trabalham com cache. Insira o Script SQL após a Atividade de Restauração de Base e antes da Atividade que irá subir o Host do RM, garantindo que os parâmetros sejam atualizados corretamente.

    P: Qual o impacto de rodar um Script SQL sem a Atividade de Restauração de Base no início do teste?

    R: Se o banco de dados não for restaurado antes da execução do script, os dados podem estar em um estado inconsistente, o que pode comprometer os resultados do teste. É sempre recomendado rodar a Atividade de Restauração de Base antes do Script SQL, especialmente em ambientes de teste que dependem de um estado inicial limpo.

    • Sem rótulos