Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

ccrz.ccLogicCartPlaceAsync.performDMLOnOrder

Performs the DML insert operation on the order's billing and shipping addresses. Then, this method updates field values on the ccrz__E_Cart__c and ccrz__E_Order__c records, and performs the DML update operation on those records. This method executes only during the synchronous portion of the initial ccrz.ccApiCart.placeAsync method call.

Compatibility

This reference applies to:

Release Managed Package Version API Version
B2B Commerce for Visualforce Winter ’21 4.13 12

Signature

global virtual Map<String, Object> performDMLOnOrder(Map<String, Object>)

Inputs (Required)

This method accepts the working Map<String, Object> after the ccrz.ccLogicCartPlaceAsync.createOrderHeader method completes.

This method requires the following keys in the working map:

ccrz.ccLogicCartPlaceAsync.CART_HEADER
ccrz__E_Cart__c record that represents the cart to convert to an order.
ccrz.ccLogicCartPlaceAsync.ORDER_HEADER
ccrz__E_Order__c record that represents the order to insert.
'orderBillingAddress'
ccrz__E_ContactAddr__c record cloned from the order's billing address to insert.
'orderShippingAddress'
ccrz__E_ContactAddr__c record cloned from the order's shipping address to insert.

The ccrz.ccLogicCartPlaceAsync.processAddresses method cloned the cart's billing and shipping addresses to create these ccrz__E_ContactAddr__c records.

Note

Logic Performed

This method completes the following actions:

  1. Performs the DML insert operation on the ccrz__E_ContactAddr__c records for the order's billing and shipping addresses
  2. Associates the inserted addresses with the ccrz__E_Order__c record.
  3. Sets the ccrz__OrderStatus__c field on the ccrz__E_Order__c record to In Creation.
  4. Performs the DML insert operation on the ccrz__E_Order__c record.
  5. Sets the following fields on the ccrz__E_Cart__c record:
    Field Value
    ccrz__ActiveCart__c false
    ccrz__CartStatus__c Processing
  6. Performs the DML update operation on the ccrz__E_Cart__c record.

Outputs

This method returns the working Map<String, Object>, and sets the following key:

ccrz.ccApiCart.ORDER_ID
String that specifies the Salesforce ID of the inserted ccrz__E_Order__c record.