The refreshOrder pipeline chain validates an Order from the repository. The Order object is supplied as a parameter. The refreshOrder pipeline chain is not executed explicitly, but rather by the Core Commerce components. The pipeline chain’s transaction mode is TX_REQUIRED.
The following sections describe each processor in the pipeline chain.
loadOrderObjectForRefresh
This processor takes an existing Order object and reloads the properties from the repository into it. It also loads all the supporting objects, such as CommerceItem, ShippingGroup, etc.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
loadCommerceItemObjects
This processor constructs a new CommerceItem object for each item it loads and loads the properties from the repository into it. It then adds the object to the Order.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
loadShippingGroupObjects
This processor constructs a new ShippingGroup object for each item it loads and loads the properties from the repository into it. It then adds the object to the Order.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
loadHandlingInstructionsObjects
This processor constructs a new HandlingInstruction object for each ShippingGroup that was loaded in the previous processor and loads the properties from the repository into it. It then adds the object to the ShippingGroup to which it belongs.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
loadPaymentGroupObjects
This processor constructs a new PaymentGroup object for each item it loads and loads the properties from the repository into it. It then adds the object to the Order.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
loadCostCenterObjects
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
loadPaymentStatusObjects
This processor constructs a new PaymentStatus object for each PaymentGroup that was loaded in the previous processor and loads the properties from the repository into it. It then adds the object to the PaymentGroup to which it belongs.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
loadRelationshipObjects
This processor constructs a new Relationship object for each item it loads and loads the properties from the repository into it. It then adds the object to the Order.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
loadPriceInfoObjects
This processor constructs a new OrderPriceInfo, TaxPriceInfo, ShippingPriceInfo, or ItemPriceInfo object for each item it loads and loads the properties from the repository into it. It then sets the PriceInfo to the corresponding object in the Order.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
setCatalogRefs
This processor sets the catalogRef property in the auxiliaryData object in the CommerceItem. It does this by loading the RepositoryItem object using the catalogRefId in the auxiliaryData object. Additionally, if SetCatalogRefs.substituteRemovedSku is true, this processor replaces all deleted SKUs in the Order with the “dummy” SKU defined by SetCatalogRefs.substituteDeletedSkuId. For more information, see Refreshing Orders in the Configuring Purchase Process Services chapter.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
setProductRefs
This processor sets the productRef property in the auxiliaryData object in the CommerceItem. It does this by loading the RepositoryItem object using the productId in the auxiliaryData object. Additionally, if SetProductRefs.substituteRemovedProduct is true, this processor replaces all deleted products in the Order with the “dummy” product defined by SetProductRefs.. For more information, see Refreshing Orders in the Configuring Purchase Process Services chapter.
substituteDeletedProductId
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | Return value of 1 will execute |
removeExpiredCommerceItems
Used in conjunction with SetCatalogRefs and SetProductRefs. If the state of the Order is one that is defined in RemoveExpiredCommerceItems.openOrderStates, this processor removes from the Order any CommerceItem that contains a “dummy” SKU or product that was substituted by SetCatalogRefs or SetProductRefs. A “dummy” SKU is automatically removed. A “dummy” product is removed only if RemoveExpiredCommerceItems.removeItemsWithDeletedProducts is set to true; the default is true. For more information, see Refreshing Orders in the Configuring Purchase Process Services chapter.
Transactional Mode | TX_MANDATORY |
Component |
|
Object |
|
Transitions | None, this is the last link in the chain, and will cause the |
