JSON コンバータ
C#を使用したExcel変換のためのJSON配列のフラット化方法

C#を使用したExcel変換のためのJSON配列のフラット化方法

現代のAPIやウェブサービスを扱う際、開発者はしばしば、深くネストされた配列やオブジェクトを持つ複雑なJSON構造に直面します。これらの階層構造をフラットなExcelテーブルに変換することは、大きな課題となります。このガイドでは、Aspose.Cells for .NETを使用して、ネストされたJSON配列をExcelに効果的に変換する方法を示します。

課題：複雑なネストされたJSON構造

以下は、ウェブAPIからの典型的なJSONレスポンスです：

{
  "company": "Acme Corp",
  "departments": [
    {
      "name": "Engineering",
      "employees": [
        {
          "id": 101,
          "name": "John Smith",
          "skills": ["C#", "ASP.NET", "Azure"]
        },
        {
          "id": 102,
          "name": "Jane Doe",
          "skills": ["JavaScript", "React", "Node.js"]
        }
      ]
    },
    {
      "name": "Marketing",
      "employees": [
        {
          "id": 201,
          "name": "Michael Johnson",
          "skills": ["Content Strategy", "SEO", "Analytics"]
        }
      ]
    }
  ]
}

この階層データをフラットなExcelテーブルに変換することは、いくつかの課題を引き起こします：

  • 複数のネストされた配列（部門、従業員、スキル）をどのように処理するか
  • 親アイテムと子アイテム間の関係をどのように維持するか
  • 読みやすいスプレッドシート構造をどのように作成するか

ステップバイステップの解決策

ステップ 1: Aspose.Cellsのインストール

まず、Aspose.Cells for .NETをインストールします：

dotnet add package Aspose.Cells

ステップ 2: JsonLayoutOptionsの設定

配列を処理するために適切に構成されたJsonLayoutOptionsを作成します：

using Aspose.Cells;
using Aspose.Cells.Utility;

// 配列処理のためのJsonLayoutOptionsを作成
JsonLayoutOptions options = new JsonLayoutOptions();
options.ArrayAsTable = true;  // フラット化に重要
options.ConvertNumericOrDate = true;
options.IgnoreNull = true;

ステップ 3: 複雑なJSONデータの読み込み

複雑なネストされたJSONデータを読み込みます：

// ネストされた配列を含むサンプルJSON
string jsonData = File.ReadAllText("complex_data.json");

// ワークブックとワークシートを初期化
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

ステップ 4: 高度なフラット化の設定

高度なネストされた構造に対して、カスタムフラット化ソリューションを実装します：

// 開始セルの位置を定義
int startRow = 0;
int startColumn = 0;

// 設定したオプションでJSONデータをインポート
JsonUtility.ImportData(jsonData, worksheet.Cells, startRow, startColumn, options);

ステップ 5: マルチレベルネストされた配列の処理

複雑なマルチレベル配列には追加の処理が必要です：

// 詳細な従業員データ用の二つ目のワークシートを作成
Worksheet employeeSheet = workbook.Worksheets.Add("Employees");
int empRow = 0;

// 従業員シートのヘッダーを追加
string[] headers = { "Department", "Employee ID", "Employee Name", "Skills" };
for (int i = 0; i < headers.Length; i++)
{
    employeeSheet.Cells[empRow, i].PutValue(headers[i]);
}
empRow++;

// JSONを解析して従業員データを抽出してフラット化
// 注意：これにはNewtonsoft.JsonのようなJSON解析ライブラリが必要です
// JObject root = JObject.Parse(jsonData);
// foreach (var dept in root["departments"]) 
// {
//     string deptName = dept["name"].ToString();
//     foreach (var emp in dept["employees"])
//     {
//         employeeSheet.Cells[empRow, 0].PutValue(deptName);
//         employeeSheet.Cells[empRow, 1].PutValue((int)emp["id"]);
//         employeeSheet.Cells[empRow, 2].PutValue(emp["name"].ToString());
//         employeeSheet.Cells[empRow, 3].PutValue(string.Join(", ", emp["skills"].ToObject<string[]>()));
//         empRow++;
//     }
// }

ステップ 6: プロフェッショナルなフォーマットの適用

適切なフォーマットで可読性を向上させます：

// ヘッダー付きのテーブルとして両方のワークシートをフォーマット
worksheet.ListObjects.Add(0, 0, worksheet.Cells.LastCell.Row, worksheet.Cells.LastCell.Column, true);
employeeSheet.ListObjects.Add(0, 0, empRow - 1, 3, true);

// より良い可読性のために列を自動調整
worksheet.AutoFitColumns();
employeeSheet.AutoFitColumns();

ステップ 7: 結果の保存

フラット化されたデータを持つワークブックをエクスポートします：

// Excelファイルとして保存
workbook.Save("flattened_data.xlsx");

Aspose.Cellsを使用した簡略化されたソリューション

多くのシナリオにおいて、Aspose.Cellsは組み込みのJSON処理を使用してより簡単なアプローチを提供します：

// ワークブックを初期化
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

// JSONインポートオプションを設定
JsonLayoutOptions options = new JsonLayoutOptions
{
    ArrayAsTable = true,
    ConvertNumericOrDate = true,
    IgnoreNull = true,
    TitleStyle = new CellsFactory().CreateStyle(),
    NestedArrayAsTable = true  // ネストされた配列に重要
};

// より良い可読性のためにタイトルスタイルを設定
options.TitleStyle.Font.IsBold = true;

// JSONをインポート
JsonUtility.ImportData(jsonData, sheet.Cells, 0, 0, options);

// 結果を保存
workbook.Save("flattened_output.xlsx");

重要な洞察とベストプラクティス

  1. ArrayAsTable = trueを使用 - 配列の適切な表現に不可欠です
  2. 複雑な階層データには複数のワークシートを作成することを検討
  3. 出力をより読みやすくするためにフォーマットを適用
  4. ネストされた構造のより良い処理のためにNestedArrayAsTable = trueを使用
  5. 非常に複雑な構造の場合は、インポート前にJSONを前処理することを検討

よくある問題と解決策

問題解決策
ネストされた配列が単一のセルとして表示されるArrayAsTableおよびNestedArrayAsTableオプションを有効にする
データの関係が失われる関係列を持つ複数のテーブル/シートを作成する
列名が不正確DateTimeGroupSeparatorオプションを使用して命名をカスタマイズ
大きなファイルのメモリ問題JSONをチャンクで処理するか、ストリーミングアプローチを使用
 日本語