CSV取り込みの確認表
文字化け・ゼロ落ち・重複を防ぐ

CSVを読み込めたので完了と思ったら、翌日になって『00123』が『123』に変わっていた。やり直すと同じ注文が二件できた。CSV取り込みは、ファイルが開けるかだけでなく、元の情報がどう解釈され、どこに反映されるかを確認する作業です。

元ファイルを残し、取り込み先の仕様を先に確認する

データ移行全体の進め方はExcelからシステムへ移行する流れで紹介しています。ここではCSV一回分の取り込みに絞ります。まず出力した元ファイルを変更せず保存し、加工する場合は作業用コピーを使います。

CSVという拡張子だけでは、文字コード、列の順序、日付の形式までは決まりません。取り込み先が用意する仕様書やテンプレートを確認し、書き出し元の設定と照合します。『いつものExcelで開けるから大丈夫』を完了の基準にしないことが大切です。

• 文字コードと区切り文字は何か
• 一行目は見出しか、データか
• 必須の列と、列名・順序の指定はあるか
• 空欄は未設定・削除・変更なしのどれを意味するか
• 同じデータを再度取り込むと、追加されるか更新されるか

コードは文字として、数量・金額とは分けて扱う

Microsoftの説明では、Excelの自動変換で先頭のゼロが削除される場合があります。顧客コード、郵便番号、長い管理番号などは計算用の数値ではないため、必要に応じて列のデータ型を文字列として取り込みます。操作名や設定の有無はExcelの版によって異なります。

画面上の表示形式で『00123』に見せることと、値として『00123』を保持することも別です。一度消えたゼロを、桁数の根拠がないまま補うと、別のコードを作ってしまいます。元ファイルと取り込み先の値を照合してください。

全部を入れる前に、少量で境界のケースを試す

最初は通常の一行だけでなく、空欄、長い文字、同じ名前、停止中の顧客など、扱いが分かれそうなデータを少数用意します。実在の個人情報をコピーする必要がない検証では、架空データで試せます。

CSVのインポートに関するMicrosoftの資料でも、区切り文字や列の形式を確認する手順が案内されています。Excelでの読み込みと、業務アプリへの取り込みは別の処理なので、それぞれで正しく解釈されるかを確認します。

同じファイルを二回入れた場合の動きを決める

取り込み途中で画面を閉じた、結果が分からずもう一度押した。そんなとき、再実行で同じ注文が増える設計なら、運用で気をつけるだけでは限界があります。何をキーに同じデータと判断するかを、先に決めておきましょう。

ファイル名が違うだけで別データと判断しない設計が必要な場合もあります。たとえば受注番号と明細番号で一件を識別するなど、業務上の重複の定義を、サンプルを使って開発担当と共有します。

完了後は、件数だけでなく値と対象を照合する

• 対象範囲の取り込み前後の件数が、予定した増減と合っている
• 更新対象のコードと、実際に変わったコードが合っている
• 金額や数量を扱う場合、対象範囲の合計も合っている
• 除外・エラーになった行と理由を確認できる
• 実行者・日時・元ファイルを後からたどれる

合計が合っていても、二件の内容を取り違えている場合はあります。件数と合計だけでなく、代表的な行と、例外を含む行の値も確認します。エラー行だけ再実行する場合も、成功済みの行を混ぜない扱いを確認してください。

取り込めたかより、想定どおり反映されたか

元ファイルを残す、仕様を合わせる、少量で試す、再実行の動きを決める、実行後に照合する。この順で確認すると、失敗が起きたときも、どこを見直せばよいか追いやすくなります。

SHISAKUBAで取り込み画面を試作するなら、普段のファイルと、これまで取り違えた例をもとに、プレビュー・エラー表示・確定の流れを相談できます。取り込みボタンだけでなく、実行前後の確認までを一つの業務として考えることが大切です。

参考にした公式資料

• Microsoft：先頭のゼロおよび大きい数値の保持
• Microsoft：テキスト・CSVのインポートとエクスポート

2026年10月27日確認。本文中の記入例・チェック項目は、業務を検討するために作成した例です。