1.Migrating from WebDataRocks to Flexmonster

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

Let’s break the process of migration into small steps.

Installation
Creating a pivot instance
Setting a slice
Data sources
Migrating from WebDataRocks in Angular

Installation

You have three equivalent ways of replacing WebDataRocks dependencies with Flexmonster:

Install Flexmonster via npm with a single command:
```
npm i flexmonster
```
Download a package directly into your project.

Add a script from CDN:

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

Creating a pivot instance

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

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

Pay attention to the differences between the init API calls of Flexmonster and WebDataRocks.

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

There is one more new parameter in the init API call – componentFolder. Read more about its 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 the measures should be placed in square brackets:

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

Data sources

Flexmonster offers a much wider choice of data sources to which you can connect. On top of CSV and JSON, you can analyze the data from relational or NoSQL databases, Elasticsearch, SSAS, and Mondrian. To learn how to connect to these sources refer to the following guides:

Migrating from WebDataRocks in Angular

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

Run the following command in the console to add Flexmonster package and Flexmonster Angular module:
```
npm i ng-flexmonster --save
```

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"]

Replace WebDataRocksPivot module with FlexmonsterPivotModule in app.module.ts. app.module.ts can be found inside a PROJECT-NAME/src/app folder. It should look as follows:
```
import { FlexmonsterPivotModule } from 'ng-flexmonster';

@NgModule({
    ...
    imports: [FlexmonsterPivotModule],
    ...
})
```
Find a 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 which contains your license or trial key. Therefore, you should replace "XXXX-XXXX-XXXX-XXXX-XXXX" with the actual value of the key. If you don’t have a license key, get a trial key here (sent over e-mail).
Build and run your application from the console:
```
ng serve
```
The default port on which the application starts listening is 4200. Open http://localhost:4200/ in your browser to check the results.

Read more about integrating Flexmonster Pivot with Angular in the Integration with Angular guide.