Online Store

Important

This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

Applies To: Microsoft Dynamics AX 2012 R3

Microsoft Dynamics AX 2012 includes a suite of features that help you deploy, manage, and customize an online sales channel that is fully integrated with Microsoft Dynamics AX. E-commerce investments include two starter online stores that are built on Microsoft SharePoint Server 2013, developer tools, and administrative and runtime components that integrate the online channel with Microsoft Dynamics AX.

By using this new suite of e-commerce features, you can centrally manage products, merchandizing, and order fulfillment for all aspects of your online sales channel directly in Microsoft Dynamics AX. The runtime component enables you to deliver content and retail services in a scalable way. The starter stores accelerate the development of a highly customized online channel. The starter stores include the patterns and best practices that are required to support production-ready deployments, including powerful, search-driven, adaptive experiences offered by the SharePoint Server 2013.

Lifecycle

Learn

Install

Extend

Configure

Resources

Resource page for Microsoft Dynamics AX 2012 for Retail

Retail for application users

Learn

The Microsoft Dynamics AX Retail online store is built on the cross-site publishing features of Microsoft SharePoint 2013 Products. Before you install and configure the online store you must familiarize yourself with the SharePoint 2013 planning documentation.

The following table includes information about the SharePoint 2013 for Internet Sites platform and the Retail online store architecture.

Task

Details

Topics

Plan the retail deployment

Before you install Microsoft Dynamics AX 2012 for Retail, you must decide on the system topology.

Deployment topologies for Retail

Plan for an online store

You do not have to create applications or sites from scratch as discussed in the SharePoint 2013 planning documentation. When you deploy the Microsoft Dynamics AX Retail online store, you deploy a starter store that includes pre-constructed web applications, sites, and services. You can then configure, customize, and rebrand the starter online store to meet your needs.

Search is the primary means by which customers find products in an online store. For this reason, you should also familiarize yourself with SharePoint 2013 search concepts.

We recommend that you familiarize yourself with concepts provided by the following links before you deploy the Microsoft Dynamics AX Retail online store.

Plan for cross-site publishing in SharePoint Server 2013

Overview of search in SharePoint Server 2013

Content Search Web Part in SharePoint 2013

Estimate capacity and performance for Web Content Management (SharePoint Server 2013)

Estimate capacity and performance for Managed Metadata Service (SharePoint Server 2013)

Internet Sites Search Architectures for SharePoint Server 2013

Learn about the architecture of the Microsoft Dynamics AX Retail online store

The Retail online store uses several components of the Microsoft Dynamics AX Retail suite to publish the channel and data to SharePoint 2013.

Architecture of the Microsoft Dynamics AX Retail online store

Retail online store publishing architecture

Learn about Commerce Data Exchange

Commerce Data Exchange is a system that transfers data between Microsoft Dynamics AX and retail channels, such as online stores or brick-and-mortar stores.

Commerce Data Exchange

Install

The Retail online store utilizes the data, components, and services of Microsoft Dynamics AX Retail components such as Retail Headquarters and a Retail channel database, as well as SharePoint 2013. You must install these other components and applications before you install the online store.

Task

Details

Topics

Prepare for installation

Before you install Microsoft Dynamics AX components, including Retail components, you should prepare the computers in your environment.

Pre-installation checklist

Configure SQL Server for the Retail databases

Install Microsoft Dynamics AX

The installation guide includes information about deployment planning, system requirements and specific instructions for installing Microsoft Dynamics AX features and components. We recommend that you install and configure the core components of Microsoft Dynamics AX before you install retail components.

Install Microsoft Dynamics AX 2012

Install Retail Headquarters

When you install Retail Headquarters by using Setup, you install the basic components to run Microsoft Dynamics AX Retail.

Install Retail Headquarters

Install and configure components of Commerce Data Exchange

Commerce Data Exchange is a system that transfers data between Microsoft Dynamics AX and retail channels.

At retail headquarters, you must install Commerce Data Exchange: Async Server and Commerce Data Exchange: Real-time Service.

For an online store, you must install an instance of Commerce Data Exchange: Async Client.

Install Commerce Data Exchange: Async Server

Install Commerce Data Exchange: Async Client

Specify working folders for Commerce Data Exchange

Install Commerce Data Exchange: Real-time Service (Retail Transaction Service)

Install a Retail channel database

Channel databases hold retail data for one or more retail channels, such as online stores or brick-and-mortar stores. The data for a channel can be included in more than one channel database.

Install a Retail channel database

Install and configure SharePoint Server 2013

