This section describes extensions to existing item descriptors in the profile repository.
Extensions to the User Item Descriptor
This section describes property additions and extensions for the user
item descriptor.
age
Theage
property is a CRS-specific derived property calculated using thedateOfBirth
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 theautoLogin
property default totrue
. 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
ThebillingAddress
property stores a customer’s default billing address in an item of typecontactInfo
. Commerce Reference Store extends the ATG Commerce definition ofbillingAddress
with the addition of thecascade
attribute. This attribute indicates that when changes are made to auser
item, appropriate changes should also automatically be made to the correspondingcontactInfo
item that stores the customer’s billing address. Thecascade
attribute is set tocascade="update,delete"
.update
updates thecontactInfo
item as needed, whiledelete
deletes thecontactInfo
item if the parentuser
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 setscategoryLastBrowsed
:
<dsp:setvalue bean="Profile.categoryLastBrowsed"
paramvalue="categoryId" />
externalID
externalID
is a CRS-specific property that provides a location to store old customer IDs. TheexternalID
property allows you to import customers from an existing site, and maintain and track their original IDs.
gender
Commerce Reference Store extends thegender
property by adding anunknown
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, calledcpb_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 thecpb_items_bought
table through a series of calls to two additional CRS-specific classes:
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 apriceList
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 asalePricelist
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
TheshippingAddress
property stores a customer’s default shipping address in an item of typecontactInfo
. Commerce Reference Store extends the ATG Commerce definition ofshippingAddress
with the addition of thecascade
attribute. This attribute indicates that when changes are made to auser
item, appropriate changes should also automatically be made to the correspondingcontactInfo
item that stores the customer’s shipping address. Thecascade
attribute is set tocascade="update,delete"
.update
updates thecontactInfo
item as needed, whiledelete
deletes thecontactInfo
item if the parentuser
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’sStore.Estore.International
module, this property is ignored.
Extensions to the credit-card Item Descriptor
Commerce Reference Store extends the credit-card
item descriptor so that the credit card number is encrypted using the Triple DES encryption algorithm from the Sun JCE security provider. Out of the box, ATG Commerce doesn’t apply any encryption to credit card information.