Hur man plattar ut JSON-array för Excel-konvertering med C#

När man arbetar med moderna APIs och webbtjänster möter utvecklare ofta komplexa JSON-strukturer med djupt nestade arrayer och objekt. Konvertera dessa hierarkiska strukturer till platta Excel-tabeller presenterar en betydande utmaning. Denna guide visar hur man effektivt konverterar nestade JSON-arrayer till Excel med Aspose.Cells för .NET.

Utmaningen: komplexa Nested JSON-strukturer

Tänk på denna typiska JSON-respons från en web-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"]
        }
      ]
    }
  ]
}

Att konvertera dessa hierarkiska data till en platt Excel-tabell skapar flera utmaningar:

Hur man hanterar flera nötter (avdelningar, anställda, färdigheter)
Hur man upprätthåller relationer mellan föräldrar och barn objekt
Hur man skapar en läsbar spreadsheet struktur

steg för steg lösning

Steg 1: Installera Aspose.Cells

Först installera Aspose.Cells för .NET:

dotnet add package Aspose.Cells

Steg 2: Ställ in JsonLayoutOptions

Skapa korrekt konfigurerade JsonLayoutOptions för att hantera arrayer:

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;

Steg 3: Ladda upp JSON-data

Ladda upp din komplexa nestade 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: Konfigurera Avancerad Flattening

För avancerade nestade strukturer, implementera en anpassad flätningslö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: Hantera Multi-Level Nested Arrays

För komplexa multi-nivåar behöver vi ytterligare bearbetning:

// 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: Applicera professionell formatering

Förbättra läsbarheten med rätt 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: Spara resultatet

Exportera arbetsboken med flätade data:

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

En förenklad lösning med Aspose.Cells

För många scenarier erbjuder Aspose.Cells ett enklare tillvägagångssätt med hjälp av dess inbyggda JSON-hantering:

// 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");

Viktiga insikter och bästa praxis

Use ArrayAsTable = true - Detta är viktigt för korrekt representation av array
Tänk på att skapa flera arbetsböcker för komplexa hierarkiska data
Applicera formatering för att göra utgåvan mer läsbar
Använda NestedArrayAsTable = sant när det är tillgängligt för bättre hantering av nestade strukturer
För extremt komplexa strukturer, överväga förbehandling av JSON innan import

Vanliga problem och lösningar

frågan	Lösning
Nestade armar visas som enskilda celler	Enable `ArrayAsTable` and `NestedArrayAsTable` options
Dataförhållanden förloras	Skapa flera tabeller/skivor med relationskolumner
Kolumnnamn är felaktig	Use the `DateTimeGroupSeparator` option to customize naming
Memoriproblem med stora filer	Processera JSON i bitar eller använda streamingmetoder