JSONからCSVへ

例

入力：

[
  { "id": 1, "user": { "name": "Alice", "email": "a@a.com" }, "tags": ["admin"] },
  { "id": 2, "user": { "name": "Bob",   "email": "b@b.com" }, "tags": ["user", "beta"] }
]

出力（ネストされた配列をフラット化し、配列を結合する）：

id,user.name,user.email,tags
1,Alice,a@a.com,admin
2,Bob,b@b.com,"user,beta"

配列区切り文字の選択

引用ルール

フィールドに以下の内容が含まれている場合は、引用符を付ける必要があります：

• 区切り文字
• 二重引用符（二重にすることでエスケープされます：" → ""）
• 改行

「常に引用する」は複数のツールとの互換性を確保する上でより安全です。「必要に応じてのみ引用する」とすると、ファイルを手動で読み取りやすくなります。

ネストされたオブジェクトの処理

• フラット化：{ user: { name: "A" } }はuser.nameの列に変換されます。深い階層のパスはa.b.c.dに変換されます。
• JSON文字列：ネストされたオブジェクトは単一の列形式のJSON値として保持されます（例："{\"name\":\"A\"}"）。後続のツールがこれを解析できる場合に有用です。
• 文字列化：区切り文字で結合し、構造を失います。

配列の処理

• 結合する：["a", "b"]は単一の列で"a,b"に変換されます。
• インデックス付き列：tags.0、tags.1、tags.2を生成します。この機能は配列の長さが一定である場合にのみ利用可能です。
• 最初の要素のみ：tags[0]のみを取得し、他の要素は無視します。

よくある間違い

• オブジェクト間でキーが一致していない場合。 あるオブジェクトにはphoneが含まれているが別のオブジェクトには含まれていない場合、CSVには欠落する行に対応する空のセルを持つphone列が生成されます。常にキーセットの一貫性を確認してください。
• ExcelにおけるBOMの無視について。 Windows環境のExcelでは、BOMが含まれていないUTF-8形式のCSVファイルをLatin-1として読み取り、アクセント付き文字を誤って表示します。この場合、ツールには「UTF-8 BOMプレフィックス」の有無を選択できるオプションが用意されています。
• 値に改行を埋め込む。 RFC 4180のCSVでは許可されているが、一部のインポートソフトウェアでは問題が発生する場合がある。対象データが脆弱な場合は、\nをスペースまたは\\nトークンに置き換えてください。
• Excelを往復形式として使用する場合。 Excelは007を静かに7に変換し、長い数値を切り捨て、ID内の先頭のゼロを破損させます。データの整合性を確保するには、適切なパーサを使用したCSVファイルをご利用ください。