User Personalization REST APIs

Overview

Oracle CPQ provides sales users with the flexibility of selecting columns, arranging columns, and applying filters in the Line Item Grid. They can also save Line Item Grid personalization, and then apply their saved Line Item Grid personalization to subsequent user sessions. The User Personalization REST APIs provide web services to support Line Item Grid user personalization.

Administration

ClosedGet All User Personalizations

Get All User PersonalizationsGET Method

Description

Use this endpoint to retrieve a list of user Line Item Grid personalizations for the current user.

URI Endpoint

/rest/v17/userPersonalizations

Endpoint Parameters

None

(Optional) This endpoint supports the following query specifications: fields, limit, offset, orderby, q, and totalResults.

For more information, see Manage Collections.

HTTP Method

GET

Request Body Parameters None
Response Body Parameters A collection of user Line Item Grid personalizations.

dateAdded

The date the user personalization was created.

dateModified

The date the user personalization was last modified.

entityType

The functional area with CPQ. For example, COMMERCE.

personalizationData

An array of personalization data, containing the following items:

componentName

The name of the personalized component.

modifiedDate

The date the component properties were last modified.

properties

The properties personalized by the user.

personalizationName

The name of the user personalization.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/userPersonalizations


ClosedResponse Body Sample

{ "hasMore": false, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/userPersonalizations" } ], "items": [{ "personalizationName": "oraclecpqo-transaction-userState", "entityType": "COMMERCE", "dateModified": null, "personalizationData": [{ "componentName": "table-transactionLine", "properties": { "textWrapMode": "wrap", "hiddenColumns": ["_part_display_number", "oRCL_ABO_ActionCode_l"], "columnOrder": { "_chargeSetControl": 0, "_group_sequence_number": 1, "_part_number-_model_name": 2, "_part_display_number": 5, "listPrice_l": 6, "_price_quantity": 8, "customDiscountValue_l": 7, "customDiscountType_l": 9, "customDiscountAmount_l": 10, "netPrice_l": 11, "priceScore_l": 12, "netAmount_l": 13, "contractListValue_l": 14, "contractDiscount_l": 15, "contractValue_l": 16, "fulfillmentStatus_l": 3, "oRCL_ABO_ActionCode_l": 4 }, "expandMode": true, "columnWidth": { "fulfillmentStatus_l": 200 }, "sortCriteria": { "attribute": "listPrice_l", "direction": "descending" } }, "modifiedDate": "2023-09-29 03:46:08" } ], "dateAdded": null, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/userPersonalizations/oraclecpqo-transaction-userState" } ] }, { "personalizationName": "transaction_bmClone_2-quote-userState", "entityType": "COMMERCE", "dateModified": null, "personalizationData": [{ "componentName": "table-lineItem", "properties": { "textWrapMode": "wrap", "hiddenColumns": ["_part_number-_model_name", "_price_override_quantity", "_price_configurable_price"], "columnOrder": { "_chargeSetControl": 0, "documentNumber": 1, "_sequence_number": 2, "_part_number-_model_name": 3, "_part_display_number": 7, "_price_quantity": 9, "_price_override_quantity": 6, "_price_item_price_each": 4, "_price_configurable_price": 8, "_price_list_price_each": 5, "_pricing_rule_price_each": 10, "_price_unit_price_each": 11, "_price_subtotal": 12, "_price_override_price": 13, "_price_total_discount": 14, "_price_discount_percent": 15, "_price_override_discount": 16, "_price_net_price": 17 }, "expandMode": true, "columnWidth": { "_part_display_number": 200 }, "sortCriteria": { "attribute": "_price_list_price_each", "direction": "descending" } }, "modifiedDate": "2023-09-29 03:40:18" } ], "dateAdded": null, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v17/userPersonalizations/transaction_bmClone_2-quote-userState" } ] } ] }


ClosedGet a User Personalization

Get a User PersonalizationGET Method

Description

Use this endpoint to retrieve the specified user Line Item Grid personalization.

URI Endpoint

/rest/v17/userPersonalizations/{personalizationName}

Endpoint Parameters

personalizationName

The name of the user personalization.

HTTP Method

GET

Request Body Parameters None
Response Body Parameters

dateAdded

The date the user personalization was created.

dateModified

The date the user personalization was last modified.

entityType

The functional area with CPQ. For example, COMMERCE.

personalizationData

An array of personalization data, containing the following items:

componentName

The name of the personalized component.

modifiedDate

The date the component properties were last modified.

properties

The properties personalized by the user.

personalizationName

The name of the user personalization.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/userPersonalizations/oraclecpqo-transaction-userState


ClosedResponse Body Sample

{ "hasMore": false, "links": [ { "rel": "self", "href": "https://sitename.oracle.com/rest/v17/userPersonalizations" } ], "items": [{ "personalizationName": "oraclecpqo-transaction-userState", "entityType": "COMMERCE", "dateModified": null, "personalizationData": [{ "componentName": "table-transactionLine", "properties": { "textWrapMode": "wrap", "hiddenColumns": [ "_part_display_number", "oRCL_ABO_ActionCode_l" ], "columnOrder": { "_chargeSetControl": 0, "_group_sequence_number": 1, "_part_number-_model_name": 2, "_part_display_number": 5, "listPrice_l": 6, "_price_quantity": 8, "customDiscountValue_l": 7, "customDiscountType_l": 9, "customDiscountAmount_l": 10, "netPrice_l": 11, "priceScore_l": 12, "netAmount_l": 13, "contractListValue_l": 14, "contractDiscount_l": 15, "contractValue_l": 16, "fulfillmentStatus_l": 3, "oRCL_ABO_ActionCode_l": 4 }, "expandMode": true, "columnWidth": { "fulfillmentStatus_l": 200 }, "sortCriteria": { "attribute": "listPrice_l", "direction": "descending" } }, "modifiedDate": "2023-09-29 03:46:08" } ], "dateAdded": null, "links": [ { "rel": "self", "href": "https://sitename.oracle.com/rest/v17/userPersonalizations/oraclecpqo-transaction-userState" } ] } ] }


ClosedReset User Personalization

Reset User Personalization POST method

Description

Use this endpoint to reset the Line Item Grid to default settings.

URI Endpoint

/rest/v17/userPersonalizations/actions/reset

Endpoint Parameters

None

HTTP Method

POST

Request Body Parameters

personalizationName

The name of the user personalization.

componentName

The name of the personalized component.

entityType

The functional area with CPQ. For example, COMMERCE.
Response Body Status 200 OK
Response Body Parameters

items

This action returns an empty items object.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/userPersonalizations/actions/reset


ClosedRequest Body Sample

{ "personalizationName": "oraclecpqo-transaction-userState", "componentName": "table-lineItem", "entityType": "COMMERCE" }


ClosedResponse Body Sample

{ "items": [] }


ClosedSave User Personalization

Save User Personalization POST method

Description

Use this endpoint to save the user Line Item Grid personalization.

URI Endpoint

/rest/v17/userPersonalizations/actions/save

Endpoint Parameters

None

HTTP Method

POST

Request Body Parameters

entityType

The functional area with CPQ. For example, COMMERCE.

personalizationName

The name of the user personalization.

personalizationData

An array of personalization data, containing the following items:

componentName

The name of the personalized component.

modifiedDate

The date the component properties were last modified.

properties

The properties personalized by the user.

Response Body Parameters

dateAdded

The date the user personalization was created.

dateModified

The date the user personalization was last modified.

entityType

The functional area with CPQ. For example, COMMERCE.

personalizationData

An array of personalization data, containing the following items:

componentName

The name of the personalized component.

modifiedDate

The date the component properties were last modified.

properties

The properties personalized by the user.

personalizationName

The name of the user personalization.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v17/userPersonalizations/save


ClosedRequest Body Sample

{ "personalizations": [{ "personalizationName": "oraclecpqo-transaction-userState", "personalizationData": [{ "properties": { "expandMode": true, "columnOrder": { "_chargeSetControl": 0, "_group_sequence_number": 1, "_part_number-_model_name": 2, "_part_display_number": 5, "listPrice_l": 6, "_price_quantity": 8, "customDiscountValue_l": 7, "customDiscountType_l": 9, "customDiscountAmount_l": 10, "netPrice_l": 11, "priceScore_l": 12, "netAmount_l": 13, "contractListValue_l": 14, "contractDiscount_l": 15, "contractValue_l": 16, "fulfillmentStatus_l": 3, "oRCL_ABO_ActionCode_l": 4 }, "hiddenColumns": ["_part_display_number", "oRCL_ABO_ActionCode_l"], "textWrapMode": "wrap", "columnWidth": { "fulfillmentStatus_l": 200 }, "sortCriteria": { "attribute": "listPrice_l", "direction": "descending" } }, "componentName": "table-transactionLine" } ], "entityType": "COMMERCE" } ] }


ClosedResponse Body Sample

{ "result": [{ "personalizationName": "oraclecpqo-transaction-userState", "personalizationData": [{ "componentName": "table-transactionLine", "properties": { "textWrapMode": "wrap", "hiddenColumns": ["_part_display_number", "oRCL_ABO_ActionCode_l"], "columnOrder": { "_chargeSetControl": 0, "_group_sequence_number": 1, "_part_number-_model_name": 2, "_part_display_number": 5, "listPrice_l": 6, "_price_quantity": 8, "customDiscountValue_l": 7, "customDiscountType_l": 9, "customDiscountAmount_l": 10, "netPrice_l": 11, "priceScore_l": 12, "netAmount_l": 13, "contractListValue_l": 14, "contractDiscount_l": 15, "contractValue_l": 16, "fulfillmentStatus_l": 3, "oRCL_ABO_ActionCode_l": 4 }, "expandMode": true, "columnWidth": { "fulfillmentStatus_l": 200 }, "sortCriteria": { "attribute": "listPrice_l", "direction": "descending" } }, "modifiedDate": "2023-11-17 19:35:52" } ], "entityType": "COMMERCE" } ] }