DeckbaseでのAnkiインポートのトラブルシューティング

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

すでに移行を試して、インポートエラーを診断・修正する再現性のある手順を必要としている学習者やチーム向けです。

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

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

• デバッグ用に、失敗した行またはカードのサンプルを用意します。
• 元のソースファイルとエクスポート設定にアクセスできる状態にしておきます。
• 修正を安全に試せるパイロット用のデッキを用意します。

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

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

1. 1
   まずファイルの整合性を確認します。文字エンコーディング、区切り文字、行の一貫性を見てください。
2. 2
   サンプル行を使ってプレビューモードでフィールドマッピングを検証します。
3. 3
   エラーが全体の問題（形式）か、局所的な問題（特定の行）かを特定します。
4. 4
   対象を絞って修正し、小規模なパイロットインポートを再実行します。
5. 5
   パイロットが成功してから、初めてインポートの全バッチを再試行します。

よくあるエラーと対処

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

出力品質チェックの例

• パイロット確認：異なるタグと形式にまたがる10枚のカード。
• 検証確認：メディア付きカード1枚、長文カード1枚、記号を含むカード1枚。
• 結果確認：初回レビュー後のセッション完了率とラプス率。

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

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

FAQ

関連ガイド

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