Class Name |
|
|---|---|
Component(s) |
|
The RepriceOrderDroplet servlet bean is an instance of atg.commerce.order.purchase.RepriceOrder, which extends atg.service.pipeline.servlet.PipelineChainInvocation. The RepriceOrder class provides the objects that are needed to execute a repricing pipeline chain as convenient properties. Typically, execution of a repricing pipeline chain requires the Order, the Profile, the OrderManager, and the user’s PricingModelHolder. While the PipelineChainInvocation class is flexible enough to handle these requirements (and enable you to configure the properties as required in a Map), RepriceOrder is conveniently configured to reference these objects. This means the page developer doesn’t need to supply them as input parameters every time RepriceOrderDroplet is invoked.
By default, RepriceOrderDroplet is configured to invoke the repriceOrder pipeline chain to reprice an order. As such, it provides a mechanism for updating the price of an order every time a customer accesses the shopping cart page. This is useful if your sites enable customers to access their shopping carts through non-form actions, such as standard hyperlinks. Because of dynamic pricing, customers could potentially view inaccurate prices in their shopping carts when accessing the shopping cart through a hyperlink.
For more information on repricing an order, refer to the Repricing Orders section and the Checking Out an Order section in the Configuring Purchase Process Services chapter in the Core Commerce Programming Guide. Also refer to the Repricing Shopping Carts section in the Implementing Shopping Carts chapter. For more information on the repriceOrder pipeline chain, refer to the Core Commerce Programming Guide.
Input Parameters
pricingOp (Required)
The pricing operation to be executed. Acceptable pricing operations are defined in the atg.commerce.pricing.PricingConstants interface and are listed in the following table.
Pricing Operation | Pricing Constant |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
priceList
The ID of the pricelist to use. If you don’t specify this parameter, but you use pricelists to determine the order price, the pricelist specified for the active user is used. This parameter lets you provide an alternate pricelist.
chainId
The ID of the pipeline chain to execute. If this parameter is not set, then the servlet bean looks for a configured pipeline chain ID in the defaultChainId property. By default, RepriceOrderDroplet.defaultChainId is set to repriceOrder.
paramObject
A parameter Object used as an argument to the runProcess method of the PipelineManager during pipeline chain execution. If this parameter is not set, then the servlet bean looks for a configured value in the extraParametersMap property. It uses the configured value to construct a HashMap to use as an argument to the PipelineManager during pipeline chain execution. extraParametersMap represents a mapping of the new Hash Map’s keys to the request parameters that are bound to the new Hash Map’s values. By default, RepriceOrderDroplet.extraParametersMap is empty.
pipelineManager
The PipelineManager instance to use for pipeline chain execution. If this parameter is not set, then the servlet bean looks for a configured PipelineManager in the defaultPipelineManager property. By default, RepriceOrderDroplet.defaultPipelineManager is set to /atg/commerce/PipelineManager.
Output Parameters
exception
Any exception that occurred during the repricing process.
pipelineResult
The PipelineResult instance returned by the PipelineManager after a successful pipeline chain execution.
Open Parameters
success
The parameter rendered after successful execution of the pipeline chain.
successWithErrors
This parameter is rendered after a successful pipeline chain execution that contains error messages in the PipelineResult object.
failure
The parameter rendered after an unsuccessful attempt to execute the pipeline chain.
Example
<dsp:droplet name="RepriceOrderDroplet"> <dsp:param value="ORDER_SUBTOTAL" name="pricingOp"/> </dsp:droplet>
