Når du arbeider med moderne APIs og web-tjenester, møter utviklere ofte komplekse JSON-strukturer med dypt nestede arrayer og objekter. Konvertering av disse hierarkiske dataene til flat Excel-tabeller presenterer en betydelig utfordring. Denne guiden viser hvordan effektivt konvertere Nested JSon-array til Excel ved hjelp av Aspose.Cells for .NET .

Introduction

Når du arbeider med moderne APIs og web-tjenester, møter utviklere ofte komplekse JSON-strukturer med dypt nestede arrayer og objekter. Konvertering av disse hierarkiske dataene til flat Excel-tabeller presenterer en betydelig utfordring. Denne guiden viser hvordan effektivt konvertere Nested JSon-array til Excel ved hjelp av Aspose.Cells for .NET .

Utfordringen: Kompleks Nested JSON strukturer

Tenk på denne typiske JSON-responsen fra en web API:

Å konvertere disse hierarkiske dataene til en flat Excel-tabell skaper flere utfordringer:

  • Hvordan håndtere flere nestede arreller (avdelinger, ansatte, ferdigheter)
  • Hvordan opprettholde relasjoner mellom foreldre og barn elementer
  • Hvordan lage en lesbar spreadsheet struktur

Step-by-step løsning

Steg 1: Installere Aspose.Cells

Først installere Aspose.Cells for .NET:

dotnet add package Aspose.Cells

Steg 2: Sett opp JsonLayoutOptions

Gjør riktig konfigurert JsonLayoutOptions For å håndtere arene:

using Aspose.Cells;
using Aspose.Cells.Utility;
// Create JsonLayoutOptions with array handling
JsonLayoutOptions options = new JsonLayoutOptions();
options.ArrayAsTable = true;  // Crucial for proper flattening
options.ConvertNumericOrDate = true;
options.IgnoreNull = true;

Trinn 3: Last opp JSON-data

Last ned din komplekse nestede JSON-data:

// Sample JSON with nested arrays
string jsonData = File.ReadAllText("complex_data.json");
// Initialize workbook and worksheet
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

Steg 4: Konfigurere avansert flattening

For avanserte nestede strukturer, implementere en tilpasset flatteløsning:

// Define starting cell position
int startRow = 0;
int startColumn = 0;
// Import the JSON data with our configured options
JsonUtility.ImportData(jsonData, worksheet.Cells, startRow, startColumn, options);

Steg 5: Å håndtere multi-nivå Nested Arrays

For komplekse multi-nivå arreller, trenger vi ytterligere behandling:

// Create a second worksheet for detailed employee data
Worksheet employeeSheet = workbook.Worksheets.Add("Employees");
int empRow = 0;
// Add headers for the employee sheet
string[] headers = { "Department", "Employee ID", "Employee Name", "Skills" };
for (int i = 0; i < headers.Length; i++)
{
    employeeSheet.Cells[empRow, i].PutValue(headers[i]);
}
empRow++;
// Parse JSON to extract and flatten employee data
// Note: This would require a JSON parsing library like 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++;
//     }
// }

Steg 6: Apply Professional Formatting

Forbedre lesbarhet med riktig formatering:

// Format both worksheets as tables with headers
worksheet.ListObjects.Add(0, 0, worksheet.Cells.LastCell.Row, worksheet.Cells.LastCell.Column, true);
employeeSheet.ListObjects.Add(0, 0, empRow - 1, 3, true);
// Auto-fit columns for better readability
worksheet.AutoFitColumns();
employeeSheet.AutoFitColumns();

Steg 7: Spare resultatet

Eksporter arbeidsboken med flattede data:

// Save as Excel file
workbook.Save("flattened_data.xlsx");

En forenklet løsning ved hjelp av Aspose.Cells

For mange scenarier, Aspose.Cells gir en enklere tilnærming ved hjelp av sin innebygde JSON håndtering:

// Initialize workbook
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
// Configure JSON import options
JsonLayoutOptions options = new JsonLayoutOptions
{
    ArrayAsTable = true,
    ConvertNumericOrDate = true,
    IgnoreNull = true,
    TitleStyle = new CellsFactory().CreateStyle(),
    NestedArrayAsTable = true  // Important for nested arrays
};
// Set title style for better readability
options.TitleStyle.Font.IsBold = true;
// Import JSON
JsonUtility.ImportData(jsonData, sheet.Cells, 0, 0, options);
// Save result
workbook.Save("flattened_output.xlsx");

Viktige innsikt og beste praksis

  • Use ArrayAsTable = true - Dette er viktig for riktig representasjon av arrayer
  • Vurder å lage flere arbeidsplater for komplekse hierarkiske data
  • Apply formatting for å gjøre utgaven mer lesbar
  • ** Bruk NestedArrayAsTable = sann** når det er tilgjengelig for bedre håndtering av nestede strukturer
  • For ekstremt komplekse strukturer , vurdere forhåndsbehandling av JSON før import

Vanlige problemer og løsninger

IssueSolution
Nested arrays vises som enkeltcellerEnable ArrayAsTable og NestedArrayAsTable Alternativer
Data relasjoner er taptSkaper flere tabeller/sjetter med relasjonskolumner
Kolonne navn er feilBruk den DateTimeGroupSeparator Alternativ til å tilpasse navn
Memory problemer med store filerBehandle JSON i stykker eller bruk streaming tilnærminger

More in this category