Menu
Download Free Trial
  1. API reference
  2. Welcome
    1. Getting started
    2. Quickstart
    3. System requirements
    4. Typical errors
    5. Installation troubleshooting
  3. Connecting to Data Source
    1. JSON
      1. JSON data source
      2. Data types in JSON
    2. CSV
      1. CSV data source
      2. Data types in CSV
    3. SQL database
      1. Connecting to SQL database
      2. Connecting to database with .NET
      3. Connecting to database with .NET Core
      4. Connecting to database with Java
      5. Connecting to database with PHP
    4. Microsoft Analysis Services
      1. Connecting to Microsoft Analysis Services
      2. Getting started with Accelerator
      3. Installing Accelerator as a Windows Service
      4. Configuring username/password protection
      5. Configuring secure HTTPS connection
      6. Troubleshooting
    5. Pentaho Mondrian
      1. Connecting to Pentaho Mondrian
      2. Getting started with Accelerator
      3. Configuring Mondrian roles
      4. Сonfiguring username/password protection
      5. Сonfiguring secure HTTPS connection
      6. Troubleshooting
    6. icCube
  4. Configuring report
    1. Configuring report
    2. Data source
    3. Slice
    4. Options
    5. Number formatting
    6. Conditional formatting
    7. Set report to the component
    8. Get report from the component
    9. Calculated values
    10. Custom sorting
    11. Date and time formatting
    12. Configuring global options
  5. Integration with frameworks
    1. Integration with frameworks
    2. Integration with AngularJS
    3. Integration with Angular 2
    4. Integration with Angular 4
    5. Integration with React
    6. Integration with RequireJS
    7. Integration with TypeScript
    8. Integration with ASP.NET
    9. Integration with JSP
    10. Integration with PhoneGap
  6. Integration with charts
    1. Integration with charts
    2. Integration with Highcharts
    3. Integration with FusionCharts
    4. Integration with Google Charts
    5. Integration with any charting library
  7. Customizing
    1. Customizing toolbar
    2. Customizing appearance
    3. Localizing component
  8. Export and print
  9. Updating to the latest version
    1. Updating to the latest version
    2. Release notes
    3. Migration guide from 2.3 to 2.4
    4. Migration guide from 2.2 to 2.3
  10. Managing license keys
  11. Older Versions
    1. Documentation 2.3
    2. Documentation 2.2
    3. API reference - Flex
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/flexmonster.js"></script>
    
    <script>
    	var pivot = new Flexmonster({
    		container: "pivotСontainer",
    		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 id="d3Chart" 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.