Een handmatige test kan echt iets veranderen
Een knop met “Execute workflow” is geen afgescheiden proeftuin. n8n beschrijft handmatige uitvoeringen als een manier om je logica te testen. De gekozen nodes kunnen daarbij gewoon externe systemen aanspreken. Controleer daarom eerst de bestemming en de acties die bereikbaar zijn vanuit je test.
Werk in een aparte testkopie met fictieve gegevens en een bewust gekozen testbestemming. Zorg dat mailverzending, betalingen, bestellingen en andere echte vervolgacties niet kunnen worden aangeroepen. Alleen het project “TEST” noemen is daarvoor onvoldoende. Kun je die scheiding niet aantonen, test dan uitsluitend lezen en gegevensomzetting.
Schrijf vooraf op wat een geslaagde proef betekent
Kies één route, bijvoorbeeld een fictieve formulieraanvraag die één project voorbereidt. Geef de aanvraag een vast bronkenmerk: TEST-AANVRAAG-017. Noteer welke gegevens moeten aankomen, welk resultaat je verwacht en wat juist niet mag gebeuren. De namen en kenmerken in deze oefening zijn bedacht.
Gebruik een eigen testkaart met vijf kolommen: geval, invoer, verwachte uitkomst, waargenomen uitkomst en bewijs. Bij de gewone aanvraag verwacht je één juist gekoppeld testproject. Bij een ontbrekend verplicht gegeven verwacht je een herkenbare stop of beoordelingsroute, niet een verzonnen waarde. Houd beide gevallen gescheiden.
Controleer eerst de invoer, zonder te schrijven
Bekijk of je flow de bedoelde werkruimte, technische veldnamen en dossier-ID’s gebruikt. Begin met de leesflow uit de MANE-handleiding voor n8n. Vergelijk de uitvoer met een bekend testdossier voordat je velden aan een schrijfactie koppelt. Een lege lijst vraagt ook om een bewuste vervolgroute.
Je kunt in n8n fictieve invoer maken en node-uitvoer vastzetten met data pinning. Daardoor kun je dezelfde invoer gebruiken zonder die bronnode telkens opnieuw uit te voeren. Andere vervolgnodes blijven echter onderdeel van je test. Bovendien negeren productie-uitvoeringen gepinde data. Pinning vervangt dus geen veilige testbestemming.
Bewijs één schrijfhandeling door terug te lezen
Laat pas na die voorbereiding één toegestane wijziging op fictieve gegevens uitvoeren. Gebruik voor MANE-dossierwijzigingen de gelezen revisie en een vaste idempotentiesleutel voor precies die handeling. Een sleutel als test-aanvraag-017-project is hier een voorbeeld, geen waarde om voor alle aanvragen te hergebruiken.
Bewaar de teruggegeven MANE-ID bij het bronkenmerk en lees het dossier opnieuw. Kloppen naam, koppeling en bedoelde gegevens? Een geslaagde node of ontvangen ID bewijst op zichzelf nog niet dat jouw veldkoppeling inhoudelijk goed is. Zet het werkelijke resultaat naast je verwachting op de testkaart.
Test dezelfde handeling opnieuw, niet een nieuwe aanvraag
Bied in je afgeschermde proef exact dezelfde schrijfopdracht opnieuw aan. Volgens de MANE-documentatie blijven bij een identieke herhaling na een timeout methode, pad, body, revisie en Idempotency-Key gelijk. Een al opgeslagen wijziging kan dan als replayed:true worden teruggegeven. Controleer dat het om hetzelfde dossier gaat en er geen tweede exemplaar is ontstaan.
Dit is een andere controle dan twee aanvragen met ongeveer dezelfde bedrijfsnaam vergelijken. Het gaat hier om één concrete externe gebeurtenis en één bedoelde handeling. Je workflow moet die identiteit bewaren. Maak bij iedere poging niet zomaar een nieuwe sleutel. De beschreven headers gelden voor dossier- en schemawijzigingen; neem ze niet blind over voor uploads of webhookbeheer.
Laat een conflict ook werkelijk stoppen
Neem een geval met een verouderde revisie op in je gecontroleerde proef. Een 409-conflict vraagt om opnieuw lezen en beoordelen of de voorgenomen wijziging nog klopt. Je test slaagt wanneer die beoordelingsroute zichtbaar werkt, niet wanneer de flow koste wat kost groen eindigt.
Zet Retry On Fail niet blind aan op schrijfacties. Na een onduidelijke uitkomst controleer je eerst wat is opgeslagen. Bij een bewuste inhoudelijke wijziging ontstaat een nieuwe specifieke opdracht; dat is niet dezelfde identieke herhaling. Bewaar voor onderzoek alleen noodzakelijke kenmerken, foutcode en request-ID, zonder servicesleutels of volledige klantinhoud.
Beslis over livegang met je testkaart erbij
Controleer vóór activering de gewone invoer, ontbrekende gegevens, identieke herhaling en conflict. Noteer de geteste workflowversie, datum en resterende beperkingen. Bij een onverklaarde dubbele registratie of onduidelijke bestemming blijft de route uit. Deze kaart is je eigen acceptatiecontrole, geen ingebouwde certificering van MANE of n8n.
Begin daarna, als de route verantwoord kan worden gebruikt, met een kleine gecontroleerde stroom en lees de opgeslagen resultaten terug. Een afzonderlijk ontvangen webhook vraagt bovendien om handtekeningcontrole en ontdubbeling van gebeurtenissen. De webhookhandleiding behandelt dat apart. Een geslaagde test van één schrijfactie bewijst nog niet dat de volledige ontvangst- en herstelroute klaar is.
