商品CSV Pro (事前検証・URL画像・ZIP・分割処理・エラー出力)

📖

マニュアル・設定方法

➔

「何千件もの商品をCSVで一括登録しようとしたら、途中で504エラーになってしまった…」
「途中で止まってしまい、どこまで登録されて、どこがエラーになったのか分からない…」

そんなEC-CUBE標準CSVの悩みを完全に解消する、エンタープライズ対応の高機能CSVインポートプラグインです。
サーバーに負荷をかけない「AJAX分割処理」により、どれだけ大量のデータでもタイムアウトすることなく安全に登録を完了できます。

【圧倒的な5つの独自機能】

1. DBを汚さない「ドライラン(事前検証モード)」
本番反映前に、CSV全行の整合性(必須項目の抜け、存在しないカテゴリIDなど)を高速スキャン。エラーの有無を事前に100%把握でき、大事故を防ぎます。

2. タイムアウトを防ぐ「AJAX分割処理 (プログレスバー付き)」
20〜100件ずつの小ブロックに自動分割して非同期処理。0%から100%まで進捗がリアルタイムで見えるため、画面がフリーズする不安がありません。

3. エラー行だけの「CSV再出力機能」
万が一エラーが出ても、失敗した行だけを抽出したCSVがワンクリックでダウンロード可能。最終列に「エラー原因」が明記されているため、直してそのまま再アップロードするだけでリトライ完了です。

