SOAP and REST Web Services Issues Resolved in 2025.08

The following issue related to FlexNet Operations Web Services was addressed in the 2025.08 release.

Pagination Support for getDevice API

(Cases 02889573, 02986713, 02988303; SWM-25393)

In certain scenarios, producers encountered timeouts when issuing getDevice requests (of the ManageDeviceService SOAP web service) to devices with a large number of licenses. To mitigate this, pagination functionality has been added to the getDevice API.

New Optional Input Parameters

•

pageNumber (Integer): Specifies the specific page of results to retrieve.

•

batchSize (Integer): Specifies the number of device Addon records to return per page.

Pagination Behavior

•

Pagination is conditionally applied. It will be activated only if the pageNumber or batchSize parameter (or both) are explicitly provided in the request.

•

If both parameters are missing or null, the API defaults to its original behavior, returning the entire dataset without pagination.

•

This approach ensures backward compatibility, allowing existing consumers of the service to continue functionaing without disruption or modification.

•

The SOAP response structure remains unchanged.

Implementation Details

This implementation follows the established pagination model used in other APIs, where:

•

Both parameters are optional.

•

A default batchSize of 500 is applied if not explicitly specified.

Example Sample Request and Response to Determine Batch Size

The following example code shows a request and response for the counts API. In the request, the DeviceAddOnCountReference is used to retrieve the number of addon counts that can be used for calculating the batch size in the getDevice API.

Sample Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:uri="uri:webservice.subscribenet.intraware.com" xmlns:uri1="uri:subscribenet.intraware.com">

   <soapenv:Header>

      <uri:SessionHeader>

         <uri:SessionID>

            762b5395-fe49-482c-94f6-ba2334c69eb8zRtVhRI6n4Gf13yd6OyTn/dIMQNJuJLM0mxcnCCnfpwxgAqg==

         </uri:SessionID>

      </uri:SessionHeader>

   </soapenv:Header>

   <soapenv:Body>

      <uri:Get xmlns="uri:subscribenet.intraware.com">

         <uri:SubscribeNetObjectReference xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="DeviceAddOnCountReference">

            <uri1:ID>R-Dev1</uri1:ID>

            <uri1:HostIDType>STRING</uri1:HostIDType>

            <uri1:PublisherName>fnetest</uri1:PublisherName>

         </uri:SubscribeNetObjectReference>

      </uri:Get>

   </soapenv:Body>

</soapenv:Envelope>

Sample Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

   <soapenv:Header/>

   <soapenv:Body>

     <p130:GetResponse xmlns:p130="uri:webservice.subscribenet.intraware.com">

         <p130:SubscribeNetObject xsi:type="p1:DeviceAddOnCount"

xmlns:p1="uri:subscribenet.intraware.com">

            <p1:AddOnCounts>816</p1:AddOnCounts>

         </p130:SubscribeNetObject>

      </p130:GetResponse>

   </soapenv:Body>

</soapenv:Envelope>

Example Sample Request and Response With Pagination

The following examples shows two requests and their responses with the pagination parameters pageNumber and BatchSize.

Sample request 1

This request specifies a page number of 1 and batch size of 2.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:uri="uri:webservice.subscribenet.intraware.com" xmlns:uri1="uri:subscribenet.intraware.com">

   <soapenv:Header>

      <uri:SessionHeader>

         <uri:SessionID>98b6996f-6e7c-4d69-8a4f-0a30d283b51cBEOPhKziRuU3kEURgp2yCRB70hGbjf1gukc0Xw==

         </uri:SessionID>

      </uri:SessionHeader>

   </soapenv:Header>

   <soapenv:Body>

      <uri:Get xmlns="uri:subscribenet.intraware.com">

         <uri:SubscribeNetObjectReference xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="DeviceReference">

            <uri1:ID>R-Dev1</uri1:ID>

            <uri1:HostIDType>STRING</uri1:HostIDType>

            <uri1:PublisherName>fnetest</uri1:PublisherName>

            <!--type: integer-->

            <PageNumber>1</PageNumber>

            <!--type: integer-->

            <BatchSize>2</BatchSize>

         </uri:SubscribeNetObjectReference>

      </uri:Get>

   </soapenv:Body>

</soapenv:Envelope>

Sample response 1

