Trial Registration Method

QlmRegistration.asmx

QlmRegistration.asmx is a web service method that takes user information from the command line, generates a trial key for a given product and emails it to the user.

Refer to this article for instructions to hide the URL arguments.

To have the QLM License Server send emails, you must have an SMTP server and configure QLM to use your SMTP Server. Refer to the "Configure the QLM License Server to send emails" section in this article for more details.

Example:

https://qlm3.net/qlmdemo/QlmCustomerSite/qlmregistration.asmx/Register?is_productid=1&is_majorversion=1&is_minorversion=0&is_expduration=10

Argument
Description
Required

is_productname

Name of the product.

No

is_productid

The ID of the product.

Yes

is_majorversion

The major version of the product.

Yes

is_minorversion

The minor version of the product.

Yes

is_expduration

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

No

is_expdate

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

No

is_sendmail

By default, an email will be sent to the customer with the content of the is_emailtemplate. Set the is_sendmail argument to false to instruct QLM to not send an email.

No

is_emailfrom

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

No

is_emailsubject

Customize the subject of the email. Variables are allowed. See the supported variables below.

Yes

is_confirmationmessage

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

No

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

Yes

is_emailtemplate_failed

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

A special variable called %ErrorMessage% can be used in the body of the email template to display the error message.

No

is_userdata1

User Data to associate with the generated license

No

The following variables can be used in the appropriate fields

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

Contact Arguments

Contact information can be sent as URL arguments or as part of the POST data. When integrating with a third party, the web.config file thirdPartyRegistrationFields setting defines the mapping between the incoming fields and the QLM fields. To enable third-party integration such as MailChimp, you must set the useThirdPartyRegistrationFields setting to true in the web.config file.

When invoking the QlmRegistration.asmx directly from your own site, you can use the following arguments in the URL to specify the customer's contact information:

URL Argument
Description

Contact Information

is_fullname

Full name of the customer.

is_email

Email of the customer

is_phone

Telephone number of the customer.

is_company

Company name of the customer.

is_country

Country of the customer.

Additonal Properties

is_confirmationmessage

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

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.

is_sendmail

By default, an email will be sent to the customer with the content of the is_emailtemplate. Set the is_sendmail argument to false to instruct QLM to not send an email.

Registration Form Rules

In addition, you can set the following properties in the QlmCustomerSite's web.config file to control the behaviour of the registration request. Note that as of QLM v10, most of these properties can be set from the Server Properties tab in the QLM Management Console.

Setting
Description

isPhoneRequired

Determines if the phone field is mandatory.

isFullNameRequired

Determines if the full name field is mandatory.

isEmailRequired

Determines if the email field is mandatory.

isCompanyRequired

Determines if the company field is mandatory.

genericEmailProviders

List of generic email providers. QLM identifies if 2 requests are associated to the same company by looking at the email address. However, when an email address is generic such as gmail.com, QLM cannot determine if the requests are related. If a an email address matches one of the generic providers in this list, QLM does not block the request.

maxRegistrationsPerUser

The maximum number of registrations allowed per user (email). The default is 1.

preventRegistrationsIfCustomer

Prevent a user from requesting a trial license key if another user from the same domain has already purchased this product. This property works in conjunction with the genericEmailProviders property that allows you to configure generic email providers such as gmail.com and hotmail.com.

preventMultipleRegistrationsPerDomain

Prevent a user from requesting a trial license key if another user from the same domain has already requested a trial. This property works in conjunction with the genericEmailProviders property that allows you to configure generic email providers such as gmail.com and hotmail.com.

preventMultipleRegistrationsPerMajorVersion

Prevent a user from requesting multiple license keys for the same product major version. The default value is True.

preventMultipleRegistrationsPerMinorVersion

Prevent a user from requesting multiple license keys for the same product minor version. The default value is True.

preventMultipleRegistrationsPerProduct

Prevent a user from requesting multiple license keys for the same product. The default value is True.

thirdPartyRegistrationFields

See MailChimp Integration.

Last updated