Post original blog “Sem Bugs (créditos Elias Nogueira)

Selenium IDE com Data Driven? Sim, isto agora é possível!

Observações iniciais
Eu sempre tive uma postura de um profisisonal, quando em aprendizado do Selenium, aprender o IDE a fins educativos e de primeiro passo da automação (record & play), de usar e propor aos profisisonais e alunos que me procuram a usar o Selenium RC para fazer testes que exigem bem mais do que o IDE: loops, controles, parametrização de dados, etc…
Mas desta vez resolvi postar sobre como fazer com que o Selenium IDE execute scrips Data Driven

ATENÇÃO: Este post é uma alteração do post original da SauceLabs[1]  que você pode acessar no link abaixo:
http://saucelabs.com/blog/index.php/2011/01/selenium-resources-for-newbs-data-driven-testing-with-ide-xml/

Ainda mantenho fortemente a minha postura: usem o Selenium RC com qualquer linguagem para usar todo o poder que essa ferramenta pode dar a você. Um dos principais motivos de escrever este post é de:

  • Eu gostar destas coisas novas e ficar brincando com os scripts
  • De ajudar os nossos amigos profissionais que ainda não sabem falar inglês e não poderiam entender o post original (e que devem levar um puxão de orelha por isso)
  • Para poder ajudar aqueles que estão aprendendo o Selenium IDE que, mesmo que este post ajude, você não vai poder fugir da programação para fazer coisas mais poderosas com a ferramenta

[1] Pra quem não sabe o criados da SouceLabs, que presta serviços de teste com Selenium nas nuvens, é um dos criadores do Selenium.

Ahh, e pra quem não sabe o que é Data Driven, é o “poder” de dar ao script a independência de dados através de parâmetros inseridos ao invés dos dados. Se você ainda não sabe o que é isso, Google!

O que você vai precisar!
Basicamente de um plugin e duas “user-extensions” do para o Selenium IDE.
Primeiro siga estes passos:

  1. Instale o plugin de Flow Control. Necessita de reinicio do Firefox
  2. Baixe a user-extension includeCommand4IDE na versão 1.1
  3. Baixe a user-extension datadriven.js, que está na versão 0.2

