Getting started with customizing the Retail online sample store [AX 2012]

Updated: April 30, 2014

Applies To: Microsoft Dynamics AX 2012 R3

Retail in Microsoft Dynamics AX 2012 R3 includes starter stores that you can customize: the Contoso store that sells electronics and the Fabrikam store that sells clothing. These stores are built on the Microsoft SharePoint Server 2013 cross-site publishing platform. Source code and sample customizations for the starter stores are included in the Retail SDK.

Before you begin working with the Retail online sample stores, you should understand the technologies that support the online stores.

The following articles can help you to understand the capabilities and design of the Retail online sample stores.

The following table lists some of the common tasks in customizing a starter store.

How do I

Topics

Understand the lifecycle of a Retail online store

Online Store

View the functionality and appearance of the online sample stores on a demonstration virtual machine

Microsoft Dynamics AX 2012 Solution Demos*

Learn how the Retail online sample stores authenticate users and administrators, and learn how to add a logon provider such as Facebook

Authenticating users in Retail online sample stores

Create customizations of the components of the Retail online sample stores

Components of the Retail online sample store

Extend customer data in the online store

Walkthrough: Adding a table for customer preferences to the AX 2012 database

Walkthrough: Extending the CRT to add customer preference data for Retail clients

Walkthrough: Extending retail data distribution infrastructure for customer preferences

Walkthrough: Adding customer preferences to the Retail online sample store

Customize the appearance and behavior of the user interface for the Retail online sample store

Customize the appearance and behavior of site pages

Debug customizations in the Retail online sample stores

Debug code in a Retail online sample store

Deploy customizations to a test environment

Quick Guide: How to customize a Microsoft Dynamics AX for Retail online store

Use tools to help you configure publishing jobs, update the channel against which the online store operates, and clean up your SharePoint site.

Microsoft Dynamics AX for Retail online channel tools

NoteNote

*To access this site, you must be enrolled in a service plan.

Before you begin to plan and design your customizations, consider the current functionality of the starter stores.

The Retail online sample stores extend the product catalogs and business data managed in Microsoft Dynamics AX 2012 to online shoppers. All the code for the Retail online samples store is available for you to customize in the Retail SDK. The code supports sales transactions, manages authentication for new and returning customers, and manages data by using the Commerce Runtime (CRT).

Dn741227.collapse_all(en-us,AX.60).gifData flow in Retail online sample stores

Data in the Retail online sample stores is stored in the AX 2012 database and two SharePoint site collections. Product catalog data includes all data about product items: for example, color, size, and description. Other data displayed on the store pages includes information about customer accounts, transactions, and store locations. These two types of data, product catalog data and publishing portal data, are stored in two site collections that are located in separate web applications. For more information about these site collections that includes how security is implemented, see the Site collections section in the article Architecture of the Microsoft Dynamics AX Retail online store.

Dn741227.collapse_all(en-us,AX.60).gifCustomizing product catalog data

You control the products that appear in your online store by configuring catalogs and data distribution parameters in Microsoft Dynamics AX 2012 when you configure the online channel. For more information, see Configure online store products in Microsoft Dynamics AX.

The Retail online sample stores display products by using sample data in AX 2012. Several display templates are provided when you install the sample stores. You can find them in the folder that is available when you map a network drive. The path to the folder resembles the following:

Z:\_catalogs\masterpage\Display Templates\Content Web Parts

To customize the appearance of products in the sample stores, you can:

  • Use standard SharePoint Content Search Web Parts to display the products. To view the web parts for the Retail online sample stores, open the SharePoint Central Administration page and then click the Site Settings button and then click Web parts under Web Designer Galleries. For example, the Product Gallery page uses the Product Gallery web part. For more information, see Content Search Web Part in SharePoint 2013.

  • Modify the sample display templates that are provided by changing code in the HTML files on the mapped drive. Each HTML file has a corresponding .js file that SharePoint updates automatically after any changes that you make. For more information about mapping a network drive, see Map a network drive to the SharePoint 2013 files for online stores.

  • Customize the CSWPs in the sample stores. For more information, see Edit existing Web Parts in SharePoint 2013.

Dn741227.collapse_all(en-us,AX.60).gifManaging data in the store pages

The data distribution infrastructure manages data transfer from AX 2012 to the channel database. For example, data such as customer name and address are displayed in the Contoso online sample store. For more information, see Configure and schedule retail data distribution.

CRT services support the transfer of data in the channel database to the online store. For more information, see Services Overview for Commerce Runtime.

The Retail online sample stores use a model-view-controller pattern to present data on store pages. Data from the CRT services is mapped to the object model and then to the view model in code that supports the store pages. For an example that sets up this mapping for a new data element, see Walkthrough: Adding customer preferences to the Retail online sample store.

Dn741227.collapse_all(en-us,AX.60).gifCustomizing the appearance of store pages

You can customize the appearance of store pages in two ways. You can:

For more information about each component and the data elements that are included in the Retail online sample stores, see Components of the Retail online sample store.


Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).

Community Additions

ADD
Show: