Despite the COVID-19 outbreak, our team continues operating at full speed. We are always here to support and answer all your questions.

Feel free to reach out by filling this quick form.

Fill the form
Get Free Trial
  1. API reference
  2. Welcome
    1. Getting started
    2. Get Flexmonster
    3. Quick start
    4. System requirements
    5. Troubleshooting
    6. Managing license keys
    7. Migrating from WebDataRocks to Flexmonster
  3. Integration with frameworks
    1. Available tutorials
    2. Integration with Angular
    3. Integration with React
    4. Integration with Vue
    5. Other integrations
      1. Integration with Python
        1. Integration with Django
        2. Integration with Jupyter Notebook
      2. Integration with React Native
      3. Integration with AngularJS (v1.x)
      4. Integration with TypeScript
      5. Integration with R Shiny
      6. Integration with jQuery
      7. Integration with Ionic
      8. Integration with Electron.js
      9. Integration with Webpack
      10. Integration with RequireJS
  4. Connecting to Data Source
    1. Supported data sources
    2. JSON
      1. Connecting to JSON
      2. Connecting to JSON using Flexmonster Data Server
      3. Data types in JSON
    3. CSV
      1. Connecting to CSV
      2. Connecting to CSV using Flexmonster Data Server
      3. Data types in CSV
    4. Database
      1. Connecting to SQL databases
      2. Connecting to a MySQL database
      3. Connecting to a Microsoft SQL Server database
      4. Connecting to a PostgreSQL database
      5. Connecting to an Oracle database
    5. Flexmonster Data Server
      1. Introduction to Flexmonster Data Server
      2. Getting started with Flexmonster Data Server
      3. Configurations reference
      4. Data sources guide
      5. Security and authorization guide
      6. The Data Server as a DLL
        1. Getting started with the Data Server as a DLL
        2. Referencing the Data Server as a DLL
        3. Implementing the API controller
        4. Implementing the server filter
        5. Implementing the custom parser
        6. DLL configurations reference
        7. The controller's methods for request handling
      7. Troubleshooting the Data Server
    6. MongoDB
      1. Introduction to Flexmonster MongoDB Connector
      2. Getting started with the MongoDB Connector
      3. Embedding the MongoDB Connector into the server
    7. Microsoft Analysis Services
      1. Connecting to Microsoft Analysis Services
      2. Getting started with Flexmonster Accelerator
      3. Referencing the Accelerator as a DLL
      4. Configuring the authentication process
      5. Configuring a secure HTTPS connection
      6. Troubleshooting
    8. Custom data source API
      1. Introduction to the custom data source API
      2. A quick overview of a sample Node.js server
      3. A quick overview of a sample .NET Core server
      4. Implement your own server
        1. Implementing the custom data source API server
        2. Implementing filters
        3. Supporting more aggregation functions
        4. Supporting multilevel hierarchies
        5. Returning data for the drill-through view
        6. Testing your custom data source API server
    9. Elasticsearch
      1. Connecting to Elasticsearch
      2. Configuring the mapping
    10. Pentaho Mondrian
      1. Connecting to Pentaho Mondrian
      2. Getting started with the Accelerator
      3. Configuring Mondrian roles
      4. Configuring username/password protection
      5. Configuring a secure HTTPS connection
      6. Troubleshooting
    11. Connecting to other data sources
  5. Security
    1. Security in Flexmonster
    2. Security aspects of connecting to an OLAP cube
      1. Ways of connecting to an OLAP cube
      2. The data transfer process
      3. Data security
      4. Data access management
  6. Configuring report
    1. What is a report
    2. Data source
    3. Slice
    4. Options
    5. Mapping
    6. Number formatting
    7. Conditional formatting
    8. Set the report for the component
    9. Get the report from the component
    10. Date and time formatting
    11. Configuring global options
    12. Export and print
    13. Calculated values
    14. Custom sorting
  7. Charts
    1. Available tutorials
    2. Flexmonster Pivot Charts
    3. Integration with Highcharts
    4. Integration with amCharts
    5. Integration with Google Charts
    6. Integration with FusionCharts
    7. Integration with any charting library
  8. Customizing
    1. Available tutorials
    2. Customizing the Toolbar
    3. Customizing appearance
    4. Customizing the context menu
    5. Customizing the grid
    6. Customizing the pivot charts
    7. Localizing the component
  9. Updating to the latest version
    1. Updating to the latest version
    2. Release notes
    3. Migration guide from 2.7 to 2.8
    4. Migration guide from 2.6 to 2.7
    5. Migration guide from 2.5 to 2.6
    6. Migration guide from 2.4 to 2.5
    7. Migration guide from 2.3 to 2.4
    8. Migration guide from 2.2 to 2.3
  10. Flexmonster CLI Reference
    1. Overview
    2. Troubleshooting the CLI
    3. flexmonster create
    4. flexmonster add
    5. flexmonster update
    6. flexmonster version
    7. flexmonster help
  11. Documentation for older versions
Table of contents

Connecting to JSON

This article illustrates how to build a report based on a JSON data source. The most simple configuration to use a JSON data source is to display data that is already on your page. Alternatively, you can load JSON data from your local file system (see Connect > To local JSON in the Toolbar), refer to a remote JSON file, or add data generated by a server-side script.

