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:
Product Related Arguments
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:
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.
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