Licensing

Evaluation version

If you are using evaluation version of ActiveReportsJS, the following constraints are applied:

• A watermark with an evaluation message appears on a report preview and in exported files
• The standalone designer application is available for 30 days

To extend your trial period, please contact us.sales@grapecity.com.

Licensing the designer application

• Find the Designer License Key in the Order Confirmation email and copy it
• Run the ActiveReportsJS Designer application
• Click the evaluation banner on the top right corner of the UI
• Paste the designer license key in the pop up dialog
• Click OK

Licensing the viewer component

If an application that uses ActiveReportsJS viewer is run on the localhost, as it normally hapens during development, no additional licensing steps are required. All the ActiveReportJS viewer functions are available without restrictions. However, rendered report pages will contain the evaluation banner displayed at the bottom. It is when the application to be deployed in the develop, staging or production server, the licensing key needs to be integrated in the application's code. First you need to generate the distribution key. Let's say that you've purchased the license that allows deployment to 3 hostnames and the application is deployed to the following Azure App Services:

• https://arjs-develop.example.com/ - develop environment to share the everyday progress of the application development
• https://arjs-staging.example.com/ - staging environment to share the stable version of the application before it's released for public access
• https://arjs-prod.example.com/ - production environment

To generate the distribution key for these host names:

• Login to your GrapeCity Account
• Navigate to "My Licenses" page and click "Distribution Licenses" link

• Find ActiveReportsJS license item
• Click "Create Distribution Keys" under "Actions"

• Click "Add a Hostname." Hostname dialog will appear.

• Enter "arjs-develop.example.com" in the text input and click "add hostname"
• Enter "arjs-staging.example.com" in the text input and click "add hostname"
• Enter "arjs-prod.example.com" in the text input and click "add hostname"
• Click "Generate Distribution Key" button
• The license key will appear at the bottom. Copy the key and save it somewhere for future reference

Now the generated license key should be inserted in the source code of your application. ActiveReportsJS Viewer is the client-side component, so the code that injects the license should be invoked on the client-side. Here are few recipies for the most popular front-end frameworks:

Licensing React-based application

• add the new "arjs-license.js"(or "arjs-license.ts" if you are using typescript) to the root folder of the application's client-side source code. Typically it would be "src" folder.
• add the following code in the newly added file

import { Core } from "@grapecity/activereports";

Core.PageReport.LicenseKey = "YOUR LICENSE KEY GOES HERE";

• add import from the newly added file to index.js(or index.ts) code

import {} from "./arjs-license";

Licensing Angular-based application

Insert the following code in the *.component.ts (or *.component.js) file of the Angular component that hosts ActiveReportsJs Viewer:

import { Core } from "@grapecity/activereports";

Core.PageReport.LicenseKey = "YOUR LICENSE KEY GOES HERE";

Licensing Vue-based application

The same method that is used for Angular-based applications can be applied for Vue applications as well. The code that sets Core.PageReport.LicenseKey can be invoked from the *.vue file of the hosting component.

Licensing with the vanilla JS code

Add the reference to ar-js-core.js script to the html page:

<script type="text/javascript" src="http://cdn.grapecity.com/activereportsjs/1.2.0/dist/ar-js-core.js"></script>

Add the following code so that it executes after ar-js-core.js script is loaded

GC.ActiveReports.Core.PageReport.LicenseKey = "YOUR LICENSE KEY GOES HERE";