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

Configuring global options

Flexmonster has a wide variety of configurable options: localization, grid options, chart options, etc.

Report objects are used to configure which data should be shown in the component, how it will be visualized, and what instruments will be available for data analysis. The values for all the possible options can be defined in the report. Details on how to configure all options in the report are described in the configuring report set of articles.

It is not mandatory to explicitly set all the options in the report. When a value for an option is not set in the report, it is pulled from the default values that are predefined in the component.

It is however often simpler to modify specific default options that will be common for all reports. This can be done using the global object. global is a parameter of the new Flexmonster() method. In general, the global object should be considered as a global parent report. It can have a dataSource, options, and localization sub-objects of the same structure as the report object. The global object overrides the default option values for all the reports of the component. Thus, if a specific option is not explicitly set in the report, the component will use the global value.

Examples

  1. Specify one localization for all reports:
    global: {
      localization: "loc/es.json"
    }
    
    Check out an example on JSFiddle.
  2. This example demonstrates how to set the read-only mode for all reports:
    global: {
      options: {
        grid: {
          showFilter: false
        },
        configuratorButton: false,
        sorting: false,
        drillThrough: false
      }
    }
    
    Check out an example on JSFiddle.
  3. Apply date and time formatting for “date string” date fields in the component:
    global: {
      options: {
        datePattern: "'date: 'MM/dd/yy'; time: 'HH-mm"
      }
    }
    
    Check out an example on JSFiddle.
  4. The next example shows how you can specify the dataSource for all reports:
    global: {
      dataSource: {
        filename: "https://cdn.flexmonster.com/data/data.csv"
      }
    }
    
    Check out an example on JSFiddle.
  5. The current report is usually obtained via the save() or getReport() API calls. By default, reports returned by these methods contain only the options that were explicitly defined inside the report object. For example, if we have the component defined like this:
    var pivot = new Flexmonster({
      container: "pivotСontainer",
      licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX",
      global: {
        localization: "loc/es.json"
      },
      report: {
        dataSource: {
        	filename: "https://cdn.flexmonster.com/data/data.csv"
        }
      }
    });
    
    save() and getReport() will get the report containing the specified dataSource, but without any options defined in global or defaults. Use the withGlobals: true parameter in the API calls to include localization that was defined in global in the report:

    save()

    flexmonster.save({
      withGlobals: true
    });
    

    getReport()

    flexmonster.getReport({
      withGlobals: true
    });
    
    To include the default options in the report, use the withDefaults: true parameter:

    save()

    flexmonster.save({
      withDefaults: true
    });
    

    getReport()

    flexmonster.getReport({
      withDefaults: true
    });
    
    Check out an example on JSFiddle.

What’s next?

You may be interested in the following articles: