CSVアップロード失敗は列の順序と名前を確認

会計ソフトやショッピングモールの管理画面にCSVファイルをアップロードしたら、値が意図しない列に入ってしまった、あるいはアップロード自体が拒否された。そんな経験があるなら、ファイルが壊れているわけではありません。
CSVは値と区切り文字だけを並べたテキストで、列の意味を保持する専用の場所がありません。そのため、列の順序やヘッダー名がそのプログラムの想定と少しでも違うと、こうしたことが起こります。
要点 ① CSVは値と区切り文字だけのテキストなので、列の意味は1行目(ヘッダー)の文字列か、列の位置によってのみ伝わります。 ② 値を受け取るプログラムは、このヘッダーを「順序」で合わせるか「名前」で合わせるかですが、どちらか一方でもずれると値がずれたり、拒否されたりします。 ③ ヘッダーの前後についた見えない空白が1つあるだけでも「別の名前」として扱われ、原因を見つけにくい失敗につながります。
CSVアップロードがずれる原因: なぜこうなるのか
たとえば、銀行から受け取った取引明細のCSVが「取引日・取引先名・金額・事業者登録番号」の順になっていて、会計ソフトが求める形式は「取引日・取引先名・事業者登録番号・金額」の順だとします。
このファイルをそのままアップロードすると、会計ソフトは3番目の列を「事業者登録番号」だと思って読み込むため、実際には金額の値が事業者登録番号の位置に入ってしまいます。ファイルにもプログラムにも非はなく、3番目の列の位置が違うだけです。
ヘッダー名でマッチングするプログラムなら、逆の動きになります。1行目の文字列がプログラムの知っている名前と一字一句同じでなければその列を見つけられないので、順序は違ってもかまいませんが、名前が違うと(例:「事業者番号」と「事業者登録番号」)その列自体を見つけられず、エラーになります。
列の順序・名前を合わせる方法: ツールなしで確認する
ツールがなくても、3つの手順で確認できます。順序が合っているほど、後で手を入れる箇所が減ります。
1. 対象のプログラムが求める形式を先に確認する
最初に確認すべきは、対象のプログラムが求める正確なヘッダー名と順序です。多くの場合、管理画面の「テンプレートのダウンロード」や案内ドキュメントにこの情報が記載されています。
2. 受け取ったファイルの1行目を文字どおり突き合わせる
受け取ったCSVをメモ帳などのテキストエディタで開き、1行目だけを目で突き合わせます。スペル・空白・大文字小文字まで、要求された形式と正確に一致しているか確認します。
3. Excelで順序・名前・空白を整える
順序が違う場合はExcelで列見出しを選択して切り取り、挿入したい位置に挿入します。名前が違う場合はヘッダーのセルをダブルクリックして書き換えます。空白は検索と置換で削除できます。
問題は、この作業をファイルごと、列ごとに繰り返さなければならない点です。列が多かったり、似たファイルを頻繁に受け取ったりすると、手作業はすぐに煩わしくなります。
CSV列エディターで確認する。 チェックボックスで必要な列だけを残し、▲▼ボタンで順序を入れ替え、名前欄に新しいヘッダーをそのまま入力できます。
無料・登録不要・アップロードしたCSVはブラウザの外に送信されません

つまずきやすいポイント
| 症状 | 原因 |
|---|---|
| 値が1列ずつずれて意図しない列に入る | 受け取るプログラムが「順序」で列を判断するのに、ファイルの列順が違う |
| アップロード自体が拒否される(形式エラー) | 受け取るプログラムが「ヘッダー名」で判断するのに、綴りが違う |
| 特定の列だけ認識されない | ヘッダーの前後に目に見えない空白が残り、文字列が完全に一致しない |
| 列は合っているのに値が1行にまとまって入る | 区切り文字がカンマではなくセミコロンやタブなのに、カンマだけで分割して読み取っている |
表の4つの原因は、いずれも列の位置・名前・区切り文字という3つの信号のどれかがずれているケースです。どれであっても、ファイルの中身を直す必要はなく、列を並べ替えるか、名前と空白を整えるだけで解決します。
まとめ
- CSVは列の意味を、順序かヘッダー名でしか伝えません。受け取るプログラムによって、どちらかが正確に一致している必要があります。
- アップロードの失敗や値のずれは、ほとんどがファイルの破損ではなく、このどちらかがずれているという機械的な問題です。
- 対象のプログラムが求めるヘッダー名・順序を先に確認して合わせれば、ほとんどは解決します。
- 目に見えない空白も失敗の原因になり得るので、名前を合わせるときに一緒に整える必要があります。
無料・登録不要・アップロードしたCSVはブラウザの外に送信されません
よくある質問
CSVにヘッダー(1行目)がまったくない場合はどう確認すればよいですか?
ヘッダーのないファイルには、名前として比較する文字列そのものがないため、受け取るプログラムは列の位置だけで値を判断します。この場合は、プログラムが定めたn番目の列の意味をドキュメントで確認し、その順序に合わせて列を配置する必要があります。
区切り文字がカンマではなくセミコロンなら、CSVファイルではないのですか?
拡張子が.csvでも、実際の区切り文字がカンマとは限りません。地域ごとのソフトウェア設定によって、セミコロンやタブで区切られたファイルを出力するケースはよくあり、これもCSVとして扱われます。開く前にテキストエディタで1行目を確認し、実際の区切り文字を把握しておくほうが安全です。
Excelで保存すれば、ヘッダーの前後の空白は自動的に削除されませんか?
いいえ。Excelはセルに入力された空白をそのまま保存し、保存時に自動で整理することはありません。目で見ただけでは空白の有無を判断しにくいため、ヘッダーが正確に一致しているか確認するには、別途整える工程が必要です。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む