When a submitted order is modified, the order is cloned into a transient order that captures all of the modifications made by the agent. The transient order is then reconciled with the original order in a single transaction. Updates are not committed to the original order unless the reconciliation process is successful. If the agent abandons the transient order, any modifications made will be lost.
The cloning technique is performed on selected orders based on their state. The CSROrderHolder shouldCloneOrder(Order pOrder) API determines if a particular order qualifies for this process. This API returns a result based on the following criteria:
CSRAgentTools.isOrderModifiable– Compares the order’s state against the listed non-modifiable statesCSRAgentTools.cloneEditOrderStates– Compares the order’s state against the listed states that may be cloned. The configured states include:SUBMITTED,PROCESSING,PENDING_MERCHANT_ACTION,TEMPLATEandPENDING_AGENT_APPROVAL
Additional states can be added by modifying these two properties in CSRAgentTools.
CSROrderHolder
This class defines the shopping cart used by an agent to modify customer orders. It provides an API for determining when the application is in clone edit mode, for storing the clone edit state object and for masking the current working order ID with the original order ID. The loadOrder(Order) API initiates the clone edit process for a given order and stores the clone edit state object.
Classes |
|
|---|---|
Components |
|
CSRAgentTools
This class provides the more generic API used by the application. This includes the configuration for submitted order states and the API for determining if an order should used the cloning feature.
Classes |
|
|---|---|
Components |
|
CSRCommitOrderFormHandler
This form handler class provides the handlers for triggering the reconciliation process.
Form Handler |
|
|---|---|
Components |
|
For additional information on this form handler, refer to the ATG API Reference for Commerce Service Center.
