Schemafout
Schema-draft mismatch: definitions versus $defs, draft 2019-09 versus 2020-12
Symptoom
De validator meldt 'can't resolve reference', MissingRefError of 'no schema with key or ref' bij het laden van het schema, nog vóór het bericht wordt getoetst.
Oorzaak
Release 2027 migreerde naar JSON Schema draft 2020-12 ($defs, https-referenties); Release 2026 gebruikt draft 2019-09 met definitions. De schema's verwijzen naar externe codelijsten op sivi.org die de validator moet kennen. Sinds de definitieve Release 2027 verwijzen de berichten 5, 6 en 15 voor AFDSWI en AFDCOA bovendien naar het codelijstbestand naast het schema, met een relatieve bestandsnaam (…-afdCodelists.json#/$defs/AFDSWI).
Oplossing
Gebruik een validator die beide drafts ondersteunt (AJV: Ajv2019 en Ajv2020). Registreer de codelijsten onder de URL die het schema gebruikt, en het codelijstbestand onder zijn bestandsnaam. AJV 8.17 codeert de haakjes in die bestandsnaam dubbel; registreer het bestand dan ook onder de sleutel die de foutmelding noemt. De validator van WTP Data Lab doet dit automatisch.
Controleer uw eigen bericht op deze en alle andere fouten met de gratis validator: schema, codelijsten en verbandscontroles in één rapport. Valideer een bericht