Generate a trial key from your web site

QLM Customer Site

The QLM Customer site is a collection of web pages that you can integrate into your site to automate some processes and provide self-help to your customers.

QlmRegistrationForm.aspx is a registration form that collects user information and generates a trial key for a given product.

QlmRegistration.asmx is a service that can automatically generate a trial key and email it to the customer without presenting a form. This is useful when you already have a form to capture contact information and you just need to create a trial key.

The QLM Customer Site is deployed alongside the QLM License Server in the QlmCustomerSite folder. If you deploy the QLM Web Service manually, you must deploy the QlmCustomerSite (in the DeployToServer folder) and configure the QlmCustomerSite as an IIS Application.

QlmRegistrationForm.aspx supported arguments

ARGUMENT

DESCRIPTION

Type

is_affiliateid

ID of the affiliate associated with the license/customer.

Optional

is_bccemail

Semi comma-separated list of email recipients to bcc.

Optional

is_ccemail

Semi comma-separated list of email recipients to cc.

Optional

is_confirmationmessage

The message that is displayed to the user upon successful registration. Variables are allowed.

Optional

is_emailfrom

When sending an email, specify the email address of the sender.

Required

is_emailsubject

Customize the subject of the email. Variables are allowed. Variables are allowed.

Required

is_emailtemplate

Name of the email template to use when sending an email to the customer. Email templates can be created from the QLM Management Console / Manage Keys / Email Templates.

Required

is_expdate

Date at which the license expires. The default date format is:yyyy-MM-dd. The format can be changed from the web.config file.

Optional

is_expduration

Duration of the license, i.e. number of days after which the license will expire.

Optional

is_features

Semi comma-separated list of feature sets and their corresponding values. For more details, click here.

Optional

is_floating

The number of floating seats per license.

Optional

is_language

For the language to a specified locale. Example: &is_language=fr

Optional

is_majorversion

The major version of the product.

Required

is_maintplan

Enable the maintenance plan for the license. The value should be: true | false.

Optional

is_minorversion

The minor version of the product.

Required

is_productname

Name of the product.

Optional

is_productid

ID of the product.

Required

is_quantity

The number of activations per license.

Optional

is_userData1

Any data that you want to associate to the license.

Optional

Example:

https://qlm3.net/qlmdemo/QlmCustomerSite/qlmregistrationform.aspx?is_productname=My Product&is_productid=1&is_majorversion=1&is_minorversion=0&is_expduration=10&is_emailfrom=support@soraco.co&is_emailsubject=Your Download of %ProductName%&is_confirmationmessage=Your License information was emailed to: %Email%&is_emailtemplate=MyEmailTemplate

QlmRegistration.asmx supported arguments

ARGUMENT

DESCRIPTION

Type

is_affiliateid

ID of the affiliate associated with the license/customer.

Optional

is_bccemail

Semi comma-separated list of email recipients to bcc.

Optional

is_ccemail

Semi comma-separated list of email recipients to cc.

Optional

is_company

Company of the customer.

Optional

is_confirmationmessage

The message that is displayed to the user upon successful registration. Variables are allowed.

Optional

is_country

Country

Optional

is_email

Email of the customer.

Required

is_emailfrom

When sending an email, specify the email address of the sender.

Required

is_emailsubject

Customize the subject of the email. Variables are allowed. Variables are allowed.

Required

is_emailtemplate

Name of the email template to use when sending an email to the customer. Email templates can be created from the QLM Management Console / Manage Keys / Email Templates.

Required

is_expdate

Date at which the license expires. The default date format is:yyyy-MM-dd. The format can be changed from the web.config file.

Optional

is_expduration

Duration of the license, i.e. number of days after which the license will expire.

Optional

is_features

Semi comma-separated list of feature sets and their corresponding values. For more details, click here.

Optional

is_floating

The number of floating seats per license.

Optional

is_fullname

Full Name of the customer.

Optional

is_licensemodel

trial | subscription | permanent.

Optional

is_majorversion

The major version of the product.

Required

is_maintplan

Enable the maintenance plan for the license. The value should be: true | false.

Optional

is_minorversion

The minor version of the product.

Required

is_phone

Mobile Phone of the customer.

Optional

is_productname

Name of the product.

Optional

is_productid

ID of the product.

Required

is_quantity

The number of activations per license.

Optional

is_subscribeemail

Enables the Include In Mail List flag.

Optional

is_userData1

Any data that you want to associate with the license.

Optional

Example 1:

https://qlm3.net/qlmdemo/QlmCustomerSite/qlmregistration.asmx/Register?is_productname=My Product&is_productid=1&is_majorversion=1&is_minorversion=0&is_expduration=10&is_emailfrom=support@soraco.co&is_emailsubject=Your Download of %ProductName%&is_confirmationmessage=Your License information was emailed to: %Email%&is_fullname=Tom Brad&is_email=tom.brad@soraco.co&is_company=Soraco&is_phone=123-123-1234&is_emailtemplate=MyEmailTemplate 

The following Variables can be used in the appropriate fields:

%ActivationKey% %FullName% %Email% %EmailFrom% %ProductName% %MajorVersion% %MinorVersion%

To simplify the management of these arguments, we recommend using the is_args argument as described in this article. Note that is_args can be used for non-customer-specific data such as the product ID, major version, minor version, email template, etc. Customer-specific data such as full name, email, company, and phone must be passed as URL arguments.

Example 2 (using is_args):

https://qlm3.net/qlmdemo/QlmCustomerSite/qlmregistration.asmx/Register?is_args=demo_order&is_fullname=Tom Brad&is_email=tom.brad@soraco.co&is_company=Soraco&is_phone=123-123-1234

Email Configuration

To configure QLM to send an email with the license key, configure the SMTP server as follows:

  • From the QLM Management Console, go to the Manage Keys tab

  • Click Sites and select your profile

  • Go to the Server Properties tab

  • Expand the SMTP section and set all fields

  • Click Ok

The following settings can only be set by modifying the web.config file:

  • bannedEmailProviders

  • genericEmailProviders

  • showSubscribeToMailListCheckbox

Configuration using Server Properties

You can customize the behavior and some UI elements of the QLM Customer Site by setting Server Properties.

Last updated