Complex JSON to flat JSON in React Pivotview component

13 Sep 202524 minutes to read

Overview

The React Pivot Table component requires data in flat JSON format for proper binding. This guide explains how to convert complex, nested JSON structures to flat JSON format and bind it to the pivot table.

Understanding complex vs flat JSON

Complex JSON contains nested objects and arrays, making it difficult to directly bind to the pivot table. For example:

{
  "CustomerID": "VINET",
  "Freight": 32.38,
  "OrderDetails": [
    {
      "OrderID": 10248,
      "OrderDate": "1996-07-04T10:10:00.000Z"
    }
  ],
  "ShipDetails": [
    {
      "ShipName": "Vins et alcools Chevalier",
      "ShipAddress": "59 rue de l'Abbaye",
      "ShipCity": "Reims",
      "ShipRegion": null,
      "ShipCountry": "France",
      "ShippedDate": "1996-07-16T12:20:00.000Z"
    }
  ]
}

Flat JSON has a simple key-value structure without nesting, which is suitable for pivot table binding:

{
  "CustomerID": "VINET",
  "Freight": 32.38,
  "OrderID": 10248,
  "OrderDate": "1996-07-04T10:10:00.000Z",
  "ShipName": "Vins et alcools Chevalier",
  "ShipAddress": "59 rue de l'Abbaye",
  "ShipCity": "Reims",
  "ShipRegion": null,
  "ShipCountry": "France",
  "ShippedDate": "1996-07-16T12:20:00.000Z"
}

Implementation

You can convert complex JSON to flat JSON programmatically and bind it to the pivot table using the dataSource property in the load event.

In the following example, the complexToFlatJson() method is used to convert complex JSON to flat JSON and bind it to the pivot table using the dataSource property, then modifying the field names in the rows and columns based on the converted flat JSON under dataSourceSettings in the load event.

import { FieldList, Inject, PivotViewComponent } from '@syncfusion/ej2-react-pivotview';
import * as React from 'react';

