UpdateLicenseHttp

Description

Updates an existing license by modifying one or more of the following attributes:

• Features associated with a license

• The expiry date of the license

• Duration of the license

• Major and Minor version of the product

• Product Properties

• Quantity

• UserData

• Affiliate ID

• Revocation state

• Max Release Count and Max Release Period

To call this function, you must set the enableUpgradeLicense server property to true.

Unlike the UpgradeLicense method which generates a new Activation Key, UpdateLicense simply updates an existing license without generating a new Activation Key.

To invoke this method via a URL, append this function's name to the URL of the QLM License Server and add the required arguments.

https://yourserver/yourvirtualdirectory/qlmservice.asmx/UpdateLicenseHttp?is_avkey=<activationKey>&is_productid=<productID>&is_majorversion=<majorVersion>&is_minorversion=<minorVersion>&is_vendor=<ecommerce-provider>&is_features=<features>&is_expduration=<duration>&is_expdate=<date>&is_pp=<product_properties>&is_userdata1=abc

Arguments

Parameter	Description
is_affiliateid	ID of the affiliate to set
is_avkey	the current activation key
is_expdate	date at which the license will expire
is_expduration	expiry duration of the license key
is_features	semi-comma separated list of feature sets and their corresponding values. Example: is_features=0:3;1:1. This means that in feature set 0, features 1 + 2 are enabled and in feature set 1, feature 1 is enabled.
is_licensemodel	trial | subscription | permanent
is_productid	ID of the product
is_majorversion	new major version of the product
is_maxreleasecount	value of the MaxReleaseCount property
is_maxreleaseperiod	value of the MaxReleasePeriodInDays property
is_minorversion	new minor version of the product
is_pp	product properties to set
is_pwd	password as defined in the eCommerce Providers section in QLM (Manage Keys / Tools / 3rd Party Extensions or Manage Keys / Tools / eCommerce Providers)
is_quantity	number of activations
is_qlmversion	QLM engine version
is_revoke	flag to revoke a license
is_user	username as defined in the eCommerce Providers section in QLM (Manage Keys / Tools / 3rd Party Extensions or Manage Keys / Tools / eCommerce Providers)
is_vendor	One of the supported vendors

Remarks

The syntax for setting a product property is:

&is_pp=<category>.<name>::value::expiryDate||<category>.<name>::value::expiryDate||...

Example

https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/UpdateLicenseHttp?is_vendor=fastspring&is_productid=2&is_majorversion=1&is_minorversion=0&is_expduration=23&is_features=0:7&is_pp=quality.module_qa::abc::2017-12-31||quality.module_control::true||quality.module_validation::76

The expiry date is optional and available for QLM Enterprise customers. The expected expiry date format is: "yyyy-MM-dd HH:mm:ss".

In addition, for product properties of type integer, you can increment or decrement an existing value by prefixing the value with the + or - sign.

For example, in the URL below, the quality.module_validation will be decremented by 2.

https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/UpdateLicenseHttp?is_vendor=fastspring&is_productid=2&is_majorversion=1&is_minorversion=0&is_expduration=23&is_features=0:7&is_pp=quality.module_validation::-2

Note that due to URL encoding rules, the + sign should be replaced by %2B. For example, in the URL below, the quality.module_validation will be incremented by 2.

https://qlm3.net/qlmdemo/qlmLicenseServer/qlmservice.asmx/UpdateLicenseHttp?is_vendor=fastspring&is_productid=2&is_majorversion=1&is_minorversion=0&is_expduration=23&is_features=0:7&is_pp=quality.module_validation::%2B2