Hvordan til at Flatte JSON Array for Excel Conversion med C#

Når man arbejder med moderne API’er og webtjenester, møder udviklere ofte komplekse JSON-strukturer med dybt nestede arader og objekter. Konvertering af disse hierarkiske strukturer til flad Excel-tabler præsenterer en betydelig udfordring. Denne vejledning viser, hvordan man effektivt konverterer Nestede JSon-arader til Excel ved hjælp af Aspose.Cells for .NET.

Udfordringen: Kompleks Nested JSON strukturer

Tænk på denne typiske JSON-respons fra 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"]
        }
      ]
    }
  ]
}

Konvertering af disse hierarkiske data til en flad Excel tabel skaber flere udfordringer:

Hvordan man håndterer flere nestede arranger (afdelinger, medarbejdere, færdigheder)
Hvordan man opretholder relationer mellem forældre og børn
Hvordan man opretter en læsbar spreadsheet struktur

Step-by-Step løsning

Trin 1: Installere Aspose.Cells

Først installere Aspose.Cells for .NET:

dotnet add package Aspose.Cells

Trin 2: Indstill JsonLayoutOptions

Skab korrekt konfigurerede JsonLayoutOptions til at håndtere 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;

Trin 3: Opladning af JSON data

Lad din komplekse Nested JSON-data op:

// 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];

Trin 4: Konfigurer avanceret fladtning

For avancerede nestede strukturer implementeres en tilpasset flæningslø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);

Trin 5: Håndtering af multi-niveau Nested Arrays

For komplekse multi-niveau arrader har vi brug for yderligere 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++;
//     }
// }

Trin 6: Anvend professionel formatering

Forbedre læsbarhed med korrekt 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: Beskytt resultatet

Eksportere arbejdsbogen med flatte data:

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

En forenklet løsning ved hjælp af Aspose.cells

For mange scenarier giver Aspose.Cells en nemmere tilgang ved hjælp af sin indbyggede 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");

Nøgleindsigt og bedste praksis

Use ArrayAsTable = true - Dette er afgørende for korrekt repræsentation af arrayer
Tænk på at oprette flere workshops for komplekse hierarkiske data
Anvend formatering for at gøre udgangen mere læsbar
Brug NestedArrayAsTable = ægte når det er til rådighed for bedre håndtering af nestede strukturer
For ekstremt komplekse strukturer overveje at forhåndsbehandling JSON før import

fælles problemer og løsninger

Spørgsmål	Løsning
Nestede aræer vises som enkeltceller	Enable `ArrayAsTable` and `NestedArrayAsTable` options
Dataforbindelser er tabt	Skab flere tabeller/sæt med relationer kolumner
Kolonnenavne er forkerte	Use the `DateTimeGroupSeparator` option to customize naming
hukommelsespørgsmål med store filer	Behandle JSON i stykker eller bruge streamingmetoder