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

Product Related Arguments

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.