This guide will walk you through the process of transitioning from WebDataRocks to Flexmonster.

Let’s break the migration into small steps.

1. Installation
2. Creating a pivot instance
3. Setting a slice
4. Data sources
5. Migrating from WebDataRocks in Angular

Installation

There are three ways of replacing WebDataRocks’ dependencies with Flexmonster’s:

1. Install Flexmonster using npm with a single command:

   npm i flexmonster

2. Download the package directly into your project.
3. Add a script from CDN:

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

Creating a pivot instance

Next, replace the WebDataRocks initialization API call with Flexmonster’s:

var pivot = new Flexmonster({
        container: "pivotContainer",
        report: {
            dataSource: {
                filename: "data.csv"
            }
        },
        licenseKey: "XXXX-XXXX-XXXX-XXXX-XXXX"
    });

Notice the differences between the init API calls of Flexmonster and WebDataRocks.

Flexmonster has an additional licenseKey parameter that contains your license or trial key. So, replace "XXXX-XXXX-XXXX-XXXX-XXXX"with the actual value of your key. If you don’t have a license key, get a trial key here (sent over e-mail).

The other new parameter in the init API call is the componentFolder. Read more about the init API’s initialization parameters.

Setting a slice

In WebDataRocks, we specified which hierarchies to put into the rows, columns, and measures by defining a Slice Object. The structure of the slice in Flexmonster is no different, except that measures should be placed in square brackets:

"slice": {
        "rows": [
            {
                "uniqueName": "Customer"
            }
        ],
        "columns": [
            {
                "uniqueName": "Month"
            },
            {
                "uniqueName": "[Measures]"
            }
        ],
        "measures": [
            {
                "uniqueName": "Revenue",
                "aggregation": "sum"
            }
        ]
    }

Data sources

Flexmonster allows you to connect to many more types of data sources. On top of CSV and JSON, you can analyze data from relational or NoSQL databases, Elasticsearch, SSAS, and Mondrian. To learn how to connect to these sources, refer to the following guides:

• Connecting to relational databases
• Connecting to NoSQL databases
• Connecting to Elasticsearch
• Connecting to Microsoft Analysis Services

Migrating from WebDataRocks in Angular

If you are working on an Angular project, follow these steps:

1. Run the following command in the console to add the Flexmonster package and the Flexmonster Angular module:

   npm i ng-flexmonster --save

2. Add CSS and JS references to the angular.json file:

   "styles": [    
       "styles.css",
       "/node_modules/flexmonster/flexmonster.min.css"
    ], 
   "scripts": ["/node_modules/flexmonster/flexmonster.full.js"] 

3. Replace the WebDataRocksPivot module with FlexmonsterPivotModule in app.module.ts. app.module.ts can be found inside the PROJECT-NAME/src/app folder. It should look as follows:

   import { FlexmonsterPivotModule } from 'ng-flexmonster';
   @NgModule({
        ...
        imports: [FlexmonsterPivotModule],
        ... }) 

4. Find the wbr-pivot directive that includes the pivot table and replace it with an fm-pivot directive. Here is an example:

   <wbr-pivot [report]="'https://cdn.flexmonster.com/reports/report.json'">
   </wbr-pivot>

   should be changed to:

   <fm-pivot [licenseKey]="'XXXX-XXXX-XXXX-XXXX-XXXX'"
    [report]="'https://cdn.flexmonster.com/reports/report.json'">
   </fm-pivot> 

   Flexmonster has an additional licenseKey parameter that contains your license or trial key. So, replace"XXXX-XXXX-XXXX-XXXX-XXXX" with the actual value of your key. If you don’t have a license key, get a trial key here (sent over e-mail).
5. Build and run your application from the console:

   ng serve

   The default port that the application listens to is 4200. Open http://localhost:4200/ in your browser to see the results.

To find out more about integrating Flexmonster Pivot with Angular, check out the Integration with Angular guide.