Come importare dati flashcard JSON in Deckbase

Quando usare questo flusso di lavoro

Sviluppatori e utenti avanzati che migrano da strumenti personalizzati, API o generatori di card programmatici e che necessitano di un controllo dello schema durante l'importazione.

Trattalo come un processo di migrazione operativo, non solo come un caricamento di file una tantum. L'obiettivo non è solo un'importazione riuscita, ma una maggiore coerenza nei ripassi e meno manutenzione delle carte nelle settimane successive al passaggio.

Checklist prima dell'importazione

• Il file JSON usa un array di oggetti con chiavi coerenti per fronte e retro.
• Le stringhe sono in UTF-8 valido e non contengono caratteri di controllo non codificati tramite escape.
• I campi opzionali come tag e note usano chiavi prevedibili in tutti gli oggetti.

Se un elemento della checklist non va a buon fine, risolvilo prima dell'importazione. Sistemare a monte è più rapido che riparare centinaia di carte dopo la migrazione.

Flusso di migrazione passo per passo

1. 1
   Convalida la struttura JSON con un linter e verifica che ogni oggetto abbia le chiavi obbligatorie front e back.
2. 2
   Decidi la mappatura: quali chiavi diventano fronte, retro, tag e note.
3. 3
   Esegui un'importazione di prova con 10 oggetti e controlla come vengono visualizzate le card.
4. 4
   Correggi problemi di codifica o oggetti annidati che sono stati appiattiti in modo errato.
5. 5
   Importa l'intero dataset e verifica che il numero totale di card corrisponda alle righe previste.

Errori comuni e soluzioni

Dopo ogni correzione, usa un piccolo mazzo pilota. Se la qualità del pilota regge, applica lo stesso schema di correzione all'intero lotto.

Esempi di controlli di qualità sull'output

• Fronte: Che cos'è JSON Schema? | Retro: Un vocabolario che definisce la struttura valida per i documenti JSON.
• Fronte: Differenza tra array e oggetto JSON? | Retro: L'array è un elenco ordinato; l'oggetto è una raccolta non ordinata di coppie chiave-valore.
• Fronte: Perché convalidare il JSON prima dell'importazione? | Retro: Una convalida anticipata previene card malformate e errori di importazione su larga scala.

Durante il controllo qualità, verifica chiarezza, atomicità e precisione delle risposte per ogni carta di esempio. Evita di importare carte che testano solo la formulazione e non la comprensione.

Un test pratico: se durante il ripasso riesci a rispondere con precisione in meno di 10 secondi, di solito la carta è ben delimitata. Se no, dividila o riscrivila.

FAQ

Guide correlate

Suggerimento: per i flussi avanzati, conserva l'esportazione originale come backup e annota ogni tentativo di migrazione con nome del lotto e data.