function App() {

    let dataSourceSettings = {
        expandAll: true,
        enableSorting: true,
        dataSource: data(),
        columns: [{ name: 'OrderDetails' }],
        values: [{ name: 'Freight', caption: 'Units Sold' }],
        rows: [{ name: 'ShipDetails' }],
        valueSortSettings: { headerDelimiter: ' - ' },
        formatSettings: [{ name: 'Amount', format: 'C0' }]
    }

    let pivotObj;
    let parentProp = {};
    let dataSource;

    function onLoad(args) {
        dataSource = JSON.parse(JSON.stringify(args.dataSourceSettings.dataSource));
        args.dataSourceSettings.dataSource = complexToFlatJson(dataSource);
        let rows = [];
        for (let i = 0; i < args?.dataSourceSettings?.rows?.length; i++) {
            if (args.dataSourceSettings.rows[i].name in parentProp) {
                rows = rows.concat(parentProp[args.dataSourceSettings.rows[i].name]);
            } else {
                rows.push(args.dataSourceSettings.rows[i]);
            }
        }
        args.dataSourceSettings.rows = rows;
        let columns = [];
        for (let i = 0; i < args.dataSourceSettings.columns.length; i++) {
            if (args.dataSourceSettings.columns[i].name in parentProp) {
                columns = columns.concat(
                    parentProp[args.dataSourceSettings.columns[i].name]
                );
            } else {
                columns.push(args.dataSourceSettings.columns[i]);
            }
        }
        args.dataSourceSettings.columns = columns;
    }

    function complexToFlatJson(data) {
        let flatArray = [];
        let flatObject = {};
        for (let index = 0; index < data.length; index++) {
            for (let prop in data[index]) {
                let value = data[index][prop];
                if (Array.isArray(value)) {
                    for (let i = 0; i < value.length; i++) {
                        let childProp = [];
                        for (let inProp in value[i]) {
                            flatObject[inProp] = value[i][inProp];
                            let object = {
                                name: inProp,
                            };
                            childProp.push(object);
                        }
                        parentProp[prop] = childProp;
                    }
                } else {
                    flatObject[prop] = value;
                }
            }
            flatArray.push(flatObject);
            flatObject = {};
        }
        return flatArray;
    }

    function data() {
        return [
            {
                CustomerID: 'VINET',
                Freight: 32.38,
                OrderDetails: [
                    {
                        OrderID: 10248,
                        OrderDate: '1996-07-04T10:10:00.000Z',
                    }
                ],
                ShipDetails: [
                    {
                        ShipName: 'Vins et alcools Chevalier',
                        ShipAddress: "59 rue de l'Abbaye",
                        ShipCity: 'Reims',
                        ShipRegion: null,
                        ShipCountry: 'France',
                        ShippedDate: '1996-07-16T12:20:00.000Z',
                    }
                ]
            },
            {
                CustomerID: 'GALED',
                Freight: 10.14,
                OrderDetails: [
                    {
                        OrderID: 10366,
                        OrderDate: '1996-11-28T00:00:00.000Z',
                    }
                ],
                ShipDetails: [
                    {
                        ShippedDate: '1996-12-30T00:00:00.000Z',
                        ShipName: 'Galería del gastronómo',
                        ShipAddress: 'Rambla de Cataluña, 23',
                        ShipCity: 'Barcelona',
                        ShipRegion: null,
                        ShipCountry: 'Spain',
                    }
                ]
            },
            {
                CustomerID: 'VAFFE',
                Freight: 13.55,
                OrderDetails: [
                    {
                        OrderID: 10367,
                        OrderDate: '1996-12-02T00:00:00.000Z',
                    }
                ],
                ShipDetails: [
                    {
                        ShippedDate: '1996-12-30T00:00:00.000Z',
                        ShipName: 'Vaffeljernet',
                        ShipAddress: 'Smagsloget 45',
                        ShipCity: 'Århus',
                        ShipRegion: null,
                        ShipCountry: 'Denmark',
                    }
                ]
            },
            {
                CustomerID: 'ERNSH',
                Freight: 101.95,
                OrderDetails: [
                    {
                        OrderID: 10368,
                        OrderDate: '1996-11-29T00:00:00.000Z',
                    }
                ],
                ShipDetails: [
                    {
                        ShippedDate: '1996-12-30T00:00:00.000Z',
                        ShipName: 'Ernst Handel',
                        ShipAddress: 'Kirchgasse 6',
                        ShipCity: 'Graz',
                        ShipRegion: null,
                        ShipCountry: 'Austria',
                    }
                ]
            },
            {
                CustomerID: 'SPLIR',
                Freight: 195.68,
                OrderDetails: [
                    {
                        OrderID: 10369,
                        OrderDate: '1996-11-28T00:00:00.000Z',
                    }
                ],
                ShipDetails: [
                    {
                        ShippedDate: '1996-12-30T00:00:00.000Z',
                        ShipName: 'Split Rail Beer & Ale',
                        ShipAddress: 'P.O. Box 555',
                        ShipCity: 'Lander',
                        ShipRegion: 'WY',
                        ShipCountry: 'USA',
                    },
                ]
            }
        ];
    }

    return (<PivotViewComponent ref={d => pivotObj = d} id='PivotView' height={350}
        dataSourceSettings={dataSourceSettings} showFieldList={true} load={onLoad.bind(this)}>
        <Inject services={[FieldList]} />
    </PivotViewComponent>);

};
export default App;
import { FieldList, Inject, PivotViewComponent } from '@syncfusion/ej2-react-pivotview';
import { DataSourceSettingsModel } from '@syncfusion/ej2-pivotview/src/model/datasourcesettings-model';
import { enableRipple } from '@syncfusion/ej2-base';
import * as React from 'react';
enableRipple(false);

