Class OrderHistory | Infocenter

Salesforce B2C Commerce 24.7 > B2C Commerce API > B2C Commerce Script > dw.customer

dw.customer

Class OrderHistory

dw.customer.OrderHistory

The class provides access to past orders of the customer.

Note: This class allows access to sensitive financial and cardholder data. Pay special attention to PCI DSS v3. requirements 1, 3, 7, and 9. It also allows access to sensitive personal and private information. Pay attention to appropriate legal and regulatory requirements related to this data. Note: The following methods do not work with Salesforce Order Management orders.

orderCount : Number (Read Only)

The number of orders the customer has placed in the store.

If the customer is anonymous, this method always returns zero. If an active data record is available for this customer, the orders count is retrieved from that record, otherwise a real-time query is used to get the count.

orders : SeekableIterator (Read Only)

Retrieves the order history for the customer in the current storefront site.

If the result exceeds 1000 orders, only the first 1000 orders are retrieved. Same as

 orderHistory.getOrders( null, "creationDate DESC" )

It is strongly recommended to call SeekableIterator.close() on the returned SeekableIterator if not all of its elements are being retrieved. This will ensure the proper cleanup of system resources.

This class does not have a constructor, so you cannot create it directly.

getOrderCount() : Number

Returns the number of orders the customer has placed in the store.

getOrders() : SeekableIterator

Retrieves the order history for the customer in the current storefront site.

getOrders(query : String, sortString : String, params : Object...) : SeekableIterator

Retrieves the order history for the customer in the current storefront site.

Methods inherited from class Object

assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values

getOrderCount

getOrderCount() : Number

Returns the number of orders the customer has placed in the store.

Returns:

the number of orders the customer has placed in the store.

getOrders

getOrders() : SeekableIterator

Retrieves the order history for the customer in the current storefront site.

If the result exceeds 1000 orders, only the first 1000 orders are retrieved. Same as

 orderHistory.getOrders( null, "creationDate DESC" )

It is strongly recommended to call SeekableIterator.close() on the returned SeekableIterator if not all of its elements are being retrieved. This will ensure the proper cleanup of system resources.

Returns:

the orders

See Also:

getOrders(String, String, Object...)

getOrders

getOrders(query : String, sortString : String, params : Object...) : SeekableIterator

Retrieves the order history for the customer in the current storefront site.

If the result exceeds 1000 orders, only the first 1000 orders are retrieved. Optionally, you can retrieve a subset of the orders by specifying a query. At maximum 3 expressions are allowed to be specified and no custom attribute expressions are allowed.

It is strongly recommended to call SeekableIterator.close() on the returned SeekableIterator if not all of its elements are being retrieved. This will ensure the proper cleanup of system resources.

Example:

            var orderHistory : dw.customer.OrderHistory = customer.getOrderHistory();
            var orders = orderHistory.getOrders("status = {0}", "creationDate DESC", dw.order.Order.ORDER_STATUS_NEW);
            for each (var order : dw.order.Order in orders) {
                // ... process orders
            }
            orders.close();

Parameters:

query - optional query

sortString - optional sort string

params - optional parameters for the query

Returns:

the orders