Store data in the license file

This feature allows storing encrypted data in the license file. The license file acts like a small database. There are commands to save, retrieve and delete a record.

 

The data area could be used to store:

 

"Program configuration parameters
"Usage of the application - like number of program starts or last online validation
"Additional customer information
"Other custom values you do not want to save in the registry, an ini-file or a database

 

It works in the way that you use an ID and assign a text to this ID, e.g. ID = LastOnlineValidation, Text = 09/09/201.

 

 

You can generate and deploy license files with already stored values or you can store information during the runtime of your program.

 

All values can either be displayed in the License Viewer in the section Configuration or they can be just used internally and  then they are invisible in the License Viewer. Each value can have a different setting (e.g. value 1 and 3 are visible in the License Viewer, value 2 is invisible).

 

The ID for each record must be unique.

 

Click to enlarge
Values visible in the Licence Viewer in the section Configuration

 

There are different options, how to add and modify the data.

 

 Store data using the License Generator

All values can be modified in the data area within the License Generator.

 
Store data using DLL commands

There is a complete set of API commands to read and modify the data.

Save a value

Command SetConfig. If the ID already exists, the existing value is updated with the new value. You can specify, if the value should be visible in the License Viewer or not.

Read a value

Command GetConfig

Delete a value

Command DeleteConfig

Check if a value exists

Command ExistsConfig

Check if value is visible in the License Viewer

Command IsConfigVisible
Store data stored in the project template

You can also store default data in the project template.
 
Details see chapter Project Template

 

Example

<Configs>

         <Config name="CustomerID" visible="no">D83726</Config>

         <Config name="BasicConfiguration" visible="yes">This is a text</Config>

</Configs>

 

Store data using Automatic License Generator

 

The Automatic License Generator can be used to add the data when a license file is created.

 

Order XML file
 
<product>

  <ProductID>1</ProductID>

   <Quantity>1</Quantity>

   <AbsoluteLics>yes</AbsoluteLics>

<Configs>
<Config name="InvoiceNo" visible="yes">12345</Config>
<Config name="InvoiceDate"  visible="yes">2008-09-15</Config> 
</Configs> 

</Product>

 

Please check the separate documentation for the Automatic License Generator.

 

 

The data area can also be changed if the license file is uploaded to the Activation Server 4, then modified and then downloaded again

 

•License file upload / download in the source code
•Modify license file on the Activation Server 4

 

 

 Do not store large data e.g. MIME-encoded binary data like images or movies as this would significantly slow down the access to the license file. Especially with concurrent user, the license file is permanently read and updated.

 

 

 

 

 

This feature is only available in the Professional Edition.