JSON Excel 変換

JSON API の応答では、レコードがメタデータでラップされていることがよくあります。

{
  "page": 1,
  "results": [
    {"id": 1, "name": "Ada"},
    {"id": 2, "name": "Lin"}
  ]
}

レコードセレクターは results を推奨し、そこに 2 つのレコードが含まれていることを示します。

単一のオブジェクトを選択した場合、ツールは 1 行を作成します。表形式のレコードセットが存在しない場合、プレビューはなぜその構造がワークシートにきれいにマッピングできないのかを説明します。

ネストされたオブジェクトは、ドットパスを使用した列名を使用できます：

customer.name
customer.address.city

• フラット化のオン/オフ
• パス区切り文字
• 最大深度
• 深度を超える値を JSON テキストとして保持

ワークシートのプレビューには、ファイルが生成される前の最終的なヘッダーが表示されます。

プリミティブ配列の結合

プリミティブ配列は 1 つのセルになります。デフォルトの結合区切り文字は | です。

JSON テキストとして保持

スプレッドシートの利便性よりもロスレス構造が重要な場合は、セル内に完全な配列を保持します。

デフォルトの設定では、配列要素が黙って破棄されることはありません。

レコードに含まれるキーが異なる場合、ツールは選択されたレコード全体のフィールドの和集合を作成します。

• 欠損値を空白または選択されたプレースホルダーとして表示
• フラット化によって重複ヘッダーが作成された場合に警告
• 決定論的な順序を維持

最終的なワークシートに同じヘッダーが 2 回表示されることはありません。

• JSON 数値 → 数値の Excel セル
• JSON boolean → boolean のセル
• JSON 文字列 → テキストのセル
• JSON null → 空白のセル

日付形式の文字列には明示的なオプションが必要です。ISO 形式のすべての文字列を自動的に Excel の日付に変換すると、識別子やソーステキストが変更されてしまう可能性があるため、認識された日付はオプションが有効な場合にのみ変換されます。

ワークシート名（XLSX の命名規則に従って検証されます）とダウンロードファイル名を設定できます。シート名に Excel が禁止している文字が含まれている場合は、自動的にクリーンアップされます。

プレビューには、ワークブックが生成される前に、選択されたレコードパス、レコード数、最終的な列、配列とフラット化の警告、サンプルの行が表示されます。

すべてのデータが 1 つのセルに表示される

間違った JSON ノードが選択されているか、ネストされた値が JSON テキストとして保持されています。 レコード配列を選択し、適切なフラット化モードを有効にしてください。

配列の値が欠落している

配列戦略を変更してください。 サポートされていないデフォルト値を使用する代わりに、結合、保持、または展開を行います。

一部の列が空白になる

JSON レコードに異なるキーが含まれています。 ワークブックは列の和集合を使用するため、欠損しているフィールドは空白のままになります。

長い数値が変更された

スプレッドシートの数値精度が不十分な可能性があります。 識別子や非常に大きな整数はテキストとしてエクスポートしてください。

日付の形式が変わってしまった

日付形式の文字列をテキストとして保持するか、意図的な Excel 日付変換を選択してください。 自動日付処理はオプションのままです。