KEPLIN Docs

Le projet de tests

Ce que sont les tests d'une app, où ils vivent, comment ils s'exécutent sans toucher aux données réelles, et le minitab Tests.

Chaque app a son projet de tests : un ensemble de tests automatiques qui dit, après chaque modification, si ce qui fonctionnait fonctionne toujours. Un test est une liste d'étapes, comme ouvrir un écran, remplir un champ, cliquer sur un bouton et vérifier ce qui s'affiche, et il se construit comme le reste de la plateforme : en faisant glisser et en choisissant.

Il y a quatre types de test, et un test peut mélanger des étapes de tous :

Type Ce qu'il vérifie Exemple
Écran Le parcours d'un utilisateur : ouvrir, remplir, cliquer, vérifier. Créer un nouveau compte et voir la ligne dans le tableau.
API Une opération GraphQL de l'app : la réponse, le temps, l'effet sur les données. getContas ne renvoie que les comptes de l'Industrie, en moins de 500 ms.
Script L'exécution d'un script : ce qu'il renvoie et ce qu'il écrit. Le script de synchronisation crée trois contacts.
Workflow Le parcours d'un processus : tâches, décisions, notifications. Une demande de plus de 10 jours va à la direction et, approuvée, prévient le demandeur.

Le minitab Tests, avec les tests par dossier et le résultat de la dernière exécution de chacun
Le minitab Tests, avec les tests par dossier et le résultat de la dernière exécution de chacun

Où vivent les tests

Les tests font partie de l'app, comme les écrans et les API :

  • ils se trouvent dans chaque version de l'app, et fusionnent avec les autres modifications lors du merge (voir Historique et merge) ;
  • ils apparaissent dans l'historique de l'app, avec qui les a modifiés ;
  • ils voyagent dans l'export de l'app et entrent dans les modèles ;
  • ils ont un checkout, comme les autres documents : deux personnes n'enregistrent pas le même test en même temps.

Ce qui reste uniquement sur cette installation, ce sont les résultats des exécutions (conservés 30 jours).

Comment ils s'exécutent sans toucher aux données réelles

Chaque test s'exécute dans un nouvel environnement de test, créé pour lui et supprimé à la fin :

  • Les bases de données sont des copies de test. Une base interne de l'app commence avec la même structure que la réelle, sans lignes, et reçoit les données de test. Ce qu'un test enregistre n'atteint ni la base réelle ni le test suivant.
  • Les comptes sont ceux que vous choisissez dans l'environnement de test, un par rôle, parmi les comptes de l'app. Un test sans rôle est un visiteur, sans session, et ne voit que ce qui est public.
  • Les e-mails et les notifications restent retenus dans le test, pour que le test les vérifie, et ne sortent jamais.
  • Les requêtes HTTP des API et des workflows reçoivent les réponses simulées de l'environnement de test, et ne sortent jamais vers le réseau.
  • Les erreurs qu'un test provoque n'apparaissent pas dans le Radar et ne déclenchent pas d'alertes.

Attention

Une base de données externe en écriture (la base d'un ERP, par exemple) ne se copie pas : les tests utilisent un autre datasource de l'app, le datasource de test, que l'on choisit dans l'environnement de test. Tant qu'il manque, aucun test de l'app ne s'exécute. Voir L'environnement de test.

Le minitab Tests

Les tests sont dans le minitab Tests de l'arborescence de l'app, entre Données et Radar. Les minitabs n'affichent que l'icône : passez la souris dessus pour voir le nom.

Le panneau contient :

  • Tests : les tests par dossier, chacun avec le résultat de sa dernière exécution (vert réussi, rouge échoué, vide pas encore exécuté). Pour changer un test de dossier, faites-le glisser sur le dossier.
  • Données de test : les ensembles de lignes que chargent les tests.
  • Exécutions : les exécutions récentes ; en ouvrir une affiche le résultat.
  • Instables : les tests qui réussissent et échouent alternativement.

En haut se trouvent la recherche, Nouveau test, Nouveau dossier de tests, Environnement de test et Exécuter tous les tests.

Questions fréquentes

Pourquoi « Les tests ne s'exécutent pas » apparaît-il ? L'app a une base externe en écriture sans datasource de test. Ouvrez l'Environnement de test et choisissez-le, ou demandez-le à un administrateur.

Un test peut-il abîmer les données réelles ? Non. Les tests n'écrivent que dans les copies de test. La seule base réelle qu'un test lit est une base externe en Lecture seule, et sur celle-ci la plateforme refuse toute écriture.

Qui peut écrire et exécuter des tests ? Les personnes qui ont le profil Developer sur l'app. Seul un administrateur change l'environnement de test.