KEPLIN Docs

Escrever um teste

Criar um teste, arrastar passos da paleta, escolher os alvos arrastando widgets, verificar respostas de APIs, e usar variáveis.

Um teste escreve-se no seu separador: a paleta dos passos à esquerda, a lista dos passos ao meio, e à direita o que se arrasta para os passos (os widgets do ecrã, os ecrãs e a resposta da última chamada a uma API).

O editor de um teste: a paleta, os passos e os widgets do ecrã para arrastar
O editor de um teste: a paleta, os passos e os widgets do ecrã para arrastar

Criar um teste

  1. No minitab Testes, carregue em Novo teste.
  2. Escolha o Tipo: Ecrã (abrir, clicar, preencher, ver), API (chamar e verificar a resposta), Script (executar e verificar o resultado) ou Workflow (arrancar, decidir tarefas, seguir).
  3. Escolha o que testar, numa lista em árvore com pesquisa: o ecrã, a API e a Operação (Ler, Contar, Criar, Alterar, Apagar ou Chamar), o script ou o workflow.
  4. O Nome vem do que escolheu, por exemplo «Abrir Contas» ou «Criar em Contas». Mude-o, se quiser.
  5. A Pasta proposta é a dos testes do mesmo tipo. Escolha outra, se quiser.
  6. Carregue em Criar. O teste nasce com os passos e a verificação, e um teste pode depois misturar passos de qualquer tipo.

O diálogo Novo teste
O diálogo Novo teste

Juntar passos

  • Arraste um passo da paleta para a lista, para o sítio exacto onde o quer. Uma linha mostra onde vai entrar.
  • Ou carregue num passo da paleta: entra no fim da lista.
  • Para reordenar, arraste um passo pela pega (os seis pontos à esquerda).
  • Para editar, carregue no passo: abre os campos dele.
  • Duplicar e Tirar estão à direita de cada passo.
  • Um Grupo junta passos; os passos arrastam-se para dentro dele.

A barra do teste tem ainda:

  • Como: o papel com que o teste começa. O teste entra na app com a conta escolhida para esse papel no ambiente de teste. Visitante (sem sessão) vê só o que é público.
  • O dispositivo: Web, Tablet ou Telemóvel.
  • Juntar dados de teste: os conjuntos que o teste carrega antes do primeiro passo.
  • Etiquetas, separadas por vírgulas (usam-se no portão da fusão).

Escolher o alvo de um passo de ecrã

Os passos de ecrã (Clicar, Preencher, Verificar texto…) actuam num widget. O alvo é o widget pelo identificador dele, por isso o teste não parte quando o widget muda de sítio ou de cor.

Há duas formas de escolher o alvo:

  • no campo Alvo do passo, escolha o widget na lista, que mostra os widgets do ecrã aberto pelo passo, com o texto que mostram;
  • ou, no painel da direita, separador Widgets, arraste o widget para o campo Alvo do passo.

Arrastar um widget para a lista dos passos (fora de um passo) cria um passo Verificar visível para ele.

Numa tabela, o alvo pode ser uma linha: escolha a coluna e escreva o valor que a identifica, por exemplo a coluna nome e o valor «Lusitânia Vinhos, Lda.». Em Texto dentro do widget, escolhe-se um elemento pelo texto que mostra.

Os outros campos dos passos também se escolhem do que existe: os ecrãs, as APIs, os scripts, os workflows e os testes, a variável e o caminho da resposta, a tabela e as colunas, o passo do processo, a decisão, o ficheiro e a tecla. As linhas a inserir preenchem-se numa grelha, e as condições fazem-se com o construtor de condições.

Os passos

Grupo Passos
Ecrã Abrir ecrã, Clicar, Preencher, Escolher opção, Marcar, Enviar ficheiro, Carregar numa tecla, Voltar
Verificar no ecrã Verificar texto, Verificar valor, Verificar visível, Verificar ligado, Verificar n.º de linhas, Verificar mensagem, Verificar ecrã aberto
APIs e scripts Chamar API, Executar script
Verificar o resultado Verificar resposta, Verificar erro, Verificar duração, Verificar registo
Dados Verificar linhas na base, Inserir linhas, Consultar SQL, Carregar dados de teste
Workflows Arrancar workflow, Verificar tarefa, Decidir tarefa, Avançar o tempo, Verificar passo, Verificar notificação
Contexto Mudar de papel, Mudar de dispositivo, Definir variável
Controlo Grupo, Usar outro teste

As verificações de ecrã esperam até ao tempo limite do passo que o ecrã fique como se espera: os ecrãs carregam dados aos poucos, e não há passos de pausa.

Os operadores das verificações são os do construtor de condições: é igual a, é diferente de, contém, não contém, maior do que, maior ou igual a, menor do que, menor ou igual a, está vazio, não está vazio, é um de e corresponde a.

Testar uma API

  1. Junte o passo Chamar API.
  2. Escolha a API e a Operação. Conforme a operação, escolha os Campos a devolver, o Filtro (com o construtor de condições), os Valores a gravar ou a Chave do registo. A operação GraphQL monta-se na execução, como o runtime a chama.
  3. Em Guardar em, dê um nome à resposta, por exemplo resposta.
  4. Execute o teste uma vez. No painel da direita, separador Resposta, aparece a resposta em árvore.
  5. Arraste um campo da resposta para a lista: nasce um passo Verificar resposta com esse caminho e o valor que tinha.

A resposta de uma API em árvore, com os campos para arrastar para uma verificação
A resposta de uma API em árvore, com os campos para arrastar para uma verificação

Os caminhos escrevem-se como data.getContas[0].nome. Com [*], a verificação vale para todas as linhas: data.getContas[*].sector é igual a «Indústria» só passa se todas as contas forem da Indústria.

Variáveis

Os valores dos passos aceitam variáveis entre chavetas duplas:

Variável Valor
{{nome}} O que um passo anterior guardou em Guardar em com esse nome.
{{resposta.data.getContas[0].id}} Um caminho dentro do que foi guardado.
{{run.short}} Um código único por execução, para valores que não se podem repetir.
{{hoje}} e {{agora}} A data de hoje e o momento actual.
{{gerar.nif}}, {{gerar.email}}, {{gerar.numero}}, {{gerar.texto}} Valores válidos inventados, sem dados pessoais.

Gravar e executar

Gravar guarda o teste. Executar grava as alterações e executa o teste: cada passo mostra como ficou, e o que falhou mostra o Esperado e o Obtido. Ver Executar e ler os resultados.

Perguntas frequentes

O teste passou, mas o passo de verificação estava vazio. Uma verificação contém com o valor vazio passa sempre. Confirme o campo Valor de cada verificação.

Posso reaproveitar passos noutro teste? Sim: o passo Usar outro teste executa os passos de outro teste nesse sítio, por exemplo um teste «Entrar como direcção».