You must install and configure SharePoint Server 2013 before you deploy the Microsoft Dynamics AX Retail online store.

Overview of SharePoint 2013 installation and configuration

Install SharePoint 2013 across multiple servers for a three-tier farm

Install the Retail online store

Microsoft Dynamics AX 2012 for Retail includes two Retail online “starter” stores. The Contoso store is modeled after a fictitious online electronics retailer. The Fabrikam store is modeled after a fictitious online clothing store. When you install the Retail online store by using Setup.exe or PowerShell, you specify which starter store to deploy in your environment. You can then customize and rebrand the starter store to meet your needs.

Install a Retail online store (e-commerce)

Extend

Microsoft Dynamics AX 2012 comes with several Retail online sample stores. This section outlines how you can customize the look and feel of a sample online store so that your store reflects the brand of your business, and how you can extend the functionality of the sample online store to meet your business needs.

JJ937972.collapse_all(en-us,AX.60).gifGetting started with Retail online sample stores

Task

Details

Topics

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

Demonstration virtual machines are pre-configured virtual machines with software and data to support business scenarios such as provisioning an online channel, creating and publishing online catalogs, and buying online for in-store pickup.

Microsoft Dynamics AX 2012 Solution Demos(To access this site, you must be enrolled in a service plan)

Familiarize yourself with the tools and procedures for developing with Retail online sample stores

When you work with a Retail online sample store, you can extend data in AX 2012, work with services and the commerce runtime (CRT), and extend or customize the user interface in SharePoint 2013.

Getting started with customizing the Retail online sample store

Learn about the different elements in a Retail online sample stores

The Retail online sample stores are content-driven web sites that authenticate users, capture user information, and enable customization by administrators and web developers.

Components of the Retail online sample store

Learn about the code behind the SharePoint site pages

The Retail online sample stores use the page framework in SharePoint 2013 to display products, enable customer login, and implement the shopping experience.

Overview of the SharePoint 2013 page model

Set up the development environment to debug your code in the Retail online store.

You use the source code in the Retail SDK as the basis for your customizations.

Debug code in a Retail online sample store

Debug X++ Code for Retail

Understand how the Retail online sample stores authenticate users.

The sample online stores use Windows authentication for system administrators and forms-based authentication for users.

Authenticating users in Retail online sample stores

Plan for user authentication methods in SharePoint 2013

Learn about using content search web parts in the sample stores.

The Retail online sample stores use SharePoint content search web parts to display products in the store catalogs.

Content Search Web Part in SharePoint 2013

Edit existing Web Parts in SharePoint 2013

Learn how to deploy your Retail online store customizations.

You customize the online sample stores by using SharePoint features and the Visual Studio source-code projects that are included in the Retail SDK. This topic describes how to deploy customizations in development, test, and production environments.

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

Walkthroughs with detailed steps to extend the Retail online sample store

These walkthroughs illustrate the process of adding a data field to the Retail online store. In this scenario, the retailer wants to enable customers to check a box on the Retail store site to indicate that they wish to receive email about special offers.

The walkthroughs demonstrate extending all the required components including the AX 2012 database, the CRT, data distribution, and the Retail online sample store site to include the field EmailOptIn that indicates customer preference in receiving email offers.

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

JJ937972.collapse_all(en-us,AX.60).gifDevelopment process

The following diagram shows the components of the online store you can customize: Microsoft Dynamics AX, commerce runtime (CRT), and Microsoft SharePoint.

Online store

The Retail Software Development Kit (SDK) is a super set of the online store binaries. It provides you with additional tools and source code that you can customize to fit the needs of your business. For more information about the contents of the Retail SDK, see Retail SDK.

In a typical development process, you would perform the following steps:

  1. Install the Retail SDK and deployment packages on a stand-alone server

  2. Gather version number and strong name key for source code signing

  3. Update the source code to use the strong name certificate

  4. Configure the topology according to the development or test environment

  5. Customize the online store in Visual Studio

  6. Deploy your customized online store to a development or test environment

  7. Verify your customizations

  8. If needed, go back to step 5

  9. Copy the online store deployment packages from the development or test environment to your production environment

  10. Configure the topology on your production environment

  11. Deploy your production environment

  12. Verify your production environment

For more information about the deployment steps, see Online Store.

The following sections describe the customizations you can perform in Microsoft Dynamics AX, Commerce Runtime (CRT), and SharePoint Microsoft.

JJ937972.collapse_all(en-us,AX.60).gifExtend commerce runtime

The commerce runtime is a set of assemblies that enables your store to obtain interactive data based on a shopping cart. The commerce runtime includes several services that query for real-time data. It also includes workflow business logic that enforces rules for your store.

