El convertidor JSON
Com fer Flat JSON Array per a la conversió d'Excel amb C#

Com fer Flat JSON Array per a la conversió d'Excel amb C#

Quan treballen amb les APIs modernes i els serveis web, els desenvolupadors sovint troben estructures JSON complexes amb arrels i objectes profundament nested. Convertir aquestes estructuras jeràrquics en taules de Excel plana presenta un repte significatiu. Aquest guia demostra com convertir eficaçment a l’arrel de NESTed a Excel utilitzant Aspose.Cells per a .NET.

El repte: estructures complexes Nested JSON

Considera aquesta resposta JSON típica d’una API web:

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

Convertir aquests dades jeràrquics en una taula plana d’Excel crea diversos reptes:

  • Com gestionar múltiples arrels nestades (departaments, empleats, habilitats)
  • Com mantenir les relacions entre pares i infants
  • Com crear una estructura de fletxa lliure

Solució de pas a pas

Pas 1: Instal·lar Aspose.Cells

Primer, instal·la Aspose.Cells per a .NET:

dotnet add package Aspose.Cells

Pas 2: Instal·lació de JsonLayoutOptions

Crear opcions JsonLayout correctament configurades per gestionar les arrels:

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;

Pas 3: Carregar les dades complexes JSON

Carrega les teves dades complexes de JSON:

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

Pas 4: Configuració avançada Flattening

Per a estructures nestades avançades, implementar una solució de flotatge personalitzada:

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

Pas 5: Gestió d’arres Nested de múltiples nivells

Per a complexos arrels multi-nivells, necessitem un processament addicional:

// 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++;
//     }
// }

Pas 6: Aplica la formatació professional

Millorar la lectura amb el correcte format:

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

Pas 7: Salvar el resultat

Exportar el llibre de treball amb dades flatulents:

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

Una solució simplificada amb Aspose.Cells

Per a molts escenaris, Aspose.Cells proporciona un enfocament més senzill utilitzant el seu maneig JSON integrat:

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

Consideracions clau i millors pràctiques

  • Use ArrayAsTable = veritable - Això és essencial per a la correcta representació dels arrels
  • Considerar la creació de múltiples tauletes per a dades jeràrquics complexes
  • Aplicar el format per fer que la producció sigui més llegible
  • Use NestedArrayAsTable = veritable quan està disponible per a una millor gestió de les estructures nestades
  • Per a estructures extremadament complexes, considereu pre-processar el JSON abans d’importar

Problemes comuns i solucions

qüestióSolució
Les arrels Nested apareixen com a cèl·lules solesEnable ArrayAsTable and NestedArrayAsTable options
Les relacions de dades estan perdudesCreació de taules / taules múltiples amb columnes de relació
Els noms de columnes són incorrectesUse the DateTimeGroupSeparator option to customize naming
Problemes de memòria amb grans fitxersProcessar el JSON en trossos o utilitzar enfocaments de streaming
 Català