O ambiente de teste
Onde os testes escrevem cada base de dados, o datasource de teste das bases externas com escrita, os utilizadores de teste, as respostas HTTP simuladas, o portão da fusão, a execução agendada e os limites.
O ambiente de teste diz onde os testes escrevem, com que contas entram na app e o que acontece aos efeitos para fora da app. Abre-se no minitab Testes, no botão Ambiente de teste.

Nota
Só um administrador muda o ambiente de teste. Um developer vê-o.
Bases de dados
Cada datasource da app aparece com o tipo, o acesso e o que acontece nos testes:
| Datasource | Nos testes |
|---|---|
| Base interna da app | Uma cópia nova com o esquema da base, em cada teste. |
| PostgreSQL interno | Uma base temporária no servidor gerido, com o esquema da real, em cada teste. |
| Base externa com escrita (Leitura e escrita ou Estrutura protegida) | O datasource de teste escolhido, obrigatório. As tabelas dos dados de teste esvaziam-se antes de cada teste. |
| Base externa em Só leitura | A base real, só para ler. Os testes lêem-na e nunca escrevem nela. |
O datasource de teste das bases externas
Uma base externa com escrita não se pode copiar a cada teste. Os testes usam outro datasource da app, ligado a uma base de teste com a mesma estrutura. As ligações criam-se sempre nos datasources, na secção Dados, e o ambiente de teste só escolhe qual usar.
- Na secção Dados, crie um datasource do mesmo tipo, com escrita, ligado à base de teste. Também pode ser um datasource interno.
- Abra o Ambiente de teste.
- Na linha da base externa, carregue em Escolher o datasource de teste e escolha-o da lista.
- Carregue em Gravar.
O estado passa a pronta. Na linha do datasource escolhido, o ambiente diz de que base é o datasource de teste, e os testes usam-no tal como está.
Atenção
Enquanto uma base externa com escrita não tiver o datasource de teste escolhido, nenhum teste da app é executado, nem os que parecem não usar essa base. Um teste chega a qualquer base da app através de um ecrã, de uma API ou de um script, e não há forma segura de saber antes de executar a que bases chega. A execução fica Bloqueada e diz qual base falta.
Uma base externa em Só leitura não precisa de datasource de teste: os testes lêem a base real, e a plataforma recusa qualquer escrita nela, como já faz fora dos testes. A garantia total é ligar essa base com um utilizador que só tenha permissões de leitura.
Utilizadores de teste
Um teste que começa como um papel entra na app com a conta escolhida aqui para esse papel, com todos os papéis dessa conta.
- Em Utilizadores de teste, na linha do papel, carregue em Escolher o utilizador.
- Procure e escolha uma conta activa que tenha esse papel. Sem utilizador desfaz a escolha.
- Carregue em Gravar.
Só se escolhem contas que já existem: as contas e os papéis dão-se em Definições da app › Utilizadores da app. A linha Visitante não tem conta: um teste sem papel não tem sessão e vê só os ecrãs e as APIs públicas, como quem abre a app sem entrar.
Cada linha diz quantos testes usam esse papel. Um teste com um papel sem conta escolhida falha com «O papel … não tem utilizador de teste».
Respostas HTTP simuladas
Nos testes, um pedido HTTP de uma API ou de um workflow nunca sai para a rede: recebe a resposta simulada cujo endereço seja o início do endereço do pedido (e o método, se o disser). Um pedido sem resposta simulada falha o passo com o endereço, para se saber o que falta simular.
Para juntar uma, carregue em Juntar resposta e preencha o método, o
endereço (por exemplo https://api.exemplo.pt/v1/), o código e o corpo.
Nota
Os scripts fazem os pedidos no seu próprio processo e não passam pelas respostas simuladas.
Quando são executados sozinhos
- Antes de fundir no main: com o portão ligado, fundir uma versão no main executa primeiro os testes com as etiquetas indicadas (ou todos, sem etiquetas) na versão de origem. Se não passarem, nada se funde. Ver Executar e ler os resultados.
- Executar todos os testes à hora desta expressão cron: a execução
agendada, por exemplo
0 2 * * *(todas as noites às 02:00). Precisa de o agendador da plataforma estar ligado.
Limites
- Segundos por passo: quanto um passo pode demorar (e quanto uma verificação de ecrã espera). Por omissão, 30.
- Minutos por execução: quanto uma execução pode demorar. Por omissão,