Method: getMatchingLineItems

Description

The getMatchingLineItems operation returns line items suitable to receive the count from a splitLineItem operation. The getMatchingLineItems operation searches for entitlement line items in entitlements with the target account in the target tier that match the line item you want to split. Any line item returned by this operation can receive the counts as the result of the split operation.

To be considered a matching line item, the line item that is the target of the split must share the following attributes with the line item that is the source of the split:

• Orderable

• License model

• License term (permanent, expiration date, duration)

• Version date details (options, date, duration)

• Line item state

• License model policies

• License model attributes

Note: If the source line item has a parent line item, then the entire ancestor tree is scanned to ensure that the parent line items of the target line item also match.

Parameters

Name	Type	Direction	Description
msgparameters	getMatchingLineItemsRequestType	Input

Returns

A getMatchingLineItemsResponse 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.
responseData	getMatchingLineItemsResponseListType	Information about entitlement line items in the target account that match the line item you plan to split is listed in the responseData element. See getMatchingLineItemsResponseListType.
failedData	failedMatchingLineItemsListType	Information about the entitlement line item that could not be matched to line items in the target account is in the failedData element. See Table failedMatchingLineItemsListType.