(Showing Draft Content)


Evaluation version

If you are using the 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

Alternatively, you can open the File menu, select the About item, click the Change product key button, paste the designer license key in the pop-up dialog and click the OK button.

Generating distribution keys

If an application that uses ActiveReportsJS components runs on the localhost, as it usually happens during development, no additional licensing steps are required. All the ActiveReportJS functions are available without restrictions. However, rendered report pages will contain the evaluation banner displayed at the bottom.

When you deploy the application in the developing, staging, or production server, you must integrate the distribution key in the application's code. You can request the evaluation distribution key at us.sales@grapecity.com.

For a paid license, you can manage distribution keys on your own. Let's say that you have a paid license that allows deployment to three hostnames, and you want to deploy the application to the following servers:

  • 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 you release it for public access

  • https://arjs-prod.example.com/ - production environment

To generate the distribution key for these hostnames:

  • Login to your GrapeCity Account

  • Navigate to the "My Licenses" page and click the "Distribution Licenses" link

  • Find ActiveReportsJS license item

  • Click "Create Distribution Keys" under "Actions"

  • Click the "Add a Hostname" button. The 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 the "Generate Distribution Key" button

  • The distribution key will appear at the bottom. Copy the key and save it somewhere for future reference

Now you should insert the generated key in the source code of your application. ActiveReportsJS runs on the client-side, so the code that injects the license should run on the client-side. Here are a few recipes for the most popular front-end frameworks:

Reactjs, Angular, and Vue applications

Add the following code to the entry point of your application. By default, the entry point is:

  • src/index.jsx(tsx) for a Reactjs application

  • src/main.ts for an Angular application

  • src/main.js(ts) for a Vue application

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

Pure JavaScript application

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

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

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

GC.ActiveReports.Core.setLicenseKey("DISTRIBUTION KEY GOES HERE");