Menu
Download Free Trial
Table of contents

JSON data source

This article illustrates how to build a report based on JSON data source. JSON data source is good to display data which already is on your page. This is the most simple case of the configuration. Also, you can load JSON data from a file (please see Connect > To local JSON in the toolbar) or refer JSON file as data source.

The component supports a certain format of JSON – array of objects, where each object is an unordered set of name/value pairs. For example:

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

You need to accomplish the following steps to use JSON data as a data source in pivot table embedded into your project.

  1. You already have in your HTML page an empty component. If Flexmonster Component is not embedded – return to Quickstart. Your code should look like the following example:

    <div id="pivotContainer">The component will appear here</div>
    <script src="flexmonster/lib/jquery.min.js"></script>
    <script src="flexmonster/flexmonster.js"></script>
    
    <script>
    	var pivot = $("#pivotContainer").flexmonster({
    		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/lib/jquery.min.js"></script>
    <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 = $("#pivotContainer").flexmonster({
    		toolbar: true,
    		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
    	});
    </script>
  3. Add data property to report object:
    <div id="pivotContainer">The component will appear here</div>
    <script src="flexmonster/lib/jquery.min.js"></script>
    <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 = $("#pivotContainer").flexmonster({
    		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/lib/jquery.min.js"></script>
    <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 = $("#pivotContainer").flexmonster({
    		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 browser — here 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. The next step for you is to visualize your JSON data.

How to display non-English characters correctly

If you use the alphabet with special characters it is necessary to set 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 the database or static JSON files also must be encoded as UTF-8.
  2. In case you are not able to change the content of your HTML file, you can embed Flexmonster Component in a separate JS file with specified UTF-8 encoding.
    <script src="yourfile.js" charset="UTF-8"></script>