ATG Commerce Reference Store Overview

age
The age property is a CRS-specific derived property calculated using the dateOfBirth property that is included in ATG Commerce. This property is used by the 25% Off Women’s Apparel promotion, which offers a 25% discount on products in the Women’s Apparel category to women that are between the ages of 30 and 39. See CRS Promotions for details on the 25% Off Women’s Apparel promotion.

autoLogin
Commerce Reference Store sets the autoLogin property default to true. This enables the ATG Commerce auto-login by profile feature, which allows registered customers to choose a “log me in automatically” option on your Web site. For more auto-login by profile information, see Tracking Registered Users in the ATG Personalization Programming Guide.

billingAddress
The billingAddress property stores a customer’s default billing address in an item of type contactInfo. Commerce Reference Store extends the ATG Commerce definition of billingAddress with the addition of the cascade attribute. This attribute indicates that when changes are made to a user item, appropriate changes should also automatically be made to the corresponding contactInfo item that stores the customer’s billing address. The cascade attribute is set to cascade="update,delete". update updates the contactInfo item as needed, while delete deletes the contactInfo item if the parent user item is deleted.

Note: For more information on the cascade attribute, see Cascading Data Relationships in the ATG Repository Guide.

categoryLastBrowsed
categoryLastBrowsed is a CRS-specific property that stores the last category a customer looked at. The gadgets that implement a Continue Shopping button use this property to return a customer to the last category page he viewed. categoryLastBrowsed may be updated by any of a number of JSP pages as a customer browses the ATG Store website. The following example shows the code in the /browse/gadgets/categoryContents.jsp gadget that sets categoryLastBrowsed:

email
Commerce Reference Store extends the email property by marking it as required.

externalID
externalID is a CRS-specific property that provides a location to store old customer IDs. The externalID property allows you to import customers from an existing site, and maintain and track their original IDs.

firstName
Commerce Reference Store extends the firstName property by marking it as required.

gender
Commerce Reference Store extends the gender property by adding an unknown value for customers who have registered but have not provided a gender selection. Gender is not a required property in Commerce Reference Store.

itemsBought
itemsBought is a CRS-specific property in the form of a list that stores all the products a customer has purchased. itemsBought data is stored in a separate table, called cpb_items_bought, with fields for user ID and SKU ID. Each time a customer submits an order in the /checkout/gadgets/confirmControls.jsp gadget, the Nucleus component /atg/store/order/purchase/CommitOrderFormHandler updates the cpb_items_bought table through a series of calls to two additional CRS-specific classes:

lastName
Commerce Reference Store extends the lastName property by marking it as required.

lastPurchaseDate
lastPurchaseDate is a CRS-specific property that stores the date of a customer’s last committed order. Each time a customer submits an order in the /checkout/gadgets/confirmControls.jsp gadget, the Nucleus component /atg/store/order/purchase/CommitOrderFormHandler populates this property through a series of calls to two additional CRS-specific classes:

numberOfOrders
numberOfOrders is a CRS-specific property that tracks the number of orders a customer has placed. Each time a customer submits an order in the /checkout/gadgets/confirmControls.jsp gadget, the Nucleus component /atg/store/order/purchase/CommitOrderFormHandler increments this property through a series of calls to two additional CRS-specific classes:

pricelist
The inclusion of a priceList property in the customer’s profile is required in order to implement ATG Commerce price list functionality. For detailed information, see the Using Price Lists section of the ATG Commerce Programming Guide.

referralSource
referralSource is a CRS-specific property that stores the selection a customer made from a list of referral sources while filling out the registration form in the /myaccount/gadgets/register.jsp gadget.

Commerce Reference Store referral choices are enumerated in userProfile.xml and include the following (the display string that appears in ATG Store is provided in parentheses):

Display strings for the referral sources are contained in the /atg/projects/store/profile/UserProfileTemplateResources.properties file in <ATG9dir>/CommerceReferenceStore/Store/EStore/lib/classes.jar.

Note: The display name for referralSource in the ATG Business Control Center is “Where did you hear about us.”

salePriceList
The inclusion of a salePricelist property in the customer’s profile is required in order to implement ATG Commerce sale price list functionality. For detailed information, see the Implementing Sale Prices Using Price Lists section of the ATG Commerce Programming Guide

shippingAddress
The shippingAddress property stores a customer’s default shipping address in an item of type contactInfo. Commerce Reference Store extends the ATG Commerce definition of shippingAddress with the addition of the cascade attribute. This attribute indicates that when changes are made to a user item, appropriate changes should also automatically be made to the corresponding contactInfo item that stores the customer’s shipping address. The cascade attribute is set to cascade="update,delete". update updates the contactInfo item as needed, while delete deletes the contactInfo item if the parent user item is deleted.

Note: For more information on the cascade attribute, see Cascading Data Relationships in the ATG Repository Guide.

storeID
storeId is a CRS-specific property that tracks the current country store for a customer, thereby making sure a customer sees the correct catalog, price lists, and so on, for his or her country. If you are not running Commerce Reference Store’s Store.Estore.International module, this property is ignored.