Get Free Trial
  1. API reference
  2. Welcome
    1. Getting started
    2. Get Flexmonster
    3. Quick start
    4. System requirements
    5. Troubleshooting
    6. Managing license keys
    7. Migrating from WebDataRocks to Flexmonster
  3. Integration with frameworks
    1. Available tutorials
    2. Integration with Angular
    3. Integration with React
    4. Integration with Vue
    5. Other integrations
      1. Integration with Python
        1. Integration with Django
        2. Integration with Jupyter Notebook
      2. Integration with React Native
      3. Integration with Blazor
      4. Integration with AngularJS (v1.x)
      5. Integration with TypeScript
      6. Integration with R Shiny
      7. Integration with jQuery
      8. Integration with Ionic
      9. Integration with Electron.js
      10. Integration with Webpack
      11. Integration with RequireJS
  4. Connecting to Data Source
    1. Supported data sources
    2. JSON
      1. Connecting to JSON
      2. Connecting to JSON using Flexmonster Data Server
      3. Data types in JSON
    3. CSV
      1. Connecting to CSV
      2. Connecting to CSV using Flexmonster Data Server
      3. Data types in CSV
    4. Database
      1. Connecting to SQL databases
      2. Connecting to a MySQL database
      3. Connecting to a Microsoft SQL Server database
      4. Connecting to a PostgreSQL database
      5. Connecting to an Oracle database
    5. Flexmonster Data Server
      1. Introduction to Flexmonster Data Server
      2. Getting started with Flexmonster Data Server
      3. Flexmonster Admin Panel Guide
      4. Data sources guide
      5. Security and authorization guide
      6. The Data Server as a DLL
        1. Getting started with the Data Server as a DLL
        2. Referencing the Data Server as a DLL
        3. Implementing the API controller
        4. Implementing the server filter
        5. Implementing the custom parser
        6. DLL configurations reference
        7. The controller's methods for request handling
      7. The Data Server as a console application
        1. Installing the Data Server as a console application
        2. Configurations reference
        3. Data sources guide
        4. Security and authorization guide
      8. Troubleshooting the Data Server
    6. MongoDB
      1. Introduction to Flexmonster MongoDB Connector
      2. Getting started with the MongoDB Connector
      3. Embedding the MongoDB Connector into the server
      4. Configuring the MongoDB Connector
    7. Microsoft Analysis Services
      1. Connecting to Microsoft Analysis Services
      2. Getting started with Flexmonster Accelerator
      3. Referencing the Accelerator as a DLL
      4. Configuring the authentication process
      5. Configuring a secure HTTPS connection
      6. Troubleshooting
    8. Custom data source API
      1. Introduction to the custom data source API
      2. A quick overview of a sample Node.js server
      3. A quick overview of a sample .NET Core server
      4. Implement your own server
        1. Implementing the custom data source API server
        2. Implementing filters
        3. Supporting more aggregation functions
        4. Supporting multilevel hierarchies
        5. Returning data for the drill-through view
        6. Testing your custom data source API server
    9. Elasticsearch
      1. Connecting to Elasticsearch
      2. Configuring the mapping
    10. 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
    11. Connecting to other data sources
  5. Accessibility
    1. Accessibility overview
    2. Keyboard navigation
  6. Configuring the component
    1. Available tutorials
    2. Getting started with the report
    3. Configure the data source
      1. Data source
      2. Mapping
    4. Define which data to show
      1. Slice
      2. Custom sorting
      3. Calculated values
    5. Manage Flexmonster’s functionality
      1. Options
      2. Configuring global options
    6. Format fields
      1. Number formatting
      2. Date and time formatting
      3. Conditional formatting
    7. Capture the report
      1. Get the report from the component
      2. Set the report for the component
      3. Share the report
      4. Export and print
  7. Charts
    1. Available tutorials
    2. Flexmonster Pivot Charts
    3. Integration with Highcharts
    4. Integration with amCharts
    5. Integration with Google Charts
    6. Integration with FusionCharts
    7. Integration with any charting library
  8. Customizing
    1. Available tutorials
    2. Customizing the Toolbar
    3. Customizing appearance
    4. Customizing the context menu
    5. Customizing the grid
    6. Customizing the pivot charts
    7. Localizing the component
  9. Security
    1. Security in Flexmonster
    2. Security aspects of connecting to an OLAP cube
      1. Ways of connecting to an OLAP cube
      2. The data transfer process
      3. Data security
      4. Data access management
  10. Updating to the latest version
    1. Updating to the latest version
    2. Release notes
    3. Migration guide from 2.8 to 2.9
    4. Migration guide from 2.7 to 2.8
    5. Migration guide from 2.6 to 2.7
    6. Migration guide from 2.5 to 2.6
    7. Migration guide from 2.4 to 2.5
    8. Migration guide from 2.3 to 2.4
    9. Migration guide from 2.2 to 2.3
  11. Flexmonster CLI Reference
    1. Overview
    2. Troubleshooting the CLI
    3. flexmonster create
    4. flexmonster add
    5. flexmonster update
    6. flexmonster version
    7. flexmonster help
  12. Documentation for older versions
