Connecting to icCube

Follow these steps to connect to icCube via XMLA.

Step 1: Embed the component into your web page

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>

Step 2: Configure XMLA access to the cube

Assuming the server is using the default configuration and is running on a local machine, the XMLA service is available at this address:

XMLA/HTTP : http://localhost:8282/icCube/xmla

Refer to the icCube documentation for more details.

Step 3: Enable cross-origin resource sharing (CORS)

By default the browser prevents JavaScript from making requests across domain boundaries. CORS allows web applications to make cross-domain requests. Open the icCube configuration file (located at $install/bin/icCube.xml) and edit the following:

  1. Cross Origin filter:
    <icCubeConfiguration>
        ...
        <xmlaComponentConfiguration>
            ...
            <filter>Cross Origin</filter>
            ...
        </xmlaComponentConfiguration>
        ...
    </icCubeConfiguration>
    
  2. Cross Origin filter configuration:
    <icCubeConfiguration>
        ...
        <filterConfiguration>
            ...
            <filter>
                <filter-name>Cross Origin</filter-name>
                <filter-class>crazydev.iccube.server.crossorigin.IcCubeCrossOriginServletFilter</filter-class>
                <init-param>
                    <param-name>allowedOrigins</param-name>
                    <param-value>*</param-value>
                </init-param>
                <init-param>
                    <param-name>allowedMethods</param-name>
                    <param-value>GET,POST,HEAD,OPTIONS</param-value>
                </init-param>
                <init-param>
                    <param-name>allowedHeaders</param-name>
                    <param-value>X-Requested-With,Content-Type,Accept,Origin,X-DataSource-Auth</param-value>
                </init-param>
            </filter>
            ...
        </filterConfiguration>
        ...
    </icCubeConfiguration>
    

Step 4: Configure the report with your own data

Now it’s time to configure the pivot table on the web page. Let’s create a minimal report for this (replace proxyUrl, catalog, and cube parameters with your specific values):

var pivot = new Flexmonster({
	container: "pivotContainer",
	toolbar: true, 
	report: {
		dataSource: {
			dataSourceType: "iccube",

			/* URL to the XMLA service */
			proxyUrl: "http://olap.flexmonster.com:8282/icCube/xmla",

			/* Catalog name */
			catalog: "Sales",

			/* Cube name */
			cube: "Sales"
		}
	},
	licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
});

Launch the web page from a browser — there you go! A pivot table is embedded into your project. Open the example on JSFiddle.

Visit our live icCube demo to see one more sample.

Optimize data loading

Use the subquery parameter to reduce the amount of data that is loaded from the OLAP cube. For example, if you have a cube with geography hierarchy and your task is to show reports only for the one specific region instead of loading all the data. To show reports only for that region add subquery in the following way:

{
    "dataSource": {
        "dataSourceType": "iccube",
        "proxyUrl": "http://olap.flexmonster.com:8282/icCube/xmla",
        "catalog": "Sales",
        "cube": "Sales",
        "subquery": "select {[Customers].[Geography].[Region].&[EU]} 
                on columns from [Sales]"
    },
    "slice": {
        "rows": [ { "uniqueName": "[Customers].[Geography]" } ],
        "columns": [ 
            { "uniqueName": "[Product].[Product]" },
            { "uniqueName": "[Measures]" }
        ],
        "measures": [ { "uniqueName": "[Measures].[Amount]" } ]
    }
}

Open the example on JSFiddle.