Task

Details

Topics

Customize data in a commerce entity

The CommerceEntity class is a property bag of key value pairs of C# properties. These properties provide string representations of fields from the database so that you do not need to remember the names of columns in your database when you write code. For any existing data type, if you add one or more new fields to a table in Microsoft Dynamics AX, the commerce entity automatically includes those fields as long as you make changes to the stored procedure or view to return the additional field.

Customize the Data in a Commerce Entity

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

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

Customize services

Microsoft Dynamics AX offers many services in the commerce runtime that support the basic functionality of an online store. If one of these services does not meet the needs of your store, you can replace it with your own service and continue to use the other services that are installed with the commerce runtime.

Services Overview for Commerce Runtime

Integrate a Service into the Commerce Runtime

Walkthrough: Integrating a new Shipping Service

Customize workflow

The commerce runtime includes workflow business logic that enforces rules for your business. You can use the workflows that are included in commerce runtime or create your own.

Create Commerce Runtime Workflows

Use the API

You can use the API for things like getting information about items, price calculation, shipping calculation, and placing orders. You can extend the API to fit your business processes.

.NET Framework Classes for Microsoft Dynamics AX Commerce Runtime

Deploy your commerce runtime customizations

After you customize the functionality of your store in the commerce runtime, use the GAC utility to copy your new DLLs to your solution. Then deploy your online store to a test or production environment.

Install a Retail online store (e-commerce)

JJ937972.collapse_all(en-us,AX.60).gifExtend SharePoint

The user interface for the online starter store is based on Microsoft SharePoint Server 2013. You can customize the visual design of the starter store by modifying certain types of files. For example, you can change the store logo by modifying master pages, or you can change the background color of store pages by making modifications to cascading style sheet (CSS) files.

Task

Details

Topics

Learn about the design and operation of the Retail online sample stores

Get started with customizing the Retail online sample stores by understanding the technologies involved in the functionality, appearance, and security settings of the sites.

Getting started with customizing the Retail online sample store

Set up a SharePoint development environment

You use SharePoint Server 2013 and Microsoft Visual Studio to customize the user interface for the online sample stores.

SharePoint 2013 development overview

Set up the development environment for SharePoint 2013

Develop the site design in SharePoint 2013

Build sites for SharePoint 2013

Map a network drive to the SharePoint 2013 files for online stores

Create a new web part

You can create new Web parts that allow users to directly modify content, appearance, and behavior of SharePoint Server 2013 site pages.

In the properties for your SharePoint Server 2013 Web Part project, set the Site URL to resemble the following:

http://<computer>:40003/sites/RetailPublishingPortal

For more information, see Creating Web Parts for SharePoint.

Walkthrough: Creating a Web Part for SharePoint

Customize master pages

Master pages define the shared framing elements – the chrome – for all pages in the online store. You can impact the look and feel of your store by customizing master pages with your logo and design.

Overview of the SharePoint 2013 page model

Customize master pages

How to: Apply a master page to a site in SharePoint Server 2013

Customize page layouts

Page layouts contain the page contents and its layout. Each page layout uses a specific master page and can act as a base page for multiple instances of the page layout. Each instance has a different page name. In the starter store, each page has a corresponding page layout. For example, Welcome.aspx has a corresponding file, WelcomeLayout.aspx.

Customize page layouts

How to: Create a page layout in SharePoint Server 2013

Customize display templates

Display templates control how products are displayed in the pages of an online store. This walkthrough illustrates customizing product display by comparing the SharePoint pages in the user interface in the Contoso and Fabrikam sample online stores.

Walkthrough: Changing how products are displayed in the Contoso Retail online sample store

Customize the Cascading Style Sheets (CSS) of an online store

You can customize the appearance and behavior of site pages by customizing the CSS files that are included in the Retail SDK for the Retail online sample stores.

Customize the appearance and behavior of site pages

Cascading style sheet (CSS) files for Retail online store

Walkthrough: Creating and Modifying a CSS File

Utilize JavaScript

JavaScript files provide the page layouts with client-side scripting functionality.

Customize device channels

You can customize the sample sites to use different styles based on device channels. The Contoso site includes a master page for displaying the site on a mobile device.

SharePoint 2013 Design Manager device channels

Maintain online channels

You can use the online channel tools to:

  • Clean up an online channel.

  • Update the channel record ID or operating unit number for the SharePoint web application, web site, and publishing job.

  • Configure the publishing job.

Microsoft Dynamics AX for Retail online channel tools

Configure

