Embed into the web application

Here you can find a guide through the process of embedding Pivot Table and Charts Component into your HTML using flexmonster.js library.

To get your Pivot Table component embedded you should accomplish the following steps:

1. Download a free trial of the component and extract the files from the downloaded package.
2. Copy flexmonster/ folder into your web project root to your server.
3. Create <div> container for the component. Please note, that your page should be in the same folder as flexmonster/:

   <div id="pivotContainer">The component will appear here</div>
   

4. Include flexmonster.js into your HTML page:

   <div id="pivotContainer">The component will appear here</div>
   <script src="flexmonster/flexmonster.js"></script>
   

5. Add simple script to embed the component. Please note, licenseKey is your license or trial key, so you should replace XXXX-XXXX-XXXX-XXXX-XXXX with an actual key:

   <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>
   
   

6. Now launch the page from browser — here you go! The component without data is embedded into your project. You can see the example on JSFiddle.
7. The next step is to see your own data on the grid. Find detailed tutorials for connecting Pivot Table to the following data sources: JSON, CSV, SQL database, Microsoft Analysis Services, Mondrian and icCube.

Should you have any problems — visit our troubleshooting page.

Initial call to embed the component

This is the first API call you need to know.

new Flexmonster({
	container:String, 
	componentFolder:String, 
	global:Object, 
	width:Number, 
	height:Number, 
	report:Object|String, 
	toolbar:Boolean, 
	customizeCell:Function,
	licenseKey:the license key})

This API call embeds the component into HTML page and allows you to provide it with all necessary information for the initialization by setting the following arguments:

• container – property to set a selector of the HTML element which will be a container for the component.
• componentFolder – URL of the component’s folder which contains all necessary files. Also, it is used as a base URL for report files, localization files, styles and images. The default value for componentFolder is flexmonster/.
• global – object that allows you to preset options for all reports. These options can be overwritten for concrete reports. Object structure is the same as for report.
• width – width of the component on the page (pixels or percent). The default value for width is 100%.
• height – height of the component on the page (pixels or percent). The default value for height is 500.
• report – property to set a report. It can be inline report JSON or URL to report JSON. XML reports are also supported in terms of backward compatibility.
• toolbar – parameter to embed the toolbar (the one that is shown in Pivot Table demo) or not. Default value is false – without toolbar.
• customizeCell – function that allows customizing of separate cells.
• licenseKey – the license key.

The only required property is container. If you run new Flexmonster({container: "pivotContainer"}), where "pivotContainer" is the selector of container HTML element, – an empty component without toolbar will be added with the default width and height.