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

ParameterDescription

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

Last updated