The topics listed in the following table help you configure Microsoft Dynamics AX Retail components and the Retail online store in the Microsoft Dynamics AX client.

JJ937972.collapse_all(en-us,AX.60).gifConfigure an online store in Microsoft Dynamics AX

Task

Details

Topics

Configure Retail components

Set up and maintain information for retail operations. This information includes stores, taxes, products, gift cards, promotions, and discounts.

Setting up and maintaining Retail

Configure retail channel navigation hierarchy

Create a retail channel navigation category hierarchy to set up a category structure for products that you offer through an online store. You define the category hierarchy and assign products, product attribute groups, and attribute values to the categories. Then assign the category hierarchy to an online store.

Set up a retail hierarchy

Set up attributes and attribute types

Set up retail attribute groups

Add online store to the organization hierarchy

Before you can assign product assortments or fulfill orders for the online store that you created, or generate reports that include information from it, you must assign the store to one or more organization hierarchies. At a minimum, you must assign the online store to an organization hierarchy that includes product assortments.

Set up an online store

Add modes of delivery to the online store

Select the delivery methods that are offered by the online store.

Set up an online store

Map attributes and add metadata

Select the options that indicate how the attributes for each category or channel product should behave in the online store on the SharePoint site.

Set up an online store

JJ937972.collapse_all(en-us,AX.60).gifConfigure online store products in Microsoft Dynamics AX

Task

Details

Topics

Add assortments to the online store

Add the assortments that include the products that you offer in an online store.

Set up an online store

Manage catalogs

Use product catalogs to identify the products that you want to offer in your stores.

Key tasks: Create retail product catalogs

Manage prices

Set up and use price groups, which are the central link between prices and discounts, and channels, catalogs, affiliations, and loyalty programs.

Setting up prices using price groups

Setting up taxes

Manage discounts

Set up and manage price adjustments and four different kinds of discounts.

Setting up price adjustments and discounts

Manage shipping charges

Set up and manage the shipping charges that are specific to the online store.

Set up shipping charges for online stores

Manage modes of delivery

Manage the modes of delivery that are offered by the online store.

Set up modes of delivery

JJ937972.collapse_all(en-us,AX.60).gifSet up data exchange between Microsoft Dynamics AX and the online store

Task

Details

Topics

Set up channel integration profiles

Profiles enable the components of Retail to communicate with each other. Set up profiles before you configure data exchange settings.

Set up a profile for Async Server (AX 2012 R3 only)

Set up a Real-time Service profile

Set up a channel profile

Set up a profile for Synch Service (AX 2012 R2 and AX 2012 Feature Pack only)

Set up a channel database profile (AX 2012 R3 only)

Set up a store database profile (AX 2012 R2 and AX 2012 Feature Pack only)

Set up an AOS profile (AX 2012 R2 and AX 2012 Feature Pack only)

Configure data distribution and scheduling.

In AX 2012 R3, a channel data group is a group of one or more retail channel databases. A data package is generated for each data group. All channel databases in a data group subscribe to the same data.

In AX 2012 R2 and AX 2012 Feature Pack, a distribution location is a record that links a store to the database. Distribution locations represent the destinations of distributed data. A distribution location list is a group of distribution locations. For example, you can set up a distribution location list per region or per time zone.

Scheduler jobs are the mechanism for distributing data to and from stores. Jobs are made up of subjobs, which specify how to distribute the data in selected tables and selected table fields.

In AX 2012 R3:

Create a channel data group

Configure jobs and subjobs in Retail Scheduler

In AX 2012 R2 and AX 2012 Feature Pack:

Create distribution locations for retail databases

Set up a distribution location list

Configure jobs and subjobs in Retail Scheduler

Send configuration settings and data to the stores

After online store settings and data exchange settings have been configured in Microsoft Dynamics AX, run jobs to distribute data to the online store database.

In AX 2012 R3:

Synchronize all data for the channel database. In the Channel database form, click Full data sync and then select the distribution schedule that is named Full sync.

In AX 2012 R2 and AX 2012 Feature Pack:

When you set up a new store database, you must run all A jobs for that location. In addition, run the following N jobs:

  • N-1000 – Currency

  • N-1010 – Customer

  • N-1030 – Reason code information, if reason codes are used

  • N-1050 – Loyalty, if loyalty discounts are given

  • N-1080 – Tax

  • N-1100 – Item and price parameters

  • N-1110 – Global configuration

  • N-1115 – Global address book reference data

To avoid sending all data to all locations, you can temporarily modify the distribution schedule for the job, so that the data is sent only to the new location.

Schedule and run jobs in Retail Scheduler