Konvertor JSON
Jak zploštit JSON pole pro převod do Excelu pomocí C#

Jak zploštit JSON pole pro převod do Excelu pomocí C#

Když pracujete s moderními API a webovými službami, vývojáři se často setkávají se složitými JSON strukturami s hluboce zanořenými poli a objekty. Převod těchto hierarchických struktur na ploché Excel tabulky představuje značnou výzvu. Tento průvodce ukazuje, jak efektivně převést zanořená JSON pole do Excelu pomocí Aspose.Cells pro .NET.

Výzva: Složité Zanořené JSON Struktury

Zvažte tuto typickou JSON odpověď z webového API:

{
  "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"]
        }
      ]
    }
  ]
}

Převod těchto hierarchických dat na plochou Excel tabulku přináší několik výzev:

  • Jak se vypořádat s více zanořenými poli (oddělení, zaměstnanci, dovednosti)
  • Jak udržet vztahy mezi rodičovskými a dětskými položkami
  • Jak vytvořit čitelnou strukturu tabulky

Krok za Krokem Řešení

Krok 1: Nainstalujte Aspose.Cells

Nejprve nainstalujte Aspose.Cells pro .NET:

dotnet add package Aspose.Cells

Krok 2: Nastavte JsonLayoutOptions

Vytvořte správně nakonfigurované JsonLayoutOptions pro zpracování polí:

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

// Vytvořte JsonLayoutOptions s obsluhou polí
JsonLayoutOptions options = new JsonLayoutOptions();
options.ArrayAsTable = true;  // Klíčové pro správné zploštění
options.ConvertNumericOrDate = true;
options.IgnoreNull = true;

Krok 3: Načtěte Složitá JSON Data

Načtěte svá složitá zanořená JSON data:

// Ukázkový JSON se zanořenými poli
string jsonData = File.ReadAllText("complex_data.json");

// Inicializujte pracovní sešit a list
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

Krok 4: Nakonfigurujte Pokročilé Zploštění

Pro pokročilé zanořené struktury implementujte vlastní zplošťovací řešení:

// Definujte počáteční pozici buňky
int startRow = 0;
int startColumn = 0;

// Importujte JSON data s našimi nakonfigurovanými možnostmi
JsonUtility.ImportData(jsonData, worksheet.Cells, startRow, startColumn, options);

Krok 5: Zpracování Víceúrovňových Zanořených Polí

Pro složité víceúrovňové pole potřebujeme další zpracování:

// Vytvořte druhý list pro podrobné údaje o zaměstnancích
Worksheet employeeSheet = workbook.Worksheets.Add("Employees");
int empRow = 0;

// Přidejte záhlaví pro list zaměstnanců
string[] headers = { "Department", "Employee ID", "Employee Name", "Skills" };
for (int i = 0; i < headers.Length; i++)
{
    employeeSheet.Cells[empRow, i].PutValue(headers[i]);
}
empRow++;

// Analyzujte JSON pro extrakci a zploštění údajů o zaměstnancích
// Poznámka: To by vyžadovalo knihovnu pro analýzu JSON, jako je Newtonsoft.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++;
//     }
// }

Krok 6: Použijte Profesionální Formátování

Zvyšte čitelnost správným formátováním:

// Formátujte oba listy jako tabulky se záhlavími
worksheet.ListObjects.Add(0, 0, worksheet.Cells.LastCell.Row, worksheet.Cells.LastCell.Column, true);
employeeSheet.ListObjects.Add(0, 0, empRow - 1, 3, true);

// Automaticky přizpůsobte sloupce pro lepší čitelnost
worksheet.AutoFitColumns();
employeeSheet.AutoFitColumns();

Krok 7: Uložte Výsledek

Exportujte pracovní sešit se zploštěnými daty:

// Uložte jako Excel soubor
workbook.Save("flattened_data.xlsx");

Zjednodušené Řešení Pomocí Aspose.Cells

Pro mnohé scénáře poskytuje Aspose.Cells jednodušší přístup pomocí svého vestavěného zpracování JSON:

// Inicializujte pracovní sešit
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

// Nakonfigurujte možnosti importu JSON
JsonLayoutOptions options = new JsonLayoutOptions
{
    ArrayAsTable = true,
    ConvertNumericOrDate = true,
    IgnoreNull = true,
    TitleStyle = new CellsFactory().CreateStyle(),
    NestedArrayAsTable = true  // Důležité pro zanořená pole
};

// Nastavte styl názvu pro lepší čitelnost
options.TitleStyle.Font.IsBold = true;

// Importujte JSON
JsonUtility.ImportData(jsonData, sheet.Cells, 0, 0, options);

// Uložte výsledek
workbook.Save("flattened_output.xlsx");

Klíčové Postřehy a Nejlepší Praktiky

  1. Použijte ArrayAsTable = true - To je zásadní pro správnou reprezentaci polí
  2. Zvažte vytvoření více listů pro složitá hierarchická data
  3. Použijte formátování pro zlepšení čitelnosti výstupu
  4. Použijte NestedArrayAsTable = true když je to možné pro lepší zpracování zanořených struktur
  5. Pro extrémně složité struktury zvažte předzpracování JSON před importem

Běžné Problémy a Řešení

ProblémŘešení
Zanořená pole se objevují jako jednotlivé buňkyAktivujte možnosti ArrayAsTable a NestedArrayAsTable
Vztahy mezi daty jsou ztracenyVytvořte více tabulek/listů s vztahovými sloupci
Názvy sloupců jsou nesprávnéPoužijte možnost DateTimeGroupSeparator pro přizpůsobení názvů
Problémy s pamětí u velkých souborůZpracovávejte JSON po částech nebo použijte streamovací přístupy
 Čeština