ATG Commerce Programming Guide

performScheduledTask

Called when the Scheduler finds that the placeScheduledOrders task is scheduled to run. When this method is called, the ScheduledOrderService attempts to obtain a global write lock from the server lock manager. If the lock is obtained successfully, the ScheduledOrderService calls its own doScheduledTask() method.

The placeScheduledOrders task is run at the interval defined in ScheduledOrderService.schedule. While the schedule that you set depends on the business needs of your site, as a general rule, it is recommended that you set it to “every 1 day.” For information on how to specify a schedule, see the Scheduler Services section of the Core Dynamo Services chapter in the ATG Programming Guide.

Note: Be aware that the defined interval specified in ScheduledOrderService.schedule begins when an application that includes ATG Commerce deploys. Therefore, if, for example, the ATG Commerce server is redeployed every 11 hours, and if the schedule property of a given scheduled Order is set to “every 12 hours,” then the scheduled Order is never placed.

doScheduledTask

Calls processDueScheduledOrders() to process any scheduled Orders that need to be checked out. Other objects can call this method to trigger on demand a poll of the Order Repository for due scheduled Orders.

processDueScheduledOrders

Processes all scheduled Orders that need to be checked out.

This method calls pollForNewOrders() to retrieve the list of scheduled Orders that need to be checked out. It then iterates through the array and calls processDueScheduledOrder() on each scheduled Order. (See the methods described later in this table for details.)

pollForNewOrders

Uses the query defined in the ScheduledOrderService.pollQuery property to poll the Order Repository defined in the ScheduledOrderService.orderRepository property with the repository view defined in the itemDescriptorName property (by default, set to scheduledOrder). The method returns an array of scheduled Orders that need to be checked out.

processDueScheduledOrder

Processes the current scheduled Order.

This method calls placeScheduledOrder() to check out the scheduled Order. If the scheduled Order is successfully checked out, then the method calls getNextScheduledRun() to set its nextScheduledRun property to the next date and time that it should be checked out.

If the scheduled Order fails to be checked out, then it rolls back to its original state. It will be retrieved again for processing the next time that pollForNewOrders() is executed.

getNextScheduledRun

Sets the next time that the scheduled Order should be checked out.

placeScheduledOrder

This method checks out the current scheduled Order using the following process:

First, the template Order is retrieved by calling ScheduledOrderTools.getTemplateOrder() and passing in the current scheduled Order.

Second, ScheduledOrderTools.UseOrderPriceListsFirst identifies if price list information should be extracted from an order template. The default is false.

Third, the template Order is cloned by calling ScheduledOrderTools.cloneOrder().

Fourth, if the ScheduledOrderTools.repriceOnClone property is set to True, then the cloned order is repriced by calling ScheduledOrderTools.repriceScheduledOrder().

Fifth, the cloned Order is saved to the Order Repository in its present state by calling OrderManager.updateOrder(), which executes the updateOrder pipeline. (For more information on the updateOrder pipeline, see Updating an Order with the OrderManager in this chapter.)

Finally, the cloned Order is checked out by calling ScheduledOrderTools.processScheduledOrder(), which in turn calls OrderManager.processOrder() and passes in the cloned Order and pipeline to execute. The pipeline to execute is set in ScheduledOrderTools.processOrderChainId; by default, this property is set to processOrder. When the order has been checked out successfully, it is passed on to Fulfillment. (For more information on the processOrder pipeline, see Checking Out an Order in this chapter.)

repriceScheduledOrder

Reprices the cloned Order. The repriceScheduledOrder() method calls ScheduledOrderTools.repriceScheduledOrder(), which executes the repricing pipeline specified in ScheduledOrderTools.repriceOrderChainId. By default, this property is set to repriceOrder. (For more information on the repriceOrder pipeline, see the Commerce Processor Chains section.)