Il progetto di test
Cosa sono i test di un'app, dove vivono, come vengono eseguiti senza toccare i dati reali, e il minitab Test.
Ogni app ha il suo progetto di test: un insieme di test automatici che dice, dopo ogni modifica, se ciò che funzionava funziona ancora. Un test è un elenco di passi, come aprire una schermata, compilare un campo, cliccare un pulsante e verificare ciò che appare, e si costruisce come il resto della piattaforma: trascinando e scegliendo.
Ci sono quattro tipi di test, e un test può combinare passi di tutti:
| Tipo | Cosa verifica | Esempio |
|---|---|---|
| Schermata | Il percorso di chi usa l'app: aprire, compilare, cliccare, verificare. | Creare un nuovo account e vedere la riga nella tabella. |
| API | Un'operazione GraphQL dell'app: la risposta, il tempo, l'effetto sui dati. | getContas restituisce solo account dell'Industria, in meno di 500 ms. |
| Script | L'esecuzione di uno script: cosa restituisce e cosa scrive. | Lo script di sincronizzazione crea tre contatti. |
| Workflow | Il percorso di un processo: attività, decisioni, notifiche. | Una richiesta oltre i 10 giorni va alla direzione e, approvata, avvisa chi l'ha fatta. |

Dove vivono i test
I test fanno parte dell'app, come le schermate e le API:
- stanno in ogni versione dell'app, e si uniscono alle altre modifiche nel merge (vedi Cronologia e merge);
- appaiono nella cronologia dell'app, con chi li ha modificati;
- viaggiano nell'esportazione dell'app ed entrano nei modelli;
- hanno il checkout, come gli altri documenti: due persone non salvano lo stesso test nello stesso momento.
Quello che resta solo in questa installazione sono i risultati delle esecuzioni (conservati 30 giorni).
Come vengono eseguiti senza toccare i dati reali
Ogni test viene eseguito in un ambiente di test nuovo, creato per lui ed eliminato alla fine:
- I database sono copie di test. Un database interno dell'app parte con la stessa struttura di quello reale, senza righe, e riceve i dati di test. Ciò che un test salva non arriva al database reale né al test successivo.
- Gli account sono quelli che scegli nell'ambiente di test, uno per ruolo, tra gli account dell'app. Un test senza ruolo è un visitatore, senza sessione, e vede solo ciò che è pubblico.
- Le email e le notifiche restano trattenute nel test, perché il test le verifichi, e non escono mai.
- Le richieste HTTP delle API e dei workflow ricevono le risposte simulate dell'ambiente di test, e non escono mai verso la rete.
- Gli errori che un test provoca non appaiono nel Radar e non generano avvisi.
Attenzione
Un database esterno con scrittura (il database di un ERP, per esempio) non si copia: i test usano un altro datasource dell'app, il datasource di test, che si sceglie nell'ambiente di test. Finché manca, nessun test dell'app viene eseguito. Vedi L'ambiente di test.
Il minitab Test
I test sono nel minitab Test dell'albero dell'app, tra Dati e Radar. I minitab mostrano solo l'icona: passaci sopra il mouse per vedere il nome.
Il pannello ha:
- Test: i test per cartella, ognuno con il risultato dell'ultima esecuzione (verde superato, rosso fallito, vuoto non ancora eseguito). Per spostare un test di cartella, trascinalo sulla cartella.
- Dati di test: gli insiemi di righe che i test caricano.
- Esecuzioni: le esecuzioni recenti; aprirne una mostra il risultato.
- Instabili: i test che passano e falliscono alternativamente.
In alto ci sono la ricerca, Nuovo test, Nuova cartella di test, Ambiente di test ed Esegui tutti i test.
Domande frequenti
Perché appare «I test non vengono eseguiti»? L'app ha un database esterno con scrittura senza datasource di test. Apri l'Ambiente di test e sceglilo, oppure chiedilo a un amministratore.
Un test può rovinare i dati reali? No. I test scrivono solo nelle copie di test. L'unico database reale che un test legge è un database esterno in Sola lettura, e su quello la piattaforma rifiuta qualsiasi scrittura.
Chi può scrivere ed eseguire test? Chi ha il profilo Developer nell'app. L'ambiente di test lo cambia solo un amministratore.