- 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
To call this function, you must set the Server Property enableUpgradeLicense 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:
http://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
where
- is_avkey = the activation key to upgrade (required)
- is_productid = your product id as defined in QLM
- is_majorversion = your product's major version as defined in QLM
- is minorversion = your product's minor version as defined in QLM
- is_vendor = One of the supported vendors
- is_quantity = number of activations
- 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_expduration = duration of evaluation version
- is_expdate = date at which the license will expire
- 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_pwd = password as defined in the eCommerce Providers section in QLM (Manage Keys / Tools / 3rd Party Extensions or Manage Keys / Tools / eCommerce Providers)
- is_qlmversion = 5.0.00 or earlier versions
- is_pp = product properties to set
- is_userdata1=any data that you wish to publish. Note that the existing userdata on the server will be overwritten by the new value.
- is_affiliateid = ID of the affiliate to set
- is_licensemodel = trial | subscription | permanent
- is_revoke = true | false
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
Comments
0 comments
Please sign in to leave a comment.