JSON形式のフラッシュカードデータをDeckbaseにインポートする方法

このワークフローを使う場面

カスタムツール、API、プログラムによるカード生成から移行し、インポートをスキーマレベルで制御する必要がある開発者やパワーユーザー向けです。

これは単発のファイルアップロードではなく、運用としての移行プロセスとして捉えてください。目的はインポートを成功させることだけではなく、切り替え後の数週間で復習の一貫性を高め、カード保守の負担を減らすことです。

インポート前チェックリスト

• JSONファイルでは、表面と裏面に一貫したキーを持つオブジェクトの配列を使用します。
• 文字列は有効なUTF-8で、エスケープされていない制御文字を含みません。
• タグやメモなどの任意フィールドは、すべてのオブジェクトで予測可能なキーを使用します。

チェックリストの項目が1つでも失敗したら、インポート前に修正してください。移行後に数百枚のカードを修復するより、事前のクリーンアップのほうが速く済みます。

ステップごとの移行フロー

1. 1
   リンターでJSON構造を検証し、すべてのオブジェクトに必須の表面キーと裏面キーがあることを確認します。
2. 2
   マッピングを決めます。どのキーをカードの表面、裏面、タグ、メモに割り当てるかを指定します。
3. 3
   10個のオブジェクトで小規模なテストインポートを実行し、カードの表示を確認します。
4. 4
   エンコーディングの問題や、正しくフラット化されなかったネストされたオブジェクトを修正します。
5. 5
   データセット全体をインポートし、カードの総数が想定した行数と一致することを確認します。

よくあるエラーと対処

各修正の後に小さなパイロットデッキで試してください。パイロットの品質が保てれば、同じ修正パターンをバッチ全体に適用します。

出力品質チェックの例

• 表面: JSON Schemaとは何ですか？ | 裏面: JSONドキュメントの有効な構造を定義する語彙です。
• 表面: JSON配列とオブジェクトの違いは何ですか？ | 裏面: 配列は順序付きリストで、オブジェクトは順序のないキーと値の集合です。
• 表面: インポート前にJSONを検証するのはなぜですか？ | 裏面: 事前に検証することで、不正な形式のカードや大規模インポート時の失敗を防げます。

QAでは各サンプルカードについて、明確さ、1枚1概念になっているか、回答の正確さを確認してください。理解力を試さず文言だけを試すカードはインポートしないでください。

実用的なテスト: 復習中に10秒以内で正確に答えられれば、そのカードは通常適切な範囲に収まっています。答えられない場合は、分割するか書き直してください。

FAQ

関連ガイド

ヒント: 高度なワークフローでは、元のエクスポートをバックアップとして残し、各移行試行をバッチ名と日付で記録してください。