JSON-flashcardgegevens importeren in Deckbase

Wanneer je deze workflow gebruikt

Ontwikkelaars en power users die overstappen van eigen tools, API's of programmatische kaartgeneratoren en controle op schemaniveau nodig hebben bij het importeren.

Zie dit als een operationeel migratieproces, niet als een eenmalige bestandsupload. Het doel is niet alleen een geslaagde import, maar ook consistenter reviewen en minder onderhoud aan kaarten in de weken na de overstap.

Checklist voor de import

• Het JSON-bestand gebruikt een array van objecten met consistente keys voor voorkant en achterkant.
• Strings zijn geldige UTF-8 en bevatten geen niet-geëscapete stuurtekens.
• Optionele velden zoals tags en notities gebruiken voorspelbare keys in alle objecten.

Als één punt op de checklist niet klopt, los het dan op vóór de import. Opschonen aan de bron is sneller dan honderden kaarten repareren na de migratie.

Stapsgewijze migratiestroom

1. 1
   Valideer de JSON-structuur met een linter en controleer of elk object de vereiste keys voor voorkant en achterkant heeft.
2. 2
   Bepaal de mapping: welke keys worden voorkant, achterkant, tags en notities.
3. 3
   Voer een kleine testimport uit met 10 objecten en bekijk hoe de kaarten worden weergegeven.
4. 4
   Los coderingsproblemen op of geneste objecten die verkeerd zijn afgevlakt.
5. 5
   Importeer de volledige dataset en controleer of het totale aantal kaarten overeenkomt met het verwachte aantal rijen.

Veelvoorkomende fouten en oplossingen

Gebruik na elke oplossing een klein proefdeck. Als de kwaliteit in het proefdeck goed blijft, pas je hetzelfde correctiepatroon toe op de hele batch.

Voorbeelden van kwaliteitscontroles op de output

• Voorkant: Wat is JSON Schema? | Achterkant: Een vocabulaire dat de geldige structuur van JSON-documenten definieert.
• Voorkant: Verschil tussen een JSON-array en een JSON-object? | Achterkant: Een array is een geordende lijst; een object is een ongeordende verzameling key-waardeparen.
• Voorkant: Waarom JSON valideren vóór het importeren? | Achterkant: Vroeg valideren voorkomt misvormde kaarten en mislukte imports op grote schaal.

Controleer bij de QA elke voorbeeldkaart op helderheid, atomiciteit en precisie van het antwoord. Importeer geen kaarten die alleen de formulering testen en niet het begrip.

Een praktische test: als je tijdens het reviewen binnen 10 seconden nauwkeurig kunt antwoorden, is de kaart meestal goed afgebakend. Zo niet, splits hem dan of herschrijf hem.

FAQ

Gerelateerde gidsen

Tip: bewaar bij geavanceerde workflows je oorspronkelijke export als back-up en houd elke migratiepoging bij met batchnaam en datum.