4. URL画像の「並列自動ダウンロード」
メーカー等から提供されたCSVにある画像URL(http://...)をそのまま記載するだけで、プラグインがサーバー側で自動・高速にダウンロードし、商品に紐付けます。

5. 商品画像ZIPの「一括アップロード&解凍」
数百枚の画像をまとめた「images.zip」をCSVと一緒にアップロードするだけで、サーバー上で瞬時に解凍し、自動で登録を行います。

※対応バージョン: EC-CUBE 4.2系、4.3系に完全対応。
日々の面倒なCSV作業の時間を劇的に削減し、安全でストレスフリーな商品管理を実現します!

標準の商品CSV登録で起こりがちな「504 Gateway Timeout」「メモリ枯渇による停止」「失敗行・原因の特定困難」といった課題を完全解消!
万単位の大量商品データでも、ブラウザ上でリアルタイムに進捗を確認しながら高速かつ安全に一括登録・更新できる「商品CSV Pro」のメイン実行画面です。

■ 本画面の主要機能・注目ポイント

・ 安全な「ドライラン(検証モード)」機能:
データベースを更新する前に、CSV全行のエラーチェック(SKU重複、存在しないカテゴリ・規格ID、必須項目漏れなど)を高速実行。本番反映前にエラーの有無と件数を事前に100%把握し、安全に運用できます。

・ URL画像並列自動保存&ZIP一括アップロード:
CSV内に記載された外部商品画像URL(http/https)を並列非同期通信(cURL Multi)で自動取得・保存可能。手元にある大量の画像をまとめた「商品画像ZIP」を同時にアップロードして一括紐付けすることもできます。

・ タイムアウトを防ぐ「AJAX分割処理(バッチサイズ選択)」:
CSVを小ブロック(20件/50件/100件)に自動分割して順次処理。メモリの自動解放(Doctrine clear)を行いながら処理するため、共用サーバーでも504タイムアウトやメモリ不足を確実に防止します。

・ リアルタイム進捗バー&統計カウンター:
0%〜100%のプログレスバーに加え、「総行数」「処理済み」「成功件数」「エラー件数」がリアルタイムにカウントアップされ、インポートの進捗状況が一目で分かります。

・ 文字コード自動判別(UTF-8 / Shift-JIS対応):
Excelで編集・保存されたShift-JISファイルも自動判別して取り込み可能。文字コードの不一致による文字化けや取り込み失敗を防ぎます。

・ 雛形ダウンロード&エラー行CSV即時再出力:
画面右上のボタンから最新の標準テンプレートCSVをいつでもワンクリック入手。万が一エラーが発生した場合でも、失敗した行のみをエラー原因テキスト付きでCSV出力し、修正してそのまま再アップロードが可能です。

過去に実行された商品CSVインポートの処理結果やステータスを一覧で確認・管理できる「CSVインポート履歴」画面です。
実行日時やファイル名はもちろん、「ドライラン(検証)」と「本番反映」の区別、成功件数・エラー件数の内訳をひと目で把握できます。

■ 本画面の主要機能・注目ポイント

・ ドライラン/本番反映の実行ログを一元管理:
いつ・どのファイルで・どちらのモード(ドライラン/本番)で実行されたかが色分けバッジで直感的に判別できます。

・ ワンクリックで「エラー行のみのCSV」をダウンロード:
エラーが発生した履歴行には専用の「エラーCSV」ボタンが表示されます。失敗した行だけを抽出し、末尾にエラー原因テキストを自動付与したCSVをダウンロードできるため、原因特定と修正作業が劇的にスムーズになります。

・ 成功・エラー件数の完全可視化:
総行数に対する成功件数とエラー件数が明確に数値化されているため、インポートの完了状況や作業漏れの確認も容易です。

・ サーバー容量を圧迫しない履歴クリーンアップ:
不要になった過去の実行ログは個別の削除はもちろん、「全履歴削除」ボタンから不要な履歴データや一時ファイルをまとめて一括クリーンアップ可能です。

・ ページネーション&表示件数切り替え:
大量のインポートログも10件/20件/50件/100件の表示切り替えに対応し、快適に閲覧・管理いただけます。

標準の商品CSV登録で頻発する「504 Gateway Timeout」「メモリ枯渇 (Out of Memory)」「どこでエラーになったか分からない」といった課題を完全に解消する、エンタープライズ対応の超高速・高機能CSVインポートプラグインです。

何千・何万件という大量の商品データでも、サーバーに負荷をかけず安全かつ確実にインポートを行うためのあらゆる機能を搭載しています。

【主な機能と特長】

■ 1. タイムアウトを防ぐ「AJAX分割処理 (Chunking)」
CSVデータを自動的に小ブロック（20〜100件）に分割し、非同期で再帰的に処理します。
リアルタイムなプログレスバー（0% → 100%）で進捗を確認でき、途中で止まるストレスから解放されます。処理中のメモリ解放も自動で行うため、格安サーバーでも安定して動作します。

■ 2. DBを汚さない「ドライラン (事前検証モード)」
本番反映（データベースへの書き込み）を一切行わずに、CSV全行の整合性を高速スキャンします。
SKUの重複、存在しないカテゴリID、不正な価格フォーマットなどを事前に100%把握できるため、「インポート途中で止まってデータが中途半端になる」という大事故を防ぎます。

■ 3. 外部URL画像の「並列自動保存」＆「ZIP一括展開」
・URL自動ダウンロード： CSV内の画像列に外部URL（https://...）を記載するだけで、サーバーが自動的に並列通信で画像をダウンロードし商品へ紐付けます。
・画像ZIP同時アップロード： 多数の画像ファイルをまとめた「images.zip」をCSVと一緒にアップロードするだけで、サーバー上で瞬時に解凍・登録が可能です。

■ 4. 失敗した行だけを直せる「エラーCSV再出力」
万が一エラーが発生した場合、「失敗した行のみ」を抽出したCSVを1クリックでダウンロード可能です。
CSVの最終列に【エラー原因 (Error Reasons)】が自動付与されるため、原因を確認・修正してそのまま再アップロードするだけでリトライが完了します。

■ 5. 安心の「インポート履歴管理」
過去のインポート実行ログ、実行日時、モード（ドライラン / 本番）、成功・失敗件数を一覧で管理。不要になった履歴や一時ファイルのワンクリック削除機能も搭載し、サーバー容量を圧迫しません。