FLEXNET OPERATIONS SOAP WEB SERVICES GUIDE

FlexNet Operations Web Services Guide

Method: getEntitlementLineItemPropertiesQuery

Description

The getEntitlementLineItemPropertiesQuery operation returns all entitlement line items and web register keys based on the provided search criteria, including draft entries.

This operation works similarly to the operation getActivatableItemsQuery. However, the response from getEntitlementLineItemPropertiesQuery is highly configurable. You can use it to select only the data you need in a given response.

Note: With this query, maintenance line items will not be returned if the product type Maintenance is used in the search criteria. Associated maintenance line items can be obtained by using the new response configuration element maintenance.

Use caution when crafting queries that may return excessive numbers of responses. The following error, ORA-01795: maximum number of expressions in a list is 1000, has be seen when performing searches via FlexNet Operations landing pages or web service queries when:

  1. FlexNet Operations is connected to an Oracle database
  2. Certain types of searches in the UI or web services return > 1000 items, for example, the entitlements or line item landing pages and getEntitlementsQuery or getEntitlementLineItemPropertiesQuery.

If the error is seen in the FlexNet Operations UI, consider setting the Entitlement Records per Page and Line Items Page Size per Entitlement settings to 1000 or less. If the error is seen in a web service query, set the batch size to 1000 or less and page through the results.

Parameters
Name  Type  Direction  Description 
msgparameters  searchEntitlementLineItemPropertiesRequestType  Input   
Returns

A searchEntitlementLineItemPropertiesResponse element having the structure defined by the following table.

Name  Type  Description 
statusInfo  StatusInfoType 
Element  Data Type  Description 
status
StatusType

Returns one of the following:

  • SUCCESS—All items in the request were processed.

  • PARTIAL_FAILURE—Some, but not all items in the request were processed. The getCount and getQuery operations never return PARTIAL_FAILURE.

  • FAILURE—None of the items in the request were processed.

reason
string
Gives reason for partial failure or failure.
 
entitlementLineItem  entitlementLineItemPropertiesType  See entitlementLineItemPropertiesType.