1. API reference
  2. Welcome
    1. Component overview
    2. Quick start
    3. System requirements
    4. Troubleshooting
    5. Managing license keys
  3. Connecting to Data Source
    1. JSON
      1. Connecting to JSON
      2. Connecting to JSON using the Data Compressor
      3. Data types in JSON
    2. CSV
      1. Connecting to CSV
      2. Connecting to CSV using the Data Compressor
      3. Data types in CSV
    3. Database
      1. Connecting to SQL databases
      2. Connecting to other databases
      3. Connecting to a database with Node.js
      4. Connecting to a database with .NET
      5. Connecting to a database with .NET Core
      6. Connecting to a database with Java
      7. Connecting to a database with PHP
    4. Microsoft Analysis Services
      1. Connecting to Microsoft Analysis Services
      2. Getting started with the Accelerator
      3. Installing the Accelerator as a Windows service
      4. Referring the Accelerator as a DLL
      5. Configuring the authentication process
      6. Configuring a secure HTTPS connection
      7. Troubleshooting
    5. 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
    6. Elasticsearch
      1. Connecting to Elasticsearch
      2. Configuring the mapping
  4. Security
    1. Security in Flexmonster
    2. Security aspects when connecting to an OLAP cube
      1. The data transfer process
      2. Data security
      3. Data access management
    3. Security aspects when connecting to a database
      1. The data transfer process
      2. Data access management
  5. Configuring report
    1. What is a report
    2. Data source
    3. Slice
    4. Options
    5. Number formatting
    6. Conditional formatting
    7. Set the report for the component
    8. Get the report from the component
    9. Date and time formatting
    10. Configuring global options
    11. Export and print
    12. Calculated values
    13. Custom sorting
  6. Integration with frameworks
    1. Available tutorials
    2. Integration with AngularJS (v1.x)
    3. Integration with Angular
    4. Integration with React
    5. Integration with Webpack
    6. Integration with ASP.NET
    7. Integration with jQuery
    8. Integration with JSP
    9. Integration with TypeScript
    10. Integration with RequireJS
    11. Integration with PhoneGap
  7. Integration with charts
    1. Integration with Highcharts
    2. Integration with Google Charts
    3. Integration with FusionCharts
    4. Integration with any charting library
  8. Customizing
    1. Customizing toolbar
    2. Customizing appearance
    3. Customizing context menu
    4. Localizing component
  9. Updating to the latest version
    1. Updating to the latest version
    2. Release notes
    3. Migration guide from 2.6 to 2.7
    4. Migration guide from 2.5 to 2.6
    5. Migration guide from 2.4 to 2.5
    6. Migration guide from 2.3 to 2.4
    7. Migration guide from 2.2 to 2.3
    8. 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.

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. Set up an empty component in your HTML page. If Flexmonster is not yet embedded – return to Quick start. Your code should look similar to the following example:

    <div id="pivotContainer">The component will appear here</div>
    <script src="flexmonster/flexmonster.js"></script>
    <script>
    	var pivot = new Flexmonster({
    		container: "pivotContainer",
    		toolbar: true,
    		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
    	});
    </script>
    
  2. Copy the following JSON and paste it into your HTML page:
    <div id="pivotContainer">The component will appear here</div>
    <script src="flexmonster/flexmonster.js"></script>
    
    <script>
    
    	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,
    		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
    	});
    </script>
  3. Add the data property to the report object:
    <div id="pivotContainer">The component will appear here</div>
    <script src="flexmonster/flexmonster.js"></script>
    
    <script>
    	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
    			}
    		},
    		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
    	});
    </script>
  4. Define a slice – fields that go to rows, go to columns and go to measures:
    <div id="pivotContainer">The component will appear here</div>
    <script src="flexmonster/flexmonster.js"></script>
    
    <script>
    	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" 
    				}
    				]
    			}
    		},
    		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
    	});
    </script>
  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?