Clique nos links de cada item para baixá-lo!
Instalou o Flow Control e baixou as duas user-extensions? Faça o seguinte:

  1. Descompacte os aruqivos zips das respectivas user-extensions num diretório de sua escolha
  2. Adicione as duas user-extensions no Selenium IDE via menu Options/Options… clicando no botão browser parao item Selenium Core extensions (user-extension.js) (vide Possiveis Erros #1)
  3. Reinicie o Selenium IDE

Deu tudo certo? Maravilha! Vamos para os próximos passos!

Criar o arquivo XML de Massa de Dados!
Sim, para que seja possível fazer com que o script Selenese (script HTML do Selenium) esteja preparado para o Data Driven é necessário criar um arquivo XML que vai conter os dados que você vai utilizar!

Uma coisa muito importante é primeiro enterder o arquivo XML!

Entendendo o arquivo XML
Abaixo está um exemplo do arquivo XML que estou usando de exemplo:

A linha 1 possui a tag testdata. É ela que identifica que o arquivo XML é a tua massa de dados.

As linhas 2, 3 , 4 e 5 possuem a tag test. Cada tag test é um indício de massa de dados que você vai utilizar no script. Dentro desta tag existem atributos. No exemplo acima os atributos são nome e sobrenome. Estes atributos serão os parâmetros do seu script do Selenium, que irão no formato ${nomeAtributo}.
Neste caso eu tenho que colocar no meu script os parâmetros ${nome} e ${sobrenome} sem precisar criá-los anteriormente no script.

A linha 6 fecha a tab do testdata

Cada atributo tem um valor e é este valor que vai ser substituito pelo parâmetro no script. Lindo né?

Você pode criar diversos test um para cada iteração do script que você necessita.

Agora aconselho fortemente ler os itens #2, #3 e #4 do “Possiveis Erros”

Script!! (êeeeee)
Agora veremos o script final sobre o exemplo e todos os comandos necessários para que ele funcione!

loadTestData file:///C:/selenium_datadriven/massa_dados.xml
open /arquivos_blog/selenium/datadriven/
while !testdata.EOF()
nextTestData
type nomePessoa ${nome}
type sobrenomePessoa ${sobrenome}
clickAndWait send
assertTextPresent Olá, ${nome} ${sobrenome}
clickAndWait link=Voltar
endWhile

Na linha 1 da tabela temos o comando que fará o carregamento da massa de dados com o comando loadTestData. Este comando é parte da user-extension datadriven.js.
Você obrigatoriamente deve iniciar o valor deste comando com ‘file:///‘ (sem as aspas simples) seguido pelo caminho do arquivo XML (como no exemplo)
Atenção, leia o #5 do Possíveis Problemas

Na linha 2 da tabela temos o velho conhecido comando open para a minha página de exemplo deste post

Na linha 3 da tabela temos o comando while, da user-extension FlowControl, que é responsável de fazer um loop no script. O valor deste comando é !testData.EOF() que traduzindo quer dizer: “enquanto o testData não terminar, ou seja, existam as tags test execute”. Ele que é responsável por controlar o número de execuções a partir das tags test existentes.

Na linha 4 da tabela existe o comando nextTestData que pertence a user-extension datadriven.js. É ela que validará que existam dados na massa de dados (arquivos XML para continuar executando o script)

Nas linhas 5, 6, 7, 8 e 9 existem os comandos básicos do Selenium para a interação com o exemplo. Aqui você precisa prestar muita atenção: ao invés de manter os valores fixos no script eu os substitui pelos parâmetro ${nome} e ${sobrenome}, que são os nomes dos atributos da tag test do XML da massa de dados, entendeu? É só colocar o mesmo nome e, acredite, ele preencherá com o valor.

Na linha 10 da tabela há a finalização do loop pelo comando endWhile que pertence a user-extension FlowControl.

Agora é só correr para o abraço!
Pronto, tudo está pronto para execução com sucesso!
Tu podes baixar o este exemplo por este link e testar ai!

Se você executares o exemplo que você acabou de baixar, lembre-se de colocar na Base URL o endereço http://eliasnogueira.info

Agora vamos falar sobre o exemplo:

Exemplo utilizado!
O exemplo é bem simples: consiste em um formulário de submissão de dados contendo o Nome e Sobrenome de uma pessoa. Após a submissão dos dados somos redirecionados para uma tela com a seguinte mensagem na página “Olá Fulano de Tal“, onde Fulano é o nome e de Tal é o sobrenome inserido!

A página do exemplo pode ser acessada no link abaixo:
http://eliasnogueira.info/arquivos_blog/selenium/datadriven/index.php

Observação: cuidado para este item não confundir você, mas se for criar um script sobre uma página ajax ou não quer clicar em algum link de voltar, utilize o comando goBackAndWait antes do comando endWhile. Este comando fará com que o script emule o “voltar” do browser.

Possíveis Erros

  1. Se você não colocar as extensões no lugar certo receberá a seguinte mensagem logo que abrir o Seleium IDE: “error loading Selenium IDE extensions: ReferenceError: Selenium is not defined”. Então garanta que você colocou no campo certo (olhe a imagem)
  2. Elias, posso mudar o nome da tag testdata? Resposta: não! Sem esta tag o script não roda, é obrigatória!
  3. Elias, posso mudar o nome da tag test? Resposta: não! Sem esta tag o script não roda, é obrigatória!
  4. Elias, posso utilizar parâmetros diferentes entre os testes? Resposta: Sim! desde que os parâmetros obrigatórios estejam la. Se tu não entendeu, deixe todos iguais e o script vai rodar sem erros!


Abraço a todos vocês e bom divertimento!