Table of contents

Troubleshooting

Welcome to the troubleshooting page for Flexmonster Pivot. To troubleshoot Flexmonster CLI, Flexmonster Data Server, or Flexmonster Accelerator, refer to the following guides:

In this guide, you can find an explanation of errors that you might experience while working with Flexmonster Pivot, as well as simple instructions on how to fix them. If your error is not listed here, contact our technical support.

This page has three sections:

  1. Installation troubleshooting
  2. Issues with license keys
  3. Issues with data source
Installation troubleshooting

If you are facing any problems with the embedding of the component, in your browser go to the page where Flexmonster should be displayed and open the browser’s console to check if there are any errors in the console.
This section provides solutions to the errors that you may see in the console.

Console error: 'GET (any URL)/flexmonster.js 404 (Not Found)'
This error means that flexmonster.js was not loaded successfully. Ensure that the correct path is specified to the flexmonster.js file:

For the npm package

<script src="node_modules/flexmonster/flexmonster.js"></script>

For CDN

<script src="https://cdn.flexmonster.com/flexmonster.js"></script>

For the download package

<script src="flexmonster/flexmonster.js"></script>
Console error: 'Uncaught ReferenceError: Flexmonster is not defined'
Getting this error means that the new Flexmonster() API call was used to embed the component but flexmonster.js was not loaded successfully. Make sure that you have included flexmonster.js in your HTML page:

For the npm package

<script src="node_modules/flexmonster/flexmonster.js"></script>

For CDN

<script src="https://cdn.flexmonster.com/flexmonster.js"></script>

For the download package

<script src="flexmonster/flexmonster.js"></script>
Console error: 'SCRIPT5009: Flexmonster is undefined'
Getting this error in Internet Explorer means that the ES6 version of the component is used. Internet Explorer does not support the ES6 standard, so use the ES5 version of the component (flexmonster.es5.js) for this browser. It is available:
  • On the CLI and npm (along with flexmonster.es5.full.js)
  • On CDN
  • In download packages (inside the flexmonster/ folder)
Console error: 'ERROR TypeError: Flexmonster is not a constructor'
Such an error means that Flexmonster embedding failed since flexmonster.js was not loaded successfully. Make sure that the flexmonster.js file is successfully loaded in your project:

For the npm package

<script src="node_modules/flexmonster/flexmonster.js"></script>

For CDN

<script src="https://cdn.flexmonster.com/flexmonster.js"></script>

For the download package

<script src="flexmonster/flexmonster.js"></script>
Console error: 'ERROR TypeError: window.Flexmonster is not a function'
This error indicates that an attempt to embed Flexmonster failed because flexmonster.js was not loaded successfully. To resolve this error, include this file in your project:

For the npm package

<script src="node_modules/flexmonster/flexmonster.js"></script>

For CDN

<script src="https://cdn.flexmonster.com/flexmonster.js"></script>

For the download package

