Het testproject
Wat de tests van een app zijn, waar ze staan, hoe ze draaien zonder de echte gegevens aan te raken, en de minitab Tests.
Elke app heeft een eigen testproject: een reeks automatische tests die na elke wijziging laat zien of wat werkte nog steeds werkt. Een test is een lijst stappen, zoals een scherm openen, een veld invullen, op een knop klikken en controleren wat er verschijnt, en hij wordt gebouwd zoals de rest van het platform: door te slepen en te kiezen.
Er zijn vier soorten tests, en een test kan stappen van allemaal combineren:
| Type | Wat hij controleert | Voorbeeld |
|---|---|---|
| Scherm | Het pad van een gebruiker door de app: openen, invullen, klikken, controleren. | Een nieuw account maken en de rij in de tabel zien. |
| API | Een GraphQL-bewerking van de app: het antwoord, de tijd, het effect op de gegevens. | getContas geeft alleen accounts uit de industrie terug, in minder dan 500 ms. |
| Script | De uitvoering van een script: wat het teruggeeft en wat het schrijft. | Het synchronisatiescript maakt drie contacten aan. |
| Workflow | Het pad van een proces: taken, beslissingen, meldingen. | Een aanvraag van meer dan 10 dagen gaat naar de directie en meldt na goedkeuring de aanvrager. |

Waar de tests staan
Tests horen bij de app, net als schermen en API's:
- ze staan in elke versie van de app en worden bij de merge samengevoegd met de andere wijzigingen (zie Geschiedenis en merge);
- ze verschijnen in de geschiedenis van de app, met wie ze heeft gewijzigd;
- ze reizen mee in de export van de app en komen in sjablonen;
- ze hebben checkout, zoals de andere documenten: twee mensen slaan niet tegelijk dezelfde test op.
Alleen op deze installatie blijven de resultaten van de runs (30 dagen bewaard).
Hoe ze draaien zonder de echte gegevens aan te raken
Elke test draait in een nieuwe testomgeving, die voor de test wordt gemaakt en aan het einde wordt verwijderd:
- De databases zijn testkopieën. Een interne database van de app begint met dezelfde structuur als de echte, zonder rijen, en krijgt de testgegevens. Wat een test opslaat, bereikt de echte database en de volgende test niet.
- De accounts zijn de accounts die u in de testomgeving kiest, één per rol, uit de accounts van de app. Een test zonder rol is een bezoeker, zonder sessie, en ziet alleen wat openbaar is.
- E-mails en meldingen blijven in de test vastgehouden, zodat de test ze kan controleren, en gaan nooit naar buiten.
- HTTP-verzoeken van de API's en workflows krijgen de gesimuleerde antwoorden van de testomgeving en gaan nooit het netwerk op.
- De fouten die een test veroorzaakt, verschijnen niet in de Radar en leveren geen waarschuwingen op.
Let op
Een externe database met schrijfrechten (de database van een ERP, bijvoorbeeld) wordt niet gekopieerd: de tests gebruiken een andere datasource van de app, de testdatasource, die u in de testomgeving kiest. Zolang die ontbreekt, wordt geen enkele test van de app uitgevoerd. Zie De testomgeving.
Het minitab Tests
De tests staan in het minitab Tests van de app-boom, tussen Data en Radar. De minitabs tonen alleen het pictogram: ga er met de muis overheen om de naam te zien.
Het paneel heeft:
- Tests: de tests per map, elk met het resultaat van de laatste run (groen geslaagd, rood mislukt, leeg nog niet uitgevoerd). Om een test naar een andere map te verplaatsen, sleept u hem naar de map.
- Testgegevens: de sets rijen die de tests laden.
- Runs: de recente runs; een run openen toont het resultaat.
- Instabiel: de tests die afwisselend slagen en mislukken.
Bovenaan staan de zoekfunctie, Nieuwe test, Nieuwe testmap, Testomgeving en Alle tests uitvoeren.
Veelgestelde vragen
Waarom verschijnt „De tests worden niet uitgevoerd”? De app heeft een externe database met schrijfrechten zonder testdatasource. Open de Testomgeving en kies die, of vraag het een beheerder.
Kan een test de echte gegevens beschadigen? Nee. Tests schrijven alleen in de testkopieën. De enige echte database die een test leest, is een externe database met Alleen lezen, en daar weigert het platform elke schrijfactie.
Wie kan tests schrijven en uitvoeren? Wie het profiel Developer in de app heeft. Alleen een beheerder wijzigt de testomgeving.