JSON オブジェクトの配列を RFC 4180 準拠の CSV に変換します。ネストしたオブジェクトはドット区切りの列名に平坦化し、欠損フィールドにも対応。カンマ・セミコロン・タブ・パイプの区切り文字と Excel 用 BOM を選べます。
レコードを表に展開する。 オブジェクトの配列を貼り付けると、ヘッダー行付きの CSV が得られます。ネストしたオブジェクトはドット区切りの列名になり、欠けているフィールドは空セルに、区切り文字を含む値は RFC 4180 に従って引用符で囲まれます。
JSON はツリーで CSV は長方形です。したがってどんな変換でも、長方形に収まらない枝をどう扱うかを決めなければなりません。きれいに対応づく唯一の形が「平坦なオブジェクトの配列」で、オブジェクト 1 つが 1 行、キー 1 つが 1 列になります。それ以外はすべて追加のルールを要します。
ネストしたオブジェクトは簡単なほうです。{"role": {"team": "core"}} は role.team という列名になり、値の位置が分かるうえ、たいていの表計算ソフトのインポートウィザードも理解できます。難しいのはネストした配列です。展開すると行数が変わり、周囲のデータを黙って複製してしまいます。本ツールはそれらを 1 つのセル内に JSON テキストとして保持します。検索性は失われますが、元データに存在しないレコードを作り出すことは決してありません。
現実の JSON が均一であることはめったにありません。あるレコードには nickname があり次にはない、ある移行日以降にしか現れないフィールドがある、といった具合です。最初のオブジェクトだけを見て列を決める変換器は、それ以外を黙って捨ててしまいます。
ここでの列一覧は、全レコードの全キーの和集合を初出順に並べたものです。フィールドが欠けているレコードはスキップせず空セルを与えるため、行数は常に入力のレコード数と一致します。アルファベット順ではなく初出順を選んでいるのは、作者が意図したまとまりを保つためです。id と name が散らばらず先頭に残ります。
RFC 4180 は、区切り文字・二重引用符・改行のいずれかを含むフィールドを引用符で囲むよう定め、埋め込まれた引用符は二重にしてエスケープします。本ツールはヘッダーを含むすべてのセルにこの規則を適用するため、Grace, Jr. のような値や複数行の住所も、準拠したパーサーとの往復で壊れません。
区切り文字の選択は見た目以上に重要です。カンマを小数点に使う地域——ヨーロッパ大陸の多く——では Excel はセミコロンを期待し、そうでなければ行全体が A 列に押し込まれます。BOM オプションは UTF-8 バイト順マークを先頭に付けます。これが Windows 版 Excel に、レガシーコードページではなく UTF-8 として読むよう指示します。付けないと非 ASCII の名前が文字化けします。どちらも既定で無効なのは、他のツールを壊すからです。Excel に渡すときだけ有効にしてください。