Skip to content

Latest commit

 

History

History
122 lines (95 loc) · 14.6 KB

how-to-generate-a-trial-key-from-your-web-site.md

File metadata and controls

122 lines (95 loc) · 14.6 KB
Raw

How to 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:

{% code overflow="wrap" %}

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

{% endcode %}

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):

{% code overflow="wrap" %}

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

{% endcode %}

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.