Jak zaimportować dane fiszek JSON do Deckbase

Kiedy korzystać z tego procesu

Dla deweloperów i zaawansowanych użytkowników przenoszących dane z własnych narzędzi, API lub generatorów fiszek tworzących karty programowo, którzy potrzebują kontroli nad importem na poziomie schematu.

Traktuj to jako operacyjny proces migracji, a nie tylko jednorazowe wgranie pliku. Celem nie jest wyłącznie udany import, ale też większa spójność powtórek i mniejsze nakłady na utrzymanie fiszek w tygodniach po przejściu.

Lista kontrolna przed importem

• Plik JSON zawiera tablicę obiektów ze spójnymi kluczami dla przodu i tyłu.
• Ciągi znaków są poprawnym UTF-8 i nie zawierają nieescapowanych znaków sterujących.
• Pola opcjonalne, takie jak tagi i notatki, mają przewidywalne klucze we wszystkich obiektach.

Jeśli któryś punkt listy kontrolnej nie przejdzie, popraw go przed importem. Uporządkowanie danych u źródła jest szybsze niż naprawianie setek fiszek po migracji.

Przebieg migracji krok po kroku

1. 1
   Sprawdź strukturę JSON linterem i upewnij się, że każdy obiekt ma wymagane klucze przodu i tyłu.
2. 2
   Ustal mapowanie: które klucze stają się przodem, tyłem, tagami i notatkami fiszki.
3. 3
   Wykonaj mały testowy import z 10 obiektami i sprawdź renderowanie fiszek.
4. 4
   Napraw problemy z kodowaniem lub zagnieżdżone obiekty, które zostały nieprawidłowo spłaszczone.
5. 5
   Zaimportuj cały zbiór danych i sprawdź, czy łączna liczba fiszek zgadza się z oczekiwaną liczbą wierszy.

Częste błędy i poprawki

Po każdej poprawce użyj małej talii pilotażowej. Jeśli jakość w pilocie się utrzyma, zastosuj ten sam wzorzec korekty do całej partii.

Przykładowe kontrole jakości wyników

• Przód: Czym jest JSON Schema? | Tył: Słownik definiujący prawidłową strukturę dokumentów JSON.
• Przód: Jaka jest różnica między tablicą a obiektem JSON? | Tył: Tablica to uporządkowana lista; obiekt to nieuporządkowany zbiór par klucz-wartość.
• Przód: Dlaczego warto sprawdzić JSON przed importem? | Tył: Wczesna walidacja zapobiega błędnym fiszkom i błędom importu na dużą skalę.

Podczas kontroli jakości sprawdź każdą przykładową fiszkę pod kątem jasności, skupienia na jednym zagadnieniu i precyzji odpowiedzi. Unikaj importowania fiszek, które sprawdzają tylko sformułowanie, a nie zrozumienie.

Praktyczny test: jeśli podczas powtórki potrafisz odpowiedzieć poprawnie w mniej niż 10 sekund, fiszka zwykle ma dobrze określony zakres. Jeśli nie, podziel ją lub przepisz.

FAQ

Powiązane przewodniki

Wskazówka: w zaawansowanych procesach zachowaj oryginalny eksport jako kopię zapasową i śledź każdą próbę migracji według nazwy partii i daty.