License File - Own Screens

This workflow makes sense if you want to provide all screens in your own Look & Feel, you do not need online activation and you want to deliver a license file.

This scenario works as follows:

•Evaluation Version with generic license file. Use the same settings like EasyGo

•Customer buys the product - the installation code is displayed in your screen

•Installation code is transferred

•A customer specific license file including copy protection turned on is generated and sent back to the customer

•Customer copies license file to the installation directory

Create generic license 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 license File.

Test Evaluation Version and display installation code

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 license 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 SecurityLevel and 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 status Activation is none (0) then the software needs activation. Retrieve the activation status with GetWebActivation

•Display at least 2 installation codes (Hardware Ids) to register the software. Multiple codes are necessary in case one code can not be retrieved. Use GetInstcode to retrieve the code

•If the status Activation is done (2) then the software is activated

•To display errors you could use ShowStartErrorPage, which would also cover to view the license 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

Customer buys software

The customer has to transmit the 8 digit installation code. The next step is to create a customer specific license file (using the customer name, the installation code and all the modules the customer has bought). Important settings are:

•Set the field status of Activation to Done

•If the full version should have no time limitation, set Valid number of days to 0, Demo version to No and all other modules to the customer specific values.

•Select the desired Copy Protection method and type in the installation code the customer sent to you.

Generator - customer specific licence file

Each license file gets a new license file ID (like a Serial Number).

Now send the license file to the customer. As the copy protection is already switched on, the file can only be used on the licensed machine and the customer just has to copy the file to the installation directory.

You can test a module using ValidateEX (recommended), Validate or ValidatesYes

•Retrieve the module type - GetVal, Token LTY. Module type is also retrievable with GetModuleList (list of all modules within a license file)

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

•Check if a module exists in a license file - ExistsModule

•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 (2 = product / product activation for a module is done)

•Find out, if a module / license is deactivated using GetVerificationOfModule (result: frozen = 2)

•You can add modules (AddModule) to the license file or remove modules (DeleteModule) . This is necessary if you e.g. install an update of the application with new features

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

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

•Retrieve all entries / user / computer - GetEntriesOfModule

•Deactivate an entry / user / computer - DeactivateEntry

•Activate an entry / user / computer again - ActivateEntry

•Delete all entries / users / computers - RemoveAllItems

•Delete all deactivated entries / user / computer - RemoveDeactivated

•Check if a specified entry / user / computer exists - ExistsEntry

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

Recommendations

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

	License File - Own Screens					workflow-file-own-screen Dear Support Staff,
License File - Own Screens