SOAP and REST Web Services Enhancements
This section describes the FlexNet Operations SOAP and REST Web Services enhancements introduced in 2021 R1.
Note:The SOAP Web Services are recommended for use by only producers for integration with the back office.
| • | Ability to Search by “Sold To” Account Name When Using “getEntitlementsQuery” |
| • | New Property to Capture the Device Creation Date |
| • | New Batch-size Limits in SOAP and REST Web Services |
| • | lastModifiedDate Parameter Available in searchDevices Request |
Ability to Search by “Sold To” Account Name When Using “getEntitlementsQuery”
Previously, the getEntitlementsQuery SOAP web service did not allow the ability to filter on the Sold To account name. An optional parameter, isSearchByName, has been added to the request type so that this filter can be carried out, without changing the way the API operates by default for existing integrations.
New Property to Capture the Device Creation Date
A new createdOn property showing the device creation date is now returned by the getDevice SOAP web service request.
This change is implemented as part of the v4 ManageDeviceService web service.
New Batch-size Limits in SOAP and REST Web Services
The following default batch-size maximums have been implemented for requests issued from SOAP and REST web services. Specifying a request with a batch size greater than the limit results in an error.
| • | All services that result in a write—such as createObject, updateObject, or createOrUpdateObject—now have a batch size maximum of 25 records. |
| • | All read services—that is, getObjectQuery and similar methods (for example, getEntitlementQuery and searchDevices)—now have a maximum batch size of 2000. |
Note that these limits can be adjusted to address the load requirements at your site. To make adjustments, the Super Administrator accesses Configure > FlexNet Platform Server > General Options and updates either or both options accordingly:
| • | Maximum Batch sizes for create/update Webservices requests |
| • | Maximum Batch sizes for read Webservices requests |
lastModifiedDate Parameter Available in searchDevices Request
A new parameter, lastModifiedDate, is now available with the searchDevices SOAP web service to enable users to filter results by the date that devices were last modified.