KEPLIN Docs

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.

Il minitab Test, con i test per cartella e il risultato dell'ultima esecuzione di ciascuno
Il minitab Test, con i test per cartella e il risultato dell'ultima esecuzione di ciascuno

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.