<script src="flexmonster/flexmonster.js"></script>
Pop-up alert and console errors: 'Flexmonster: Unable to create the component. DOM element is null.'
This error is thrown if the container parameter is missing in the new Flexmonster() API call. This parameter is necessary because it sets the selector of the HTML element which will be the container for the component. For an example of how container should be specified, refer to step 3 of our Quick start guide.
Pop-up alert and console errors: 'Flexmonster: Unable to create the component. DOM element with id 'pivotContainer' is not found.'
Such an error indicates that the <div> container for the component was not created. Add a container to your HTML page like so:
<div id="pivotContainer">The component will appear here</div>
Pop-up alert error: 'Flexmonster: Pivot cannot be drawn.'
This error means that the content of the flexmonster/ folder was not loaded successfully. Add the componentFolder parameter to the new Flexmonster() call. For more details about this parameter refer to the new Flexmonster() API call.
Console error: 'GET (any URL)/flexmonster/flexmonster.css 404 (Not Found)'
This error means that the component is located in a folder other than flexmonster/. Specify the componentFolder parameter. For more details about this parameter refer to the new Flexmonster() API call.
Console error: 'GET (any URL)/(your componentFolder parameter)/flexmonster.css 404 (Not Found)'
This error indicates that you specified the componentFolder parameter incorrectly. Make sure that componentFolder contains the URL of the component’s folder (with flexmonster.css and all other necessary files).
Console error: 'GET (any URL)/(your componentFolder parameter)/theme/assets/flexmonster-icons.woff 404 (Not Found); GET (any URL)/(your componentFolder parameter)/theme/assets/flexmonster-icons.ttf 404 (Not Found)'
This error means that the theme/assets/ folder is missing from the component’s folder. Add this folder, which can be found in the flexmonster/ folder inside the download package.
Console error: 'GET (any URL)/(your componentFolder parameter)/toolbar/flexmonster.toolbar.js 404 (Not Found)'
This error indicates that the toolbar/ folder is missing from the component’s folder and that toolbar: true was specified when embedding the component. Add this folder, which can be found in the flexmonster/ folder inside the download package.
Console error: 'GET (any URL)/(your componentFolder parameter)/lib/d3.min.js 404 (Not Found)'
This error means that the lib/ folder is missing from the component’s folder. The error is also possible if the d3.min.js file was manually removed from the lib/ folder. The d3.min.js library is necessary for using any charts functionality, so the error will only be shown when switching to charts. If any other file was removed from lib/ folder, the same error will appear in the console (only when the component needs these libraries). To get rid of such errors, add the lib/ folder to the component’s folder. The lib/ folder can be found in the flexmonster/ folder inside the download package.
License keys

This section explains the meaning of the error pop-ups you may experience if a problem occurs with license keys.

Current key is only applicable for example.com. You are trying to use the following key: XXXX-XXXX-XXXX-XXXX-XXXX
Verify that the domain name shown in your error message (e.g. example.com) matches the domain name of your project for which you have the key. If they are different, contact our team.
Integration with third-party charting libraries is not available in the trial version.
For our existing customers, we recommend replacing their trial license key with a development license key or with a production license key. If you are evaluating our component, please contact our team and request a special trial key.
Your license key is outdated and will not function with the current version. Please contact our team to find out about upgrade options.
This message means that you are using a newer version of Flexmonster than your license key allows. Please contact our team to request a new key or renew your maintenance.
You are trying to use a developer's key on a real domain (example.com). You are trying to use the following key: XXXX-XXXX-XXXX-XXXX-XXXX
This message indicates that a development license key is used which is applicable to a localhost environment only. To get the production key for the production environment or the development key for the real domain (e.g., example.com), please contact our team.
Your license period has expired. You are trying to use the following key: XXXX-XXXX-XXXX-XXXX-XXXX
This message is shown if your license key has expired. To renew your annual subscription, please contact our team.
Your trial period has expired. You are trying to use the following key: XXXX-XXXX-XXXX-XXXX-XXXX
This message means your trial license key has expired. To continue the evaluation of our component, please contact our team for trial extension.
Invalid license key. You are trying to use the following key: XXXX-XXXX-XXXX-XXXX-XXXX
Copy the license key you received after purchase and use it in your project. Also, check that the license key version is the same as the component’s version. For example, a license key for version 2.3 will not work with previous versions.
You are trying to use a template license or trial key: "XXXX-XXXX-XXXX-XXXX-XXXX". Please replace "XXXX-XXXX-XXXX-XXXX-XXXX" with an actual key.
This message means that you are using a key placeholder instead of a real license or trial key. Please replace "XXXX-XXXX-XXXX-XXXX-XXXX" with your actual key. If you don’t have a license key, please contact our team.
License key not found.
This message means that you have not specified a license key. Please specify your license key. For instructions on how the license key should be specified, refer to our guide on the license keys.
License key is corrupted.
This message means that you have probably copied only a part of the key. Please open the message you received after purchase and try copying the license key again.
Serial number not found.
This message means that you have not specified a license key. Please specify your license key. For instructions on how the license key should be specified, refer to our guide on the license keys.
Serial number is corrupted.
This message means that you have probably copied only a part of the key. Open the message you received after purchase and try copying the license key again.
Data source

