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 the Accelerator
      3. Configuring Mondrian roles
      4. Configuring username/password protection
      5. Configuring a secure HTTPS connection
      6. Troubleshooting
    6. Elasticsearch
      1. Connecting to Elasticsearch
      2. Configuring the mapping
  4. Security
    1. Security in Flexmonster
    2. Security aspects when connecting to an OLAP cube
      1. The data transfer process
      2. Data security
      3. Data access management
    3. Security aspects when connecting to a database
      1. The data transfer process
      2. Data access management
  5. Configuring report
    1. What is a report
    2. Data source
    3. Slice
    4. Options
    5. Number formatting
    6. Conditional formatting
    7. Set the report for the component
    8. Get the 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.6 to 2.7
    4. Migration guide from 2.5 to 2.6
    5. Migration guide from 2.4 to 2.5
    6. Migration guide from 2.3 to 2.4
    7. Migration guide from 2.2 to 2.3
    8. Documentation for older versions
Table of contents

What is a report

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

Reports are written in JSON. XML reports are also supported for backward compatibility.

In the your first pivot table article you learned about how the report object can be used to visualize a pivot table based on JSON data. We defined report object properties such as data from dataSource, rows, columns, and measures from slice. Report objects were also used to connect to JSON, CSV, SQL databases, Microsoft Analysis Services, Pentaho Mondrian, and Elasticsearch in previous articles of the documentation.

This set of articles focuses on how to configure properties besides the data source in a report.

A report object has many properties – all possible aspects of pivot table and pivot chart configuration can be set via a report object. The component supports saving and loading reports.

Report configuration

Report properties are logically divided into the parts. Follow the tutorials to configure each part:

If the data contains date and time values, check out the date and time formatting tutorial.

The simplest report

The simplest report consists of only the data source definition.

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

{
	dataSource: {
		filename: "data.csv"
	}
}

This is how the above report is set in new Flexmonster():

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

<script>
	var pivot = new Flexmonster({
		container: "pivotСontainer",
		toolbar: true,
		report: {
			dataSource: {
				filename: "data.csv"
			}
		},
		licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
	});
</script>

Open on JSFiddle.

How to display non-English characters correctly

If you use an 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 must also be encoded as UTF-8.
  2. If you are not able to change the header of your HTML file, you can embed Flexmonster in a separate JS file and specify UTF-8 encoding when referencing it.
    <script src="yourfile.js" charset="UTF-8"></script>