Creating an Add-On Identifier 

Use

To run add-ons on client machines, you need to create an identifier string that will allow the license service to recognize them.

In run-time, the identifier string is passed to the SDK before connecting to the SAP Business One application. The license service then checks for a valid license in your license file.

For more information, refer to the SAP Business One License Guide under the Documentation folder of the installation CD.

Add-ons developed in ASP .NET use a default user to connect to the application. This user does not have remote access rights. If the license service is installed on a remote machine, the add-on will not be able to connect to the license service, and the license service will not be able to validate your add-on license, therefore, resulting in connection failure.

To resolve this issue:

■      Install the license service on the same machine as IIS is installed.

■      Configure ASP .NET to a use different user, which has remote access rights.

Prerequisites

To generate an add-on identifier string for Solution add-ons, you must get a License Key Name from SAP by posting a request in the SAP Service Marketplace.

Procedure

       1.      From Administration ® License, choose Add-On Identifier Generator.

       2.      Choose the license for which you are generating the identifier:

○     Development – to run add-ons under the Development license

○     Implementation – to run add-ons under the Implementation license

○     Solution – to run add-ons under a distribution (Add-On Solution) license

       3.      If you are generating an identifier string for a Solution add-on, copy the license key name you received from SAP into the appropriate field.

Make sure to copy only the add-on name without the database type.

       4.      Choose Generate.

       5.      Copy the generated string to your code and make sure to set the AddonIdentifier property before you call the Connectmethod.

Example

UI API

  SboGuiApi.AddonnIdentifier = “4CC5B8A4E0213A68489E38CB4052855EE8678CD237F64D1C11CD2707A54EBD245D596E4050AE9B929FBD0FAB44F6”

  SboGuiApi.Connect

DI API

  Dim cmp As SAPbobsCOM.Company

  Set cmp = New SAPbobsCOM.Company

    cmp.UserName = "manager"

    cmp.CompanyDB = "SBODemo_US"

    cmp.Password = "manager"

    cmp.Server = “local”

    cmp.AddonIdentifier = “4CC5B8A4E0213A68489E38CB4052855EE8678CD237F64D1C11CD2707A54EBD245D596E4050AE9B929FBD0FAB44F6”

  cmp.Connect