function App() {

  let dataSourceSettings: DataSourceSettingsModel = {
    expandAll: true,
    enableSorting: true,
    dataSource: data() as any,
    columns: [{ name: 'OrderDetails' }],
    values: [{ name: 'Freight', caption: 'Units Sold' }],
    rows: [{ name: 'ShipDetails' }],
    valueSortSettings: { headerDelimiter: ' - ' },
    formatSettings: [{ name: 'Amount', format: 'C0' }]
  }

  let pivotObj: PivotViewComponent;
  let parentProp: any = {};
  let dataSource: Object[][];

  function onLoad(args: any): void {
    dataSource = JSON.parse(JSON.stringify(args.dataSourceSettings.dataSource));
    args.dataSourceSettings.dataSource = complexToFlatJson(dataSource);
    let rows: any = [];
    for (let i: number = 0; i < args.dataSourceSettings.rows.length; i++) {
      if (args.dataSourceSettings.rows[i].name in parentProp) {
        rows = rows.concat(parentProp[args.dataSourceSettings.rows[i].name]);
      } else {
        rows.push(args.dataSourceSettings.rows[i]);
      }
    }
    args.dataSourceSettings.rows = rows;
    let columns: any = [];
    for (let i: number = 0; i < args.dataSourceSettings.columns.length; i++) {
      if (args.dataSourceSettings.columns[i].name in parentProp) {
        columns = columns.concat(
          parentProp[args.dataSourceSettings.columns[i].name]
        );
      } else {
        columns.push(args.dataSourceSettings.columns[i]);
      }
    }
    args.dataSourceSettings.columns = columns;
  }

  function complexToFlatJson(data: Object[][]) {
    let flatArray: any = [];
    let flatObject: any = {};
    for (let index = 0; index < data.length; index++) {
      for (let prop in data[index]) {
        let value: Object = data[index][prop];
        if (Array.isArray(value)) {
          for (let i: number = 0; i < value.length; i++) {
            let childProp: any = [];
            for (let inProp in value[i]) {
              flatObject[inProp] = value[i][inProp];
              let object = {
                name: inProp,
              };
              childProp.push(object);
            }
            parentProp[prop] = childProp;
          }
        } else {
          flatObject[prop] = value;
        }
      }
      flatArray.push(flatObject);
      flatObject = {};
    }
    return flatArray;
  }

  function data() {
    return [
      {
        CustomerID: 'VINET',
        Freight: 32.38,
        OrderDetails: [
          {
            OrderID: 10248,
            OrderDate: '1996-07-04T10:10:00.000Z',
          }
        ],
        ShipDetails: [
          {
            ShipName: 'Vins et alcools Chevalier',
            ShipAddress: "59 rue de l'Abbaye",
            ShipCity: 'Reims',
            ShipRegion: null,
            ShipCountry: 'France',
            ShippedDate: '1996-07-16T12:20:00.000Z',
          }
        ]
      },
      {
        CustomerID: 'GALED',
        Freight: 10.14,
        OrderDetails: [
          {
            OrderID: 10366,
            OrderDate: '1996-11-28T00:00:00.000Z',
          }
        ],
        ShipDetails: [
          {
            ShippedDate: '1996-12-30T00:00:00.000Z',
            ShipName: 'Galería del gastronómo',
            ShipAddress: 'Rambla de Cataluña, 23',
            ShipCity: 'Barcelona',
            ShipRegion: null,
            ShipCountry: 'Spain',
          }
        ]
      },
      {
        CustomerID: 'VAFFE',
        Freight: 13.55,
        OrderDetails: [
          {
            OrderID: 10367,
            OrderDate: '1996-12-02T00:00:00.000Z',
          }
        ],
        ShipDetails: [
          {
            ShippedDate: '1996-12-30T00:00:00.000Z',
            ShipName: 'Vaffeljernet',
            ShipAddress: 'Smagsloget 45',
            ShipCity: 'Århus',
            ShipRegion: null,
            ShipCountry: 'Denmark',
          }
        ]
      },
      {
        CustomerID: 'ERNSH',
        Freight: 101.95,
        OrderDetails: [
          {
            OrderID: 10368,
            OrderDate: '1996-11-29T00:00:00.000Z',
          }
        ],
        ShipDetails: [
          {
            ShippedDate: '1996-12-30T00:00:00.000Z',
            ShipName: 'Ernst Handel',
            ShipAddress: 'Kirchgasse 6',
            ShipCity: 'Graz',
            ShipRegion: null,
            ShipCountry: 'Austria',
          }
        ]
      },
      {
        CustomerID: 'SPLIR',
        Freight: 195.68,
        OrderDetails: [
          {
            OrderID: 10369,
            OrderDate: '1996-11-28T00:00:00.000Z',
          }
        ],
        ShipDetails: [
          {
            ShippedDate: '1996-12-30T00:00:00.000Z',
            ShipName: 'Split Rail Beer & Ale',
            ShipAddress: 'P.O. Box 555',
            ShipCity: 'Lander',
            ShipRegion: 'WY',
            ShipCountry: 'USA',
          },
        ]
      }
    ];
  }

  return (<PivotViewComponent ref={ (d: PivotViewComponent) => pivotObj = d } id='PivotView' height={350}
    dataSourceSettings={dataSourceSettings} showFieldList={true} load={onLoad.bind(this)}>
    <Inject services={[FieldList]} />
  </PivotViewComponent>);

};
export default App;