Comment importer des données de flashcards JSON dans Deckbase

Quand utiliser ce flux de travail

Développeurs et utilisateurs avancés qui migrent depuis des outils maison, des API ou des générateurs de cartes programmatiques et qui ont besoin d'un contrôle du schéma au niveau de l'import.

Considérez cela comme un processus de migration opérationnel, et non comme un simple envoi de fichier ponctuel. L'objectif n'est pas seulement de réussir l'import, mais aussi d'améliorer la régularité des révisions et de réduire la charge d'entretien des cartes dans les semaines qui suivent le changement.

Liste de vérification avant import

• Le fichier JSON utilise un tableau d'objets avec des clés cohérentes pour le recto et le verso.
• Les chaînes sont en UTF-8 valide et ne contiennent pas de caractères de contrôle non échappés.
• Les champs facultatifs comme les tags et les notes utilisent des clés prévisibles dans tous les objets.

Si un élément de la liste de vérification échoue, corrigez-le avant l'import. Un nettoyage en amont est plus rapide que la réparation de centaines de cartes après la migration.

Déroulé de migration étape par étape

1. 1
   Validez la structure JSON avec un linter et vérifiez que chaque objet possède bien les clés recto et verso requises.
2. 2
   Choisissez le mappage : quelles clés deviennent le recto, le verso, les tags et les notes.
3. 3
   Lancez un petit import de test avec 10 objets et inspectez le rendu des cartes.
4. 4
   Corrigez les problèmes d'encodage ou les objets imbriqués qui ont été aplatis à tort.
5. 5
   Importez le jeu de données complet et vérifiez que le nombre total de cartes correspond aux lignes attendues.

Erreurs courantes et corrections

Utilisez un petit paquet pilote après chaque correction. Si la qualité du pilote se maintient, appliquez le même schéma de correction à l'ensemble du lot.

Exemples de contrôles qualité des résultats

• Recto : Qu'est-ce que le schéma JSON ? | Verso : Un vocabulaire qui définit la structure valide des documents JSON.
• Recto : Différence entre un tableau et un objet JSON ? | Verso : Le tableau est une liste ordonnée ; l'objet est une collection clé-valeur non ordonnée.
• Recto : Pourquoi valider le JSON avant l'import ? | Verso : Une validation précoce évite les cartes mal formées et les échecs d'import à grande échelle.

Lors du contrôle qualité, vérifiez chaque carte exemple pour sa clarté, son atomicité et la précision de sa réponse. Évitez d'importer des cartes qui ne testent que la formulation sans tester la compréhension.

Un test pratique : si vous pouvez répondre avec précision en moins de 10 secondes pendant la révision, la carte est généralement bien cadrée. Sinon, divisez-la ou réécrivez-la.

FAQ

Guides associés

Conseil : pour les flux de travail avancés, conservez votre export d'origine comme sauvegarde et suivez chaque tentative de migration par nom de lot et par date.