インポート失敗¶
目的¶
現在の失敗が、未対応入力なのか、インポート経路の選択ミスなのか、実インポート中の失敗なのかを素早く判断できるようにします。
対応プラットフォーム¶
iOSmacOS
対象読者¶
- インポートが想定どおり動かなかったユーザー
- インポート失敗、無視された再インポート、一部の表示低下を切り分けたいテスター
前提条件¶
- 確認したい具体的なインポート事例、メッセージ、再現経路がある
- 可能であれば元ファイルと再現手順を保持している
手順¶
- 失敗した地点がファイル選択前、選択後、ワークスペース遷移後のどこかを切り分けます。
- 使用したインポート経路と、その入力が本来その経路で扱えるかを確認します。
- 下の失敗タイプ一覧と照合し、変化なし判定や DSN 一部の表示低下メッセージも含めて分類します。
- 再試行前に、正確なメッセージとソース条件を記録します。
結果¶
- 問題を未対応入力、経路ミスマッチ、実インポート中の失敗、変化なし再インポート、一部の表示低下のいずれかへ絞り込めます。
最初に見るべき 3 点¶
- 失敗したのは ファイル選択前、ファイル選択後、それとも ワークスペースに入った後 か
- アプリは明確なエラーメッセージを出したか
- 操作は 新規インポート、リビジョン追加、SES のどれだったか
現在よくある失敗タイプ¶
1. 入力形式が未対応¶
典型的な兆候:
- 拡張子未対応と直接表示される
- ファイル選択後にフローが進まない
推奨対応:
- まず設計経路と製造経路のどちらを使ったか確認する
- そのうえで、その入力が現在の対応範囲に入っているか確認する
2. IPC-2581 のインポート意図が違う¶
典型的な兆候:
- ファイル自体は選べるが、インポート結果が想定と違う
推奨対応:
- もう一度インポートする
- 設計側として扱うか製造側として扱うかを選び直す
3. SES の使い方が違う¶
典型的な兆候:
SESを通常の新規ドキュメントのように取り込もうとしている- 現在ドキュメントに使えるベースリビジョンがない
推奨対応:
- 対象ドキュメントのメニューを開く
Import SESから開始する- 先に有効なベースリビジョンを選ぶ
4. 大きな IPC-2581 が遅い、または実インポート中に失敗する¶
現在のバージョンでは、非常に大きな IPC-2581 XML 入力も実際のインポート経路に進みます。
この種のソースが遅い、または失敗する場合は、ファイルを開く前の保守的な判定ではなく、実インポート中の段階で詰まっています。
推奨対応:
- 正確なエラー文、または最後に見えていた読み込み段階を記録する
- ファイルサイズ、プラットフォーム、端末モデルを記録する
- アプリが応答していたか、停止していたか、OS に終了されたかを記録する
5. すでに別のインポート処理が動いている¶
現在の実装では、同時に動かせる PCB インポート処理は 1 件だけです。前のインポートが終わっていない場合、次の要求はステータスメッセージ付きで拒否されます。
6. 同名・同形式の入力が「変化なし」と判定される¶
現在の実装では、同じドキュメント名・同じ形式で再インポートした場合、元ソースのバイト比較が行われます。
- 新しく取り込んだ元ソースが現在リビジョンと完全一致する場合は、「変化なし」としてインポートが無視されます
- これは失敗扱いではなく、重複リビジョンを増やさないための挙動です
- 新しいリビジョンになるはずだと思う場合は、まずファイル内容が本当に変わっているか確認してください
7. DSN の局所ジオメトリが一部だけ降格する場合がある¶
典型的な兆候:
- インポート自体は成功し、ドキュメントも開ける
- ただし開発ログやコンソールに
skipping display object variant ... no valid shapes could be extractedのようなメッセージが出る
意味すること:
- 少数の局所ディテールについて有効な形状を抽出できず、その局所変体だけをスキップして残りの基板はそのままインポート継続している状態です
- これはボード全体の失敗やクラッシュを避けるための挙動で、通常は局所描画にだけ影響し、ドキュメント全体が開けなくなるわけではありません
推奨対応:
- まず、問題の箇所が自分の用途に対して本当に影響しているか確認してください
- 影響が大きい場合は、メッセージ文面、元の
DSN、再現手順を記録して追跡に回してください
KiCad 固有の注意¶
KiCad 基板が 2D 的には正常にインポートされても、project-local の 3D モデル参照が欠落、未対応、または描画不可だと、後で診断情報の issue として現れることがあります。3D は描画可能なモデルを優先しますが、使えないモデルはフォールバック / プロキシ形状や issue 情報で扱われます。
記録しておきたい情報¶
- プラットフォームと端末
- インポート経路種別: 設計 / 製造 / SES
- 元ファイルの種類とサイズ
- エラーメッセージ原文
- 再現が安定しているか
- すでに別のインポートが動いていたか
よくある質問¶
なぜ一部の製造入力はフォルダでもインポートできるのですか？¶
製造経路はディレクトリ形式入力も受け付けるためです。成功するかどうかは、そのディレクトリをインポータが対応製造パッケージとして認識できるかに依存します。
なぜ失敗後にライブラリへ新しいカードが出ないのですか？¶
それは通常、ドキュメント作成前に失敗していることを意味します。たとえば未対応入力、インポータ認識失敗、実インポート前後のエラーなどです。
同じファイル名をもう一度入れたのに、新しいリビジョンが増えないのはなぜですか？¶
「変化なし」と表示されているなら、新しく取り込んだ元ソースが現在リビジョンと同一という意味です。現在の実装では、重複リビジョンを作らずに無視されます。
2 回目は成功しました。それでも記録すべきですか？¶
はい。断続的な失敗も安定性評価には重要です。