Source Code Integration

To implement an workflow with a Serial Number you should implement the following code sequence.

Create generic licence file

The generic license file, which is included in the installation package, has exactly the same settings like the file used with EasyGo. See Create Licence File.

Test main licence

At the program start, implement the following code sequence

•	SetLanguage - define language for all screens and error messages. Necessary even if you use own screens

•

Open the licence file with PrepareAdvanced - implement an own error handling. Error 1024 (copy protection violation) should allow to type in an Activation Key to switch copy protection type. Use PrepareForce to open the file and ShowLicViewer or an own user interface to provide the necessary information

•	Now test the main module with ValidateEX or ValidatesYes and check for time limitation with RemainingDays an/or ExpiredOn

•	If the module is expired display a screen - Evaluation Period Expired. Make sure that you cover the situation if the version expires when the user already typed in a Serial Number and hasn't got the Unlock Key back

•	If the status Activation is none (0) then the software does not need activation (no Serial Number was applied). Retrieve the activation status with GetWebActivation. Display a screen like this - Start Screen in Evaluation Mode

•	If the status Activation is required (1) then a Serial Number was applied - display a screen to type in an Unlock Key - see Enter Unlock Key

•	If the status Activation is done (2) then the software is activated - a screen should be displayed only in case of an error generated during PrepareAdvanced

•	Provide an Own Licence Viewer

•	To display errors you could use ShowStartErrorPage, which would also cover to view the licence and apply keys. You can retrieve a language specific error message with GetErrorMessage for your own dialogs

•	Use Quit at the end of the application

You can make your own screens to type in a Serial Number and offer Online Activation, E-Mail, Fax or Phone Activation. The Serial Number must have the same settings like used in EasyGo - see Serial Number Key.

To save the Serial Number in the licence file use ApplyActivationKey. To save the user name use SetVal, Token CST.

The Serial Number can be retrieved from the Licence File GetVal(<Main module>, “KYS”). You will get a list of all keys but only use the first key. This is the Serial Number.

The Unlock Key must have the same settings like used in EasyGo - see Unlock Key. Just use ApplyActivationKey to save the Unlock Key.

The Online Activation process can be implemented with a few DLL calls. The configuration files are the same used for EasyGo - see Configuration of the Web Activation Server.

The Serial number would be used as the unique ID on the Activation Server.

The Serial Number can be retrieved from the Licence File GetVal(<Main module>, “KYS”). You will get a list of all keys but only use the first key. This is the Serial Number.

The sequence for the Online Activation is as follows:

•	Activate the licence for the main module using WebRegister and use as the unique ID the Serial Number

•	You can turn on/off the activation dialogs with ShowWAStartPage, ShowWAProgressPage, ShowWAResultPage

•	By defaults all other necessary parameters are retrieved from the licence file but could also be set individually Url to Activation Server - WebServiceURL Project name - ProjectName Proxy Settings - LocalProxyPort, LocalProxyServer, UseLocalIEProxy, UseLocalProxy

You can test a module using ValidateEX (recommended), Validate or ValidatesYes. Additional options are:

•	Retrieve the module type - GetVal, Token LTY. Module type is also delivered with GetModuleList

•	Retrieve module name - ModuleName. Module name is also delivered with GetModuleList

•	Retrieve status Demo version of a module (ValidateEx)

•	Retrieve time limitation of a module RemainingDays and/or ExpiredOn

•	Retrieve the number of days which have been set for the trial period - NoOfDays

•	Retrieve Activation Status of a module - GetWebActivation

For modules which are from type user, PC, concurrent, Item counter you can

•	Retrieve number of licences and available licences - TotalLicences and RemainingLicences. If the module is from type counter then you get the value of the counter with TotalLicences

•	Retrieve all entries - GetEntriesOfModule

•	Deactivate an entry - DeactivateEntry

•	Activate an entry again - ActivateEntry

•	Delete all deactivated entries - RemoveDeactivated

•	Check if a specified entry exists - ExistsEntry

•	Check if an entry is in use or deactivated - IsEntryActivated

Recommendations

You should provide a function to view the licence information. Either provide the Licence Viewer or implement an own viewer.