Menu
Download Free Trial
  1. API reference
  2. Welcome
    1. Getting started
    2. Quickstart
    3. System requirements
    4. Typical errors
    5. Installation troubleshooting
  3. Connecting to Data Source
    1. JSON
      1. JSON data source
      2. Data types in JSON
    2. CSV
      1. CSV data source
      2. Data types in CSV
    3. SQL database
      1. Connecting to SQL database
      2. Connecting to database with .NET
      3. Connecting to database with .NET Core
      4. Connecting to database with Java
      5. Connecting to database with PHP
    4. Microsoft Analysis Services
      1. Connecting to Microsoft Analysis Services
      2. Getting started with Accelerator
      3. Installing Accelerator as a Windows Service
      4. Configuring username/password protection
      5. Configuring secure HTTPS connection
      6. 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. Configuring report
    1. Configuring 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. Calculated values
    10. Custom sorting
    11. Date and time formatting
    12. Configuring global options
  5. Integration with frameworks
    1. Integration with frameworks
    2. Integration with AngularJS
    3. Integration with Angular 2
    4. Integration with Angular 4
    5. Integration with React
    6. Integration with RequireJS
    7. Integration with TypeScript
    8. Integration with ASP.NET
    9. Integration with JSP
    10. Integration with PhoneGap
  6. Integration with charts
    1. Integration with charts
    2. Integration with Highcharts
    3. Integration with FusionCharts
    4. Integration with Google Charts
    5. Integration with any charting library
  7. Customizing
    1. Customizing toolbar
    2. Customizing appearance
    3. Localizing component
  8. Export and print
  9. Updating to the latest version
    1. Updating to the latest version
    2. Release notes
    3. Migration guide from 2.3 to 2.4
    4. Migration guide from 2.2 to 2.3
  10. Managing license keys
  11. Older Versions
    1. Documentation 2.3
    2. Documentation 2.2
    3. API reference - Flex
Table of contents

Configuring global options

Flexmonster component 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 reports. The details on how to configure all options in the reports are described in Configuring report article.

It is not mandatory though to explicitly set all the options in the reports. 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 needed to modify specific default options that will be common for all the reports. This can be done using the global object. global is a parameter of new Flexmonster() method. In general, global object should be considered as a global parent report. It can have dataSource, options and localization sub-objects of the same structure as inside report object. global object overrides default option values for all the reports of the component.

Thus, in case when 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"
    }
    

    See the live demo on JSFiddle.

  2. The following 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 how the example works on JSFiddle.

  3. Apply date and time formatting for the component:

    global: {
      options: {
        datePattern: "'date: 'MM/dd/yy'; time: 'HH-mm"
      }
    }
    

    Check how it works on JSFiddle.

  4. The next example shows how you can specify dataSource for all reports:

    global: {
      dataSource: {
        filename: "http://cdn.flexmonster.com/2.3/data/data.csv"
      }
    }
    

    Open the example on JSFiddle.

  5. The current report is usually obtained via save() or getReport() API calls. By default, reports returned by these methods contain only options which were explicitly defined inside the report object. For example, we have the component defined the following way:

    var pivot = new Flexmonster({
      container: "pivotСontainer",
      licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX",
      global: {
        localization: "loc/es.json"
      },
      report: {
        dataSource: {
        	filename: "http://cdn.flexmonster.com/2.3/data/data.csv"
        }
      }
    });
    

    save() and getReport() will get the report containing dataSource specified, but without options defined in global or defaults. Use withGlobals:true parameter in API calls to include localization, which was defined in global, to the report:

    save()

    flexmonster.save({
      withGlobals: true
    });
    

    getReport()

    flexmonster.getReport({
      withGlobals: true
    });
    

    To include the default options to the report, use withDefaults:true parameter:

    save()

    flexmonster.save({
      withDefaults: true
    });
    

    getReport()

    flexmonster.getReport({
      withDefaults: true
    });
    

    Test the complete example on JSFiddle.