JSONをCSVに変換

仕組み

JSONはAPIが返すもの、CSVはスプレッドシートが開けるものです。一方から他方への変換は、絶えず発生する小さな作業で、たいていはペイロードを適当なWebサイトに貼り付けて済まされます。そのペイロードには、顧客名、メールアドレス、注文の詳細が日常的に含まれています。これはページ内で変換するため、データはお手元にとどまります。

想定している形

オブジェクトの配列で、一覧を返すエンドポイントが通常返す形です。列の見出しは、すべてのレコードにわたって集められたキーから取られるため、フィールドが欠けている行も、正しく揃います。単一のオブジェクトは、1行の表として扱われます。

引用符も正しく処理されます

カンマ、引用符、改行を含む値は、引用符で囲まれ、内部がエスケープされます。これはスプレッドシートが想定するのと同じ規則です。自前で書いた変換処理がほぼ必ず間違える部分で、住所の列がしょっちゅうCSVを壊す理由でもあります。

入れ子の値

それ自体がオブジェクトや配列である値は、CSVが平坦で、ほかに置き場所がないため、セル内にJSONテキストとして書き込まれます。それらのフィールドが重要な場合は、先に構造をフラット化してください。

区切り文字を選ぶ

カンマが標準です。セミコロンは、カンマが小数点として使われるロケールでExcelが想定する区切り文字で、スプレッドシートでファイルを開くとすべてが1列に詰め込まれる場合は、たいていこれが原因です。データ自体に句読点が多い場合は、タブが最も安全です。