This section explains the meaning of errors you may experience if a problem occurs with the data source.

Unable to open the FileName file.
Check the following points to resolve the issue:
- make sure the file exists
- make sure the 'Access-Control-Allow-Origin' header is present in the requested resource
- check the browser console for any errors
This message may refer to one of the reasons below:
  • There is no file with this name on the server. Make sure the filename you are trying to use is correct.
  • The browser requires more privileges to load the data. By default, cross-domain requests from JavaScript are blocked. Enable CORS to make such requests. Refer to enable-cors.org for more details on how to resolve this issue.
  • Internal server error — please open the browser’s console and check the errors there.
CSV and JSON support is not available in the current edition.
Each license key is bound to a data source. Check that the data source type for your license key, the type of the downloaded package, and the data source type you are using are the same. If you want to test a data source that is not included in your licensing plan, contact our team.
MS OLAP support is not available in the current edition.
Each license key is bound to a data source. Check that the data source type for your license key, the type of the downloaded package, and the data source type you are using are the same. If you want to test a data source that is not included in your licensing plan, contact our team.
Elasticsearch support is not available in the current edition.
Each license key is bound to a data source. Check that the data source type for your license key, the type of the downloaded package, and the data source type you are using are the same. If you want to test a data source that is not included in your licensing plan, contact our team.
Mondrian support is not available in the current edition.
Each license key is bound to a data source. Check that the data source type for your license key, the type of the downloaded package, and the data source type you are using are the same. If you want to test a data source that is not included in your licensing plan, contact our team.
icCube support is not available in the current edition.
Each license key is bound to a data source. Check that the data source type for your license key, the type of the downloaded package, and the data source type you are using are the same. If you want to test a data source that is not included in your licensing plan, contact our team.
File is too large.
This message means that your Flexmonster edition is Pivot Table for SQL/CSV/JSON Basic. This edition has a 5 MB limitation on data size and your file exceeds this limitation. To upload bigger files, upgrade to the SQL/CSV/JSON edition. For further details please contact our team.
Error opening URL. Please check your Internet connection.
This error means one of the following:
  • There is no Internet connection. Reestablish this connection.
  • You provided the wrong path to the proxy URL to the OLAP data source (Microsoft Analysis Services or Mondrian). Check that the URL is correct.
  • There is an issue with accessing the data — make sure that current user has enough privileges.
  • A server error occurred — check whether you have any errors in the browser’s console.
The data source or catalog is invalid. Please check the connection details.
Check the catalog and cube names that you entered for the connection to the cube. To get the exact names, use our OLAP connection tool from the Toolbar. Click the Connect tab, select To OLAP (XMLA), enter your Proxy URL, and click Connect. Select Data source info from the drop-down list. The list of available catalog names will be right under Data source info. After choosing the catalog name, the list of cube names will be shown.
Another possible cause of this error message is an internal server error. Try opening the browser’s console and checking there.
A stream error occurred while loading example.com
Check the following points:
  • Check that either your filename (for CSV and JSON data sources) or the proxy URL path, catalog, and cube names (for SSAS and Mondrian data sources) exist and that the current user has sufficient rights to access them.
  • Make sure that cross-domain requests are allowed. Additional information on this resource can be found here: enable-cors.org.
  • Open the console in your browser and check for internal server errors.
  • Check your Internet connection.
  • If you are using SSAS via XMLA protocol, enable cross-origin resource sharing for Internet Information Services (IIS). Check out our detailed step-by-step guide. We also suggest trying our special server-side proxy called Flexmonster Accelerator instead of XMLA (read more).