The response includes 2 addons (highlighted in blue and green) along with device details.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

   <soapenv:Header/>

   <soapenv:Body>

      <p130:GetResponse xmlns:p130="uri:webservice.subscribenet.intraware.com">

         <p130:SubscribeNetObject xsi:type="p1:Device" xmlns:p1="uri:subscribenet.intraware.com">

            <p1:Alias>R-Dev1</p1:Alias>

            <p1:Owner>

               <p1:ID>AccID22_PO_AUT_14</p1:ID>

               <p1:IntrawareID>191158078</p1:IntrawareID>

               <p1:AccountName>AccName22_PO_AUT_14</p1:AccountName>

            </p1:Owner>

            <p1:AddOn>

               <p1:ActivationCode>003F-565B-937A-0BDC</p1:ActivationCode>

               <p1:Count>1</p1:Count>

               <p1:Description>FLX_CATALOG_DEPLOYMENT</p1:Description>

               <p1:IntrawareOrderID>482028358</p1:IntrawareOrderID>

               <p1:Expiration>

                  <p1:Permanent>0</p1:Permanent>

                  <p1:Date>2032-10-22</p1:Date>

               </p1:Expiration>

               <p1:Status>License generated</p1:Status>

            </p1:AddOn>

            <p1:AddOn>

               <p1:ActivationCode>00AB-5DE5-3E15-535C</p1:ActivationCode>

               <p1:Count>1</p1:Count>

               <p1:Description>FLX_CATALOG_DEPLOYMENT</p1:Description>

               <p1:IntrawareOrderID>482028358</p1:IntrawareOrderID>

               <p1:Expiration>

                  <p1:Permanent>0</p1:Permanent>

                  <p1:Date>2032-10-22</p1:Date>

               </p1:Expiration>

               <p1:Status>License generated</p1:Status>

            </p1:AddOn>

            <p1:VendorDictionary xsi:nil="true"/>

            <p1:Virtualized>0</p1:Virtualized>

            <p1:Status>ACTIVE</p1:Status>

            <p1:Reference>

               <p1:ID>R-Dev1</p1:ID>

               <p1:PublisherName>fnetest</p1:PublisherName>

               <p1:HostIDType>STRING</p1:HostIDType>

            </p1:Reference>

            <p1:DeviceModel>

               <p1:ID>FLX_CLIENT</p1:ID>

            </p1:DeviceModel>

            <p1:Returned>0</p1:Returned>

         </p130:SubscribeNetObject>

      </p130:GetResponse>

   </soapenv:Body>

</soapenv:Envelope>

Sample request 2

This request specifies a page number of 2 and batch size of 2.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:uri="uri:webservice.subscribenet.intraware.com" xmlns:uri1="uri:subscribenet.intraware.com">

   <soapenv:Header>

      <uri:SessionHeader>

         <uri:SessionID>98b6996f-6e7c-4d69-8a4f-0a30d283b51cBEOPhKziRuU3kEURgp2yCRB70hGbjf1gukc0Xw==</uri:SessionID>

      </uri:SessionHeader>

   </soapenv:Header>

   <soapenv:Body>

      <uri:Get xmlns="uri:subscribenet.intraware.com">

         <uri:SubscribeNetObjectReference xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="DeviceReference">

            <uri1:ID>R-Dev1</uri1:ID>

            <uri1:HostIDType>STRING</uri1:HostIDType>

            <uri1:PublisherName>fnetest</uri1:PublisherName>

            <!--type: integer-->

            <PageNumber>2</PageNumber>

            <!--type: integer-->

            <BatchSize>2</BatchSize>

         </uri:SubscribeNetObjectReference>

      </uri:Get>

   </soapenv:Body>

</soapenv:Envelope>

Sample response 2

Again, the response includes 2 addons (highlighted in blue and green) along with device details.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

   <soapenv:Header/

   <soapenv:Body

      <p130:GetResponse xmlns:p130="uri:webservice.subscribenet.intraware.com">

         <p130:SubscribeNetObject xsi:type="p1:Device" xmlns:p1="uri:subscribenet.intraware.com">

            <p1:Alias>R-Dev1</p1:Alias>

            <p1:Owner>

               <p1:ID>AccID22_PO_AUT_14</p1:ID>

               <p1:IntrawareID>191158078</p1:IntrawareID>

               <p1:AccountName>AccName22_PO_AUT_14</p1:AccountName>

            </p1:Owner>

            <p1:AddOn>

               <p1:ActivationCode>0122-5901-AF45-7AEA</p1:ActivationCode>

               <p1:Count>1</p1:Count>

               <p1:Description>FLX_CATALOG_DEPLOYMENT</p1:Description>

               <p1:IntrawareOrderID>482028358</p1:IntrawareOrderID>

               <p1:Expiration>

                  <p1:Permanent>0</p1:Permanent>

                  <p1:Date>2032-10-22</p1:Date>

               </p1:Expiration>

               <p1:Status>License generated</p1:Status>

            </p1:AddOn>

            <p1:AddOn>

               <p1:ActivationCode>017E-9810-51A0-5927</p1:ActivationCode>

               <p1:Count>1</p1:Count>

               <p1:Description>FLX_CATALOG_DEPLOYMENT</p1:Description>

               <p1:IntrawareOrderID>482028358</p1:IntrawareOrderID>

               <p1:Expiration>

                  <p1:Permanent>0</p1:Permanent>

                  <p1:Date>2032-10-22</p1:Date>

               </p1:Expiration>

               <p1:Status>License generated</p1:Status>

            </p1:AddOn>

            <p1:VendorDictionary xsi:nil="true"/>

            <p1:Virtualized>0</p1:Virtualized>

            <p1:Status>ACTIVE</p1:Status>

            <p1:Reference>

               <p1:ID>R-Dev1</p1:ID>

               <p1:PublisherName>fnetest</p1:PublisherName>

               <p1:HostIDType>STRING</p1:HostIDType>

            </p1:Reference>

            <p1:DeviceModel>

               <p1:ID>FLX_CLIENT</p1:ID>

            </p1:DeviceModel>

            <p1:Returned>0</p1:Returned>

         </p130:SubscribeNetObject>

      </p130:GetResponse>

   </soapenv:Body>

</soapenv:Envelope>