コラム / 制作会社・広告会社向け

商品CSVの更新前チェック|空欄・ゼロ・消去指示を区別する

商品CSVは、読み込めるだけでなく意図した項目だけが変わるかを確認します。架空3商品の読取試験から、ID重複での停止、空欄と0、補足の消去、反映前の変更案と戻し方を整理します。

公開 最終確認 2026-11-16著者 GreenCoding
陶器の商品と、空欄・点・消去印を持つ更新確認表を、ノートパソコンの一覧と見比べる生成イラスト

商品情報をCSVでまとめて更新する前に、どの商品を変えるか、空欄をどう扱うか、何を消すかを決めます。ファイルを読み込めたことと、意図した商品だけが変わることは別です。最初に変更案を出し、担当者が確認してから反映する工程を設けます。

商品紹介サイトの追加・更新を進める制作会社様・広告会社様に向けて、支給データとWeb側の更新仕様を合わせる確認例です。商品に持たせる仕様項目の設計とは分け、今回は登録済み商品の一括更新を扱います。架空データだけを使い、本番サイトや顧客データへの取り込みは行っていません。

商品名ではなく、変わらないIDで照合する

CSVは、行と列を区切って表の値を渡す形式です。同じ商品でも、商品名は改称や表記修正で変わります。更新対象の照合には、サイト側と対応が取れた商品IDや管理コードを使います。表の行番号をIDの代わりにすると、並べ替えで対象が変わるおそれがあります。

今回の例では0012のようなIDを文字列として扱います。先頭の0を含めて識別するためです。表計算ソフトで開いて保存し直す場合も、渡したファイルに0が残っているか確認します。文字コード、区切り文字、列名、引用符の扱いも受け取る仕組みと合わせます。

空欄・0・補足の消去を別々に指示する

この試験では、在庫欄の空欄は「今の値を維持」、0は「在庫を0へ更新」と決めました。補足欄は、値だけで判断せず、note_actionという操作列でkeep(維持)、replace(置換)、clear(消去)を選びます。これは例の取り決めであり、すべての取り込みツールに共通する仕様ではありません。

product_id,stock,note,note_action
0012,0,,keep
0013,,"包装,別売",replace
0014,,,clear

0012は在庫を0にして補足を維持します。0013は在庫を変えず、補足を「包装,別売」へ置き換えます。補足に区切り用と同じカンマが入るので、引用符で囲んで一つの値として読みます。0014は在庫を維持し、補足だけを消す指定です。

CSVに載っていない商品は、この例では変更しません。行を消したことを商品削除と解釈するかは、別途決める必要があります。商品自体の削除・非公開や画像の入れ替えは、今回の更新案作成の対象外です。

重複IDで停止してから、修正後の変更案を照合する

2026年11月16日、Python 3.9.6の標準csvモジュールで、UTF-8の架空CSVを読みました。データベースへ書き込まず、メモリー上の既存3商品と照合して変更案を作る試験です。実際の管理画面や取り込みプラグインでの動作試験ではありません。

最初のファイルでは、2行目と3行目の商品IDがどちらも0012でした。3行目のID重複を検出し、変更案を出さずに停止しました。後の行で上書きする処理にはせず、提供元が正しい対象を確認して0013へ修正した想定です。

ID試験前修正後CSVの変更案
0012在庫5、補足「取寄せ可」在庫0、補足は維持
0013在庫8、補足「旧案内」在庫8を維持、補足を「包装,別売」へ
0014在庫2、補足「旧補足」在庫2を維持、補足を消去

修正後はエラーなしで上の3件の案を作れました。先頭0、在庫0、空欄の維持、補足のカンマ、明示した消去を読み分け、元データが変わっていないことも照合しています。本番への反映は0件です。この結果は、Webサイトの更新完了や、大量データの安全性を証明するものではありません。

取り込み方式と、失敗したときの戻し方を先に決める

WordPressの「ツール→インポート」が、任意の商品CSVをそのまま更新できるという意味ではありません。商品情報の持ち方、利用するプラグインや個別実装に応じて、対応列、対象ID、権限、画像、エラー時の処理を確認します。既存の取り込み機能がある場合は、その実仕様を優先して照合します。

反映前には現行データとバックアップを保存し、対象件数と変更前後を承認します。途中で止まった場合に全件を戻すか、成功分を記録して残りから再開するかも決めます。同じファイルを再実行すると重複や別の更新が起きないか、テスト環境で確かめてから本番へ進みます。

実際の検収では、変更した商品だけでなく、変更しない商品も抜き取って確認します。PC・スマホの一覧と詳細で、在庫や補足が意図どおり表示されるか、既存URL・画像・分類が保たれるかを照合します。今回の小さな読取試験では、これらのCMS反映・公開表示は未検証です。

見積もりには、CSV一式と更新ルールを添える

依頼時は、現在の登録項目、数行の架空または使用許可済みサンプル、対象件数、更新頻度、空欄と消去の扱い、承認者、希望する戻し方を共有します。実データを渡す前に、個人情報や不要な管理情報を除けるかも確認してください。ファイル名だけでは更新範囲は決まりません。

GreenCodingには、WordPressの商品情報を更新する項目や管理方法、取り込み処理の実装・検証範囲を相談できます。既存機能で対応できる部分と、追加実装やデータ整理が必要な部分を、現在のサイト構成とサンプルに基づいて確認します。

参照した公式資料

RFC 4180:CSV形式の情報文書/Python 3.9:csvモジュール/WordPress:インポート画面の案内。確認日:2026年11月16日。CSVの書式と読取方法、標準の取り込み範囲の参照であり、商品更新の業務ルールを公式仕様とするものではありません。