Al trabajar con las APIs modernas y los servicios web, los desarrolladores a menudo encuentran estructuras JSON complejas con aráreas y objetos profundamente nidos. Convertir estos datos jerárquicos en tablas de Excel plana presenta un reto significativo. Esta guía demuestra cómo convertir de manera efectiva arásitos de jSON en Excel utilizando Aspose.Cells para .NET.

Introducción

Al trabajar con las APIs modernas y los servicios web, los desarrolladores a menudo encuentran estructuras JSON complejas con aráreas y objetos profundamente nidos. Convertir estos datos jerárquicos en tablas de Excel plana presenta un reto significativo. Esta guía demuestra cómo convertir de manera efectiva arásitos de jSON en Excel utilizando Aspose.Cells para .NET.

El desafío: las estructuras complejas de JSON

Considere esta respuesta JSON típica de una API web:

Convertir estos datos jerárquicos en una tabla plana de Excel crea varios retos:

  • Cómo gestionar múltiples arándanos (departamentos, empleados, habilidades)
  • Cómo mantener las relaciones entre padres y hijos
  • Cómo crear una estructura de spreadsheet ligable

Solución paso a paso

Paso 1: Instalar Aspose.Cells

En primer lugar, instale Aspose.Cells para .NET:

dotnet add package Aspose.Cells

Paso 2: Instalar JsonLayoutOptions

Crear correctamente configurado JsonLayoutOptions Para gestionar los arándanos:

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;

Paso 3: Cargar los datos complejos JSON

Cargue sus datos complejos 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];

Paso 4: Configure Flattening Avanzado

Para las estructuras de nido avanzadas, implementar una solución de flexión personalizada:

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

Paso 5: Tratar las arrastradas de multi-nivel

Para el complejo arras multi-nivel, necesitamos procesamiento adicional:

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

Paso 6: Aplique la formatación profesional

Mejora la lectura con el formato adecuado:

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

Paso 7: Salva el resultado

Exporta el libro de trabajo con datos flattados:

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

Una solución simplificada con Aspose.Cells

Para muchos escenarios, Aspose.Cells proporciona un enfoque más sencillo utilizando su manejo JSON integrado:

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

Principios y mejores prácticas

  • Use ArrayAsTable = verdad - Esto es esencial para la adecuada representación de los array
  • Considerar la creación de múltiples hojas de trabajo para los datos jerárquicos complejos
  • Aplicar el formato para hacer que la salida sea más ligable
  • Use NestedArrayAsTable = verdadero cuando esté disponible para un mejor manejo de estructuras nested
  • Para estructuras extremadamente complejas, considere pre-procesar el JSON antes de importar

Problemas Comunes y Soluciones

ProblemasSolución
Los arándanos se muestran como células únicasPermite ArrayAsTable y NestedArrayAsTable Opciones
Se perdieron las relaciones de datosCrear múltiples tablas/cortes con columnas de relación
Los nombres de las columnas son incorrectosUtilice el DateTimeGroupSeparator Opción para personalizar el nombre
Problemas de memoria con grandes archivosProcesar el JSON en fragmentos o utilizar enfoques de streaming

More in this category