In addition to all the great new features we introduced in SpreadJS v11, such as charts and more functions support, we’ve also simplified the licensing. In this blog I'll go over runtime licenses, designer licenses, and how to properly use them in your application.
SpreadJS Files
In SpreadJS V10, there were two separate sets of files: one for evaluation and one for production. The evaluation files could only be used with an evaluation license, and the production files could only be used with a production license. With V11, we've combined these into one file: you now only need one zip file, and the license will determine how the files behave at runtime.
Purchased License
When you purchase SpreadJS v11, you'll receive an email with information about the licenses you purchased. For each license, you'll get one Product Key. This is for internal tracking purposes only, and is not used when using your license in code.
The other key you'll receive is a Distribution Key, which will be attached in a TXT file to the email. When licensing the product, you'll want to use the long key in that file, called “License Key”.
Runtime Licensing
With every developer license, you'll receive one distribution license. This is the key you'll use in the script code.
If you need a distribution key to deploy your SpreadJS app, follow these simple steps:
-
Go to the My Licenses section of the website. You may have to log in to access your licenses.
-
In your distribution licenses, click Create Distribution Key.
-
On the next page, enter your domains. Subdomains must be registered separately. The maximum number of domains is determined by how many distribution licenses you’ve purchased but have not registered.
-
Once your key is generated, copy and paste it where you can easily reference it.
The license for SpreadJS v11 is set via script code, same as v10. This is done by setting the GC.Spread.Sheets.LicenseKey before creating a new Workbook() instance:
<script>
GC.Spread.Sheets.LicenseKey = " [your Distribution license key here]";
</script>
Watch the video:
Trial/Evaluation Licensing
After you download SpreadJS, you'll receive a 90-day evaluation key that doesn’t have any restrictions on domain-names. You can use this key when you test the deployment of your application, and SpreadJS will display a watermark:
This watermark, the unlimited domains, and the time cap are the only difference between the evaluation and production license keys.
Designer Licensing
The Designer license is a separate key from the runtime license key, and is used to unlock the SpreadJS Designer. One of the license keys you receive when you purchase SpreadJS will be marked as “Designer” and will have “Designer“ in front of it. To unlock the SJS V11 Designer, click on the lock icon in the top of the designer:
In the window that pops up, enter your designer license key and click OK:
The designer will restart and should be unlocked if the key is valid.
Running SpreadJS without a key
If a valid license key is not provided, SpreadJS can still run locally without any errors. This essentially means that SpreadJS will run on the following addresses without a license key:
- http(s)://localhost
- http(s)://127.0.0.1
- file://xxxx
However, if the application with SpreadJS is deployed to a domain without a valid license, Spread.Sheets will display an error message:
Incorrect License
If the license set in code is not correct, SpreadJS will display an error letting you know that the license is not correct:
Other Deployment Scenarios
When you deploy a mobile or JVM application, only one deployment license is needed per named application (not for each phone or JVM). Otherwise, every one domain needs one distribution license.
If you have any questions about licensing your application with SpreadJS V11, please contact the Spread Sales team at us.sales@grapecity.com
Download SpreadJS v11
Kevin Ashley