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.
{% code overflow="wrap" %}
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{% endcode %}
| 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 |
The syntax for setting a product property is:
{% code overflow="wrap" %}
&is_pp=<category>.<name>::value::expiryDate||<category>.<name>::value::expiryDate||...{% endcode %}
{% code overflow="wrap" %}
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{% endcode %}
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.
{% code overflow="wrap" %}
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{% endcode %}
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.
{% code overflow="wrap" %}
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{% endcode %}