1. API reference
  2. Welcome
    1. Component overview
    2. Quick start
    3. System requirements
    4. Troubleshooting
    5. Managing license keys
  3. Connecting to Data Source
    1. JSON
      1. Connecting to JSON
      2. Connecting to JSON using the Data Compressor
      3. Data types in JSON
    2. CSV
      1. Connecting to CSV
      2. Connecting to CSV using the Data Compressor
      3. Data types in CSV
    3. Database
      1. Connecting to SQL databases
      2. Connecting to other databases
      3. Connecting to a database with Node.js
      4. Connecting to a database with .NET
      5. Connecting to a database with .NET Core
      6. Connecting to a database with Java
      7. Connecting to a database with PHP
    4. Microsoft Analysis Services
      1. Connecting to Microsoft Analysis Services
      2. Getting started with the Accelerator
      3. Installing the Accelerator as a Windows Service
      4. Referring the Accelerator as a DLL
      5. Configuring the authentication process
      6. Configuring a secure HTTPS connection
      7. 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. Security
    1. Accelerator security
    2. Data Compressor Security
  5. Configuring report
    1. What is a 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. Date and time formatting
    10. Configuring global options
    11. Export and print
    12. Calculated values
    13. Custom sorting
  6. Integration with frameworks
    1. Available tutorials
    2. Integration with AngularJS (v1.x)
    3. Integration with Angular
    4. Integration with React
    5. Integration with Webpack
    6. Integration with ASP.NET
    7. Integration with jQuery
    8. Integration with JSP
    9. Integration with TypeScript
    10. Integration with RequireJS
    11. Integration with PhoneGap
  7. Integration with charts
    1. Integration with Highcharts
    2. Integration with Google Charts
    3. Integration with FusionCharts
    4. Integration with any charting library
  8. Customizing
    1. Customizing toolbar
    2. Customizing appearance
    3. Customizing context menu
    4. Localizing component
  9. Updating to the latest version
    1. Updating to the latest version
    2. Release notes
    3. Migration guide from 2.5 to 2.6
    4. Migration guide from 2.4 to 2.5
    5. Migration guide from 2.3 to 2.4
    6. Migration guide from 2.2 to 2.3
    7. Documentation for older versions
Table of contents

SSAS - Getting started with Flexmonster Accelerator

Flexmonster Accelerator for Microsoft Analysis Services cubes is a special server-side proxy that increases data loading speeds from the server to customer’s browser. Flexmonster Accelerator also works with Azure Analysis Services cubes.

When working with OLAP cubes, a browser component communicates with the server via the XMLA protocol. The XMLA protocol is heavy and exchanges a lot of excessive information – it takes too much time and memory to load and process the data.

We replaced the XMLA protocol and use direct requests from the component to the server.

This is our solution to two major problems that many of those who work with big data face:

  • We made big data transfer from the server to the browser incredibly fast. Our tool allows you to transfer large multidimensional data super easily and quickly. Reporting becomes more enjoyable and prompt for your end users.
  • We greatly reduced the load on the browser memory.

Open Live Demo

There are three ways to use Flexmonster Accelerator:

Install the Accelerator using the console application

Requirements

  • Flexmonster Pivot version 2.2 or higher
  • Microsoft Analysis Services installed and configured
  • Microsoft .NET Framework 4 or higher

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 Flexmonster Accelerator on the server

The package contains the following files:

  • flexmonster-proxy-ssas.exe – a server-side utility that handles the connection between Microsoft Analysis Services and Flexmonster Pivot
  • flexmonster.config – a file that contains configuration parameters for the utility (connection string, port, etc.)

The flexmonster.config file contains the following parameters:

  • CONNECTION_STRING – (required) the connection string for Microsoft Analysis Services. Example: Data Source=localhost;.
  • PORT – (optional) the port number for the proxy service endpoint. Default value: 50005.
  • CACHE_MEMORY_LIMIT – (optional) the maximum memory size available for caching (in MB). Default value: 0 (unlimited).
  • CACHE_ENABLED – (optional) indicates whether caching is enabled. Default value: true. Available since version 2.211.
  • GZIP – (optional) indicates whether server response compression is enabled. Default value: true. Available since version 2.409.
  • HTTPS – (optional) indicates whether the HTTPS connection is enabled. Default value: false.

After configuring all the necessary options, the Accelerator is ready to be launched. Just run the flexmonster-proxy-ssas.exe with administrator privileges.

You can check whether the Accelerator is up and running by navigating to its URL in the browser (by default: http://localhost:50005).

Step 3: Open a port for the Accelerator in the firewall

If you plan to allow connections to the Accelerator from outside the server, open the appropriate port in the firewall. The default port number is 50005, but it can be changed using the PORT parameter in the flexmonster.config file.

Step 4: Configure the component

Now it’s time to configure the client – Flexmonster Pivot Table and Charts. Let’s create a minimal configuration using the JavaScript API (replace proxyUrl, catalog and cube parameters with your specific values):

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

			/* URL to Flexmonster Accelerator */
			proxyUrl: "http://localhost:50005",

			/* Catalog name */
			catalog: "Adventure Works DW Standard Edition",

			/* Cube name */
			cube: "Adventure Works",

			// Flag to use the Accelerator instead of XMLA protocol
			binary: true
		}
	},
	licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
});

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

Cache control

Usually a cache can improve performance greatly. However if the underlying database ever changes, the cache goes out of date. By default, caching is enabled and controlled by the Accelerator.

It is also possible to disable the cache with the CACHE_ENABLED parameter in the flexmonster.config (available since version 2.211):

CACHE_ENABLED = false