Collaborative Quoting

Overview

For many customers, creating a quote is a team effort that requires several people with different knowledge, responsibilities, and concerns. There are often situations where these multiple stakeholders need to simultaneously work together on the same Transaction to complete it quickly. The entire sales team may need to collaborate to deliver a quote before a fiscal deadline, a holiday, or key milestone in a sales cycle.

CPQ supports three editing modes for quotes.

Collaborative Quoting supports multiple users collaborating in real-time on a single Transaction without conflict. In addition to allowing multiple users to simultaneously work on a Transaction, this feature also allows inbound integrations and email approvals to complete without disrupting active users.

ClosedConcurrent Editing of Quotes

ClosedCurrent Editor Display

ClosedReal-Time Activity Display

ClosedLocked Transaction in Collaborative Quoting

ClosedGranular Activity History Changes

ClosedCollaborative Quoting Enhancements

Collaborative quoting functionality has been widely adopted for CPQ customers. However, when consecutive long running collaborative quoting actions are invoked, customers can encounter performance issues.

  • Read-Only Operation Optimization - Beginning in Oracle CPQ 24D, collaborative quoting action requests that don't modify the transaction (i.e. read-only operations) are directly executed and won't be added to the collaborative queue. The following actions are read-only operations: Interact (read and polling requests), Refresh, and Display History.

    • This prevents the addition of unnecessary read-only operations in the collaborative queue.

    • This feature is disabled by default.

      Note: Customers can submit a Service Request (SR) on My Oracle Support to enable read operation optimization in collaborative queue.

      If your site has modification functions (e.g. Save BOM) associated with Interact (read and polling requests), Refresh, or Display History actions you should enable read operation optimization in collaborative queue only after analyzing the impact of these modification functions failing, or after changing your implementation to not modify the quote during read operations. Once the read-only operations are executed in parallel as part of the optimization, there are guardrails that will prevent these functions from modifying the transaction.

  • Queuing Management Enhancements - Oracle CPQ 24C introduced the following for collaborative quoting:

    • Reject collaborative quoting requests that exceed queue time limits. The Duration in minutes a task can wait in the queue before it gets cancelled on collaborative transactionsCommerce Options setting establishes a time limitation for the collaborative quoting job queue.

    • Automatically invalidate timed-out requests. If the duration of the pending task in the queue exceeds the value set for the Commerce Timeout Action Commerce Options setting, the task is removed from the queue and an error message is generated to inform the user that their action timed out, was not completed successfully, and their quote was not updated.


 

Administration

ClosedEnable Collaborative Editing

Complete the following steps to enable collaborative editing and configure unlock behavior for a Commerce Process.

If the Collaborative Editing option is not available for your site, log a Service Request on My Oracle Support.
  1. Navigate to the Commerce Processes Page.

    Admin > Commerce and Documents > Process Definition

  2. Select the applicable Commerce process.
  3. Select the Collaborative Editing option.

    Process Administration page Collaborative Editing option

  4. (Optional) Select the Let Other Users Perform Unlock Actions option.
  5. Select unlock actions from the Actions to Automatically Unlock Transaction list.
  6. Click Apply or Update.

ClosedUpdate Collaborative Quoting Job Queue Time Limitation

Complete the following steps to update the collaborative quoting job queue time limitation.

  1. Navigate to the Admin Home Page.

  2. Click Commerce Settings in the Commerce and Documents section.

  3. Enter the desired value for the Duration in minutes a task can wait in the queue before it gets cancelled on collaborative transactions option.

  4. Click Apply or Update.

Note: For more information, refer to Commerce Options. The Commerce Options topics also provides information for the Commerce Timeout Action, which controls the duration limit for automatically invalidating timed-out requests.


 

Notes

The following items are not supported in Collaborative Transaction in CPQ:

  • Secure Attributes are not supported in Collaborative Transactions in CPQ. Secure Attributes must be removed from the Commerce process when enabling Collaborative Editing.
  • History Attributes are not supported in Collaborative Transactions. History attribute data is cleared when an auto update is invoked in a collaborative session. Oracle CPQ recommends removing History Attributes from your Commerce JET Transaction UI layout if enabling Collaborative Editing
  • Operations or actions that affect multiple Transactions are not supported in Collaborative Transactions in CPQ. For example:
    • A SOAP updateTransaction request that updates multiple Transactions will fail if collaboration enabled. Other collaboration session users are not affected when these events fail. SOAP updateTransaction requests to update a single Transaction are still functional.
    • Mass Update of Transactions is not available when Collaborative Editing is enabled. To perform a Mass Update you can temporarily disable Collaborative Editing and re-enable it once you have finished.
    • Bulk Upload is not available when Collaborative Quoting is enabled.

Consider the following tips when using Collaborative Quoting:

  • When using auto-update to set an array set value, it is important to specify the row number in the JSON. Otherwise, the entire row is removed and recreated which can cause rendering issues.
  • When Collaborative Editing is enabled for a Commerce Process the Mobile layout will be replaced with the Commerce JET Transaction UI layout.
  • If a user is on a Line Item Detail page and the Line Item is deleted by another user, the record is removed immediately and changes will be lost. The user will need to use browser navigation buttons to return to the main document.
  • If a user's collaboration session times out while they are reconfiguring a model, their lock on that model is removed. If another user opens that model the first user will not be able to save it.
  • Print and email actions only include attribute values that are saved when the document is generated. Unsaved changes entered by other users after the action is invoked are not included in the output document.
  • The Copy action only includes attribute values that are saved when creating a duplicate Transaction. Unsaved changes entered by other users after the action is invoked are not carried over to the new copy.
  • If a user enters a value which triggers an immediate error, either due to a Constraint Rule or simple validations on attributes, that value is not shared with other users until it is resolved. Entered values that do not trigger errors until an action is performed will be shared with other users and the error will be displayed when the action runs.
  • If an action performed saves a change on any line item attribute, the _last_modified_date of the line item is updated. If collaborative quoting is used, the modification of the line item attribute may have occurred earlier but the action performed which saves that change will update the _last_modified_date of that line item.

Related Topics

Related Topics Link IconSee Also