Download Free Trial
  1. Getting started
    1. Quickstart
    2. System requirements
    3. Managing license keys
    4. Updating to the latest version
    5. Typical errors
    6. Migration guide
    7. Installation troubleshooting
  2. JSON data source
    1. Data types in JSON
  3. CSV data source
    1. Data types in CSV
  4. Connecting to SQL database
    1. Connecting to database with .NET
    2. Connecting to Relational Database with .NET Core
    3. Connecting to database with Java
    4. Connecting to database with PHP
  5. Connecting to Microsoft Analysis Services
    1. Getting started with Accelerator
    2. Installing Accelerator as a Windows Service
    3. Configuring username/password protection
    4. Configuring secure HTTPS connection
    5. Troubleshooting
  6. Connecting to Pentaho Mondrian
    1. Getting started with Accelerator
    2. Configuring Mondrian roles
    3. Сonfiguring username/password protection
    4. Сonfiguring secure HTTPS connection
    5. Troubleshooting
  7. Connecting to icCube
  8. Configuring report
    1. Data source
    2. Slice
    3. Options
    4. Number formatting
    5. Conditional formatting
    6. Set report to the component
    7. Get report from the component
    8. Date and time formatting
    9. Calculated values
    10. Custom sorting
  9. Integration
    1. Integration with AngularJS
    2. Integration with Angular 2
    3. Integration with Angular 4
    4. Integration with React
    5. Integration with RequireJS
    6. Integration with TypeScript
    7. Integration with ASP.NET
    8. Integration with JSP
    9. Integration with PhoneGap
  10. Integration with charts
    1. Integration with Highcharts
    2. Integration with FusionCharts
    3. Integration with Google Charts
    4. Integration with any charting library
  11. Customizing toolbar
  12. Customizing appearance
  13. Localizing component
  14. Global Object
  15. Export and print
  16. API reference - JavaScript
  17. API reference - Flex
Table of contents

Configuring report

What is a report?

A report is a definition of what data should be shown in the component and how it will be visualized.

Reports are in JSON format. XML reports are also supported in terms of backward compatibility.

You are already familiar with the report object thanks to Your first pivot table article where the report object was used to visualize pivot table based on JSON data. There were defined such report object properties as data from dataSource, rows, columns and measures from slice. Also, report objects were used to connect to JSON, CSV, SQL databases, Microsoft Analysis Services, Pentaho Mondrian and icCube in the previous articles of the documentation.

Now it is time to understand what else except the data source configuration can be defined in reports.

Report object has many properties. Actually, all the possible aspects of pivot tables and pivot charts configuration can be set via report object. The component supports saving reports and loading of previously saved ones.

Report parts

Report properties can be divided into the logical parts. Check our tutorials about each part:

*Only the part that describes data source is the required one in reports. Others are optional.

The simplest report

The simplest report consists only of the data source definition.

Let’s see how the simplest report in JSON format that defines connection to the static CSV file looks like :

	dataSource: {
		filename: "data.csv"

This is how the above report is set in $("#pivotContainer").flexmonster():

<div id="pivotContainer">The component will appear here</div>
<script type="text/javascript" src="flexmonster/lib/jquery.min.js"></script>
<script type="text/javascript" src="flexmonster/flexmonster.js"></script>

	var pivot = $("#pivotContainer").flexmonster({
		toolbar: true,
		report: {
			dataSource: {
				filename: "data.csv"

Open on JSFiddle.

How to display non-English characters correctly

If you use the alphabet with special characters it is necessary to set UTF-8 encoding. There are two ways to do this:

  1. Specify the encoding for your HTML page to UTF-8 using the content-type HTTP header or the corresponding meta tag:
    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
    Content from the database or static report files also must be encoded as UTF-8.
  2. In case you are not able to change the content of your HTML file, you can embed Flexmonster Component in a separate JS file with specified UTF-8 encoding.
    <script src="yourfile.js" charset="UTF-8"></script>