My Lists Detail Web Part

  • Article

The My Lists Detail Web Part provides the shopper with a detailed view of a shopper list. From the My Lists Detail Web Part, the shopper can remove an item from the list and add an item to the cart. The My Lists Detail Web Part also offers Continue Shopping and View My Cart functions.

By using the My Lists Detail Web Part, you can configure which columns to display and the order in which they display.

Architecture

The My Lists Detail Web part uses the XSLT template model and ASCX. The XSLT template lets you control how the cart is rendered to the browser. The ASCX control defines the list of possible actions and how they should behave.

The My Lists Detail Web Part contains these components:

  • WishListDetail Web Part: loads the specified user control dynamically. This is derived from the BaseUserControlWebpart class.

  • WishListDetail.ascx User Control: defines the possible actions that the shopper can take and handles these events. This user control includes an XsltShopperListDetailControl server control.

  • XsltShopperListDetailControl Web Control: builds an XML stream from the ShopperList commerce entity and then applies the specified template. This control is derived from XsltBaseControl.

  • ShoppingController: encapsulates all API calls relating to shopper lists manipulation.

Properties

The following table lists the mapping of the properties for the My Lists Detail Web Part.

Property

Maps to

"List Id" URL parameter

ListIdentifierUrlKey

Customization

You can customize the Web Part by modifying the XSLT template.

To add new actions to the Web Part, you can create or modify the WishListDetail user control.

To modify the ShopperList XML, you can modify or derive a new XsltShopperListDetailControl server control.

If you choose to not use XSLT in your implementation, you can modify the ASCX user control to suit your needs.

Error Handling

Friendly error messages will be displayed on the page.

API Dependencies

The dependencies on the API are:

  • Retrieve ShopperList and related items (LineItems)

See Also

Other Resources

Developing with SharePoint Commerce Services

Orders System Web Parts