Menu
Free Trials
Table of contents

Integration with any charting library

This tutorial will help you in the process of connecting a 3rd party visualization tool to Flexmonster Pivot Table component. Our example is simple and aims to illustrate the gist of the interaction process between data from Flexmonster and the external visualization. The example is based on d3.js. Integration with any other library will have the similar basic steps.

The integration is based on API call getData(). You should read about it to understand in which format data is returned from the component. In this article we will connect Pivot Table Component data with d3.js chart step by step:

Adding the basis for new chart

  1. Add to your HTML page the following pivot table based on CSV file.
    <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,
    		report: {
    			dataSource: {
    				filename: "data.csv"
    			},
    			slice: {
    				rows: [
    					{ uniqueName: "Country" }
    				],
    				columns: [
    					{ uniqueName: "Business Type" },
    					{ uniqueName: "[Measures]" }
    				],
    				measures: [
    					{ uniqueName: "Price" }
    				]
    			}
    		},
    		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
    	});
    </script>
    
  2. Add container for the chart.
    <svg width="650" height="230"></svg>
    
  3. Add reportComplete event handler to know when the pivot table is ready to be a data provider.
    reportcomplete: function() {
    	pivot.off("reportcomplete");
    	createChart();
    }
    
  4. Add function to create the chart. This function is using getData(options, callbackHandler, updateHandler). Try it in JSFiddle.
    function createChart() {
    	pivot.getData(
    		{
    			// define your slice
    		}, 
    		drawChart, 
    		updateChart 
    	);
    }
    

Preparing the data and drawing the chart

The most important part of drawing a chart is preparing the data, transforming it from the format returned by getData() API call to the format that suits the 3rd party visualization tool:

var data = prepareDataFunction(rawData);

Our example shows how to define and use a function (in our example it is prepareDataFunction) to process the data. This function should prepare data in appropriate for charting library format. In this example prepareDataFunction iterates through data array records from rawData and discards a record containing grand total because it is not needed for the bar chart. Also the function renames rows from r0 to member and values from v0 to value. It is not required, but it makes the code more readable when referring the data later. We have the following pivot table:

Country Total Sum of Price
Australia 1 372 281
France 1 117 794
Germany 1 070 453
Canada 1 034 112
United States 847 331
United Kingdom 779 899
Grand Total 6 221 870

data array from rawData looks the following way:

	data:[
		{
			v0:6221870
		},
		{
			r0:"Australia",
			v0:1372281
		},
		{
			r0:"France",
			v0:1117794
		},
		{
			r0:"Germany",
			v0:1070453
		},
		{
			r0:"Canada",
			v0:1034112
		},
		{
			r0:"United States",
			v0:847331
		},
		{
			r0:"United Kingdom",
			v0:779899
		}
	]

After prepareDataFunction the data will be looking like this:

        {
            member:"Australia",
            value:1372281
        },
        {
            member:"France",
            value:1117794
        },
        {
            member:"Germany",
            value:1070453
        },
        {
            member:"Canada",
            value:1034112
        },
        {
            member:"United States",
            value:847331
        },
        {
            member:"United Kingdom",
            value:779899
        }

drawChart function draws a chart using processed data. In our JSFiddle example, the logic of drawing is the same as in the d3.js example. updateChart function works the similar way but clears SVG first.