To load big JSON files (more than 100 MB), we recommend using Flexmonster Data Server – our powerful tool for processing large datasets. Refer to this tutorial for details: Connecting to JSON using Flexmonster Data Server.

The component supports two JSON formats – an array of objects, where each object is an unordered set of name/value pairs, and an array of arrays, where each sub-array contains ordered values. See the array of objects sample below:

var jsonData = [
    {
        "Color" : "green",
        "Country" : "Canada",
        "State" : "Ontario",
        "City" : "Toronto",
        "Price" : 174,
        "Quantity" : 22
    },
    {
        "Color" : "red",
        "Country" : "USA",
        "State" : "California",
        "City" : "Los Angeles",
        "Price" : 166,
        "Quantity" : 19
    }
];

The following sample demonstrates what a JSON format with an array of arrays looks like:

var jsonData = [
    [
        "Category",
        "Color",
        "Price",
        "Quantity"
    ],
    ["Ice-cream", "red", 23.32, 4],
    ["Ice-cream", "yellow", 4.2, 3],
    ["Sweets", "red", 45.3, 2],
    ["Candies", "orange", 22.65, 7]
];

To use JSON data as a data source in the pivot table embedded in your project, follow these steps:

  1. If Flexmonster is not yet embedded, set up an empty component in your web page:

    In pure JavaScript

    Complete the Quick start guide. Your code should look similar to the following example:

    var pivot = new Flexmonster({
        container: "pivotContainer",
        toolbar: true
    });

    In Angular

    Complete the Integration with Angular guide. Your code should look similar to the following example:

    <fm-pivot 
    [toolbar]="true">
    </fm-pivot>

    In React

    Complete the Integration with React guide. Your code should look similar to the following example:

    <FlexmonsterReact.Pivot
    toolbar={true}
    />

    In Vue

    Complete the Integration with Vue guide. Your code should look similar to the following example:

    <Pivot
    ref="pivot"
    toolbar>
    </Pivot>

  2. Copy the following JSON and paste it into your web page:
    var jsonData = [
        {    
    	 "Color" : "green",
    	 "Country" : "Canada",
    	 "State" : "Ontario",
    	 "City" : "Toronto",
    	 "Price" : 174,
       	 "Quantity" : 22
        },
        {
    	 "Color" : "red",
    	 "Country" : "USA",
    	 "State" : "California",
    	 "City" : "Los Angeles",
    	 "Price" : 166,
    	 "Quantity" : 19
        }
    ];
    
    var pivot = new Flexmonster({
        container: "pivotContainer",
        toolbar: true
    });
    
  3. Add the data property to the report object:
    var jsonData = [
        {    
    	 "Color" : "green",
    	 "Country" : "Canada",
    	 "State" : "Ontario",
    	 "City" : "Toronto",
    	 "Price" : 174,
       	 "Quantity" : 22
        },
        {
    	 "Color" : "red",
    	 "Country" : "USA",
    	 "State" : "California",
    	 "City" : "Los Angeles",
    	 "Price" : 166,
    	 "Quantity" : 19
        }
    ];
    
    var pivot = new Flexmonster({
        container: "pivotContainer",
        toolbar: true,
        report: {
            dataSource: {
    	        data: jsonData
    	    }
        }
    });
    
  4. Define a slice – fields that go to rows, go to columns and go to measures:
    var jsonData = [
        {    
    	 "Color" : "green",
    	 "Country" : "Canada",
    	 "State" : "Ontario",
    	 "City" : "Toronto",
    	 "Price" : 174,
       	 "Quantity" : 22
        },
        {
    	 "Color" : "red",
    	 "Country" : "USA",
    	 "State" : "California",
    	 "City" : "Los Angeles",
    	 "Price" : 166,
    	 "Quantity" : 19
        }
    ];
    
    var pivot = new Flexmonster({
        container: "pivotContainer",
        toolbar: true,
        report: {
            dataSource: {
    	        data: jsonData
    	    },
    	    slice: {
    	        rows: [
    	            { uniqueName: "Color" },
    		        { uniqueName: "[Measures]" }
    	        ],
    	        columns: [
    	            { uniqueName: "Country" }
    	        ],
    	        measures: [
    	            {
                        uniqueName: "Price", 
    		            aggregation: "sum" 
    	            }
    	        ]
    	    }
        }
    });
    
  5. Now launch the page from a browser — there you go! A pivot table based on JSON data is embedded into your project. Check out this example on JSFiddle.

Now you know how to build a report based on our sample JSON. This example shows how to use a JSON array of arrays. The next step for you is to visualize your JSON data.

How to display non-English characters correctly

If you use an alphabet with special characters you must use UTF-8 encoding. There are two ways to do this:

  1. Specify the encoding for your HTML page to UTF-8 using the content-type HTTP header or the corresponding meta tag:
    <meta http-equiv="content-type" content="text/html; charset=utf-8" />

    Content from a database and static JSON files also must be encoded as UTF-8.

  2. If you are not able to change the content of your HTML file, you can embed Flexmonster Pivot in a separate JS file with specified UTF-8 encoding.
    <script src="yourfile.js" charset="UTF-8"></script>

What’s next?

You may be interested in the following articles: