Home
User Guide
The information contained in this section applies to WebSphere Commerce Version 8. The documentation also applies to all subsequent releases and modifications until otherwise indicated in a newer section.WebSphere Commerce is a single, unified e-commerce platform that offers the ability to do business directly with consumers (B2C), directly with businesses (B2B), and indirectly through channel partners (indirect business models). WebSphere Commerce is designed to be a customizable, scalable, and high availability solution that is built to leverage open standards. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels.
Samples
Aurora starter store
The Aurora starter store showcases the latest in storefront features, and models best practices in store development, demonstrating a wide scope of retail scenarios. Simplify your responsive B2C or B2B direct web store implementation and reduce your time-to-market by using the Aurora starter store as your development base.
My Account flows
The My Account flows describe pages your customers use to register with the online store and maintain their account with the store. The My Account pages include the account summary, personal information, address book, personal wish lists, coupons, orders, order details, and browsing history. Certain pages are optional and are available to customers only if your store chooses those functions.
Sign In/Register page and panel
The Aurora starter store provides multiple layouts for the Sign In/Register page and panel.
B2C
In the responsive Sign In/Register panel, registered customers for a B2C store can sign in to the store. Customers can access the panel from a link in the store header. From the Sign In / Register panel, guest customers can access the Registration page and register themselves with the store.

User Guide
The information contained in this section applies to WebSphere Commerce Version 8. The documentation also applies to all subsequent releases and modifications until otherwise indicated in a newer section.WebSphere Commerce is a single, unified e-commerce platform that offers the ability to do business directly with consumers (B2C), directly with businesses (B2B), and indirectly through channel partners (indirect business models). WebSphere Commerce is designed to be a customizable, scalable, and high availability solution that is built to leverage open standards. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels.
- Planning
  Creating a custom implementation of a WebSphere Commerce store requires a significant amount of planning. From gathering client needs, to deploying the live solution, much work is needed to successfully deploy a custom client store. Use the resources in here to help you plan every phase of store creation.
- Installing
  Review the following sections for information about installing the WebSphere Commerce product, associated maintenance, and WebSphere Commerce enhancements.
- Migrating
  Before you migrate to WebSphere Commerce Version 8.0, review this information to help plan and execute your migration.
- Deploying
  The topics in this section describe how to publish stores to either a test or production environment, and how to deploy customized code.
- Operating
- Integrating
  Topics in the Integrating category highlight the tasks that are commonly performed for using WebSphere Commerce in combination with other products.
- Administering
- Tutorials
  WebSphere Commerce provides many tutorials to help you customize and understand your WebSphere Commerce instance and stores.
- Samples
  - Aurora starter store
    The Aurora starter store showcases the latest in storefront features, and models best practices in store development, demonstrating a wide scope of retail scenarios. Simplify your responsive B2C or B2B direct web store implementation and reduce your time-to-market by using the Aurora starter store as your development base.
    - Site level features
      Using site level features, you can customize the look and feel of your storefront. Site level features are visible from every page in your store.
    - Category level features
      Category level pages in the Aurora starter store are designed to assist customers in narrowing the product selection to find the preferred item.
    - Product level features
      Product level features in the Aurora starter store are designed to provide details about a specific product in your store.
    - Aurora as a B2B direct starter store
      You can publish the Aurora starter store as a B2B direct store and take advantage of features that are offered by the Aurora starter store plus extra B2B capabilities. Get your B2B e-commerce site up and running faster at a lower cost by using the Aurora starter store as your starting point. With B2B-optimized features built right into the storefront, you can minimize the amount of customization that is required to provide an optimal shopping experience to your business customers.
    - Publishing the Aurora starter store
      The Aurora starter store can be used only as a storefront asset store in the Extended Sites business model. It is not possible to deploy Aurora as a stand-alone B2B or B2C store. The Aurora.sar archive contains the organization structure, predefined user roles, and access control policies necessary to create either a B2C storefront asset store or a B2B storefront asset store.
    - jQuery Aurora starter store
      The Aurora starter store in WebSphere Commerce is completely written in jQuery 3.1.0, which is one of the most commonly used JavaScript libraries used in dynamic websites. The jQuery AJAX and events API provides an easy to use framework that meets most AJAX requirements for storefront development.
    - Aurora starter store functions
      For the Aurora starter store, you can select certain functions to include in your store and disable the ones that you do not need. Use the Store Management tool in Management Center to control which functions are enabled for your store.
    - Accessibility
      The Aurora starter store follows the IBM accessibility guidelines to implement accessibility features. Accessibility features help users who have a physical disability, such as a visual impairment, hearing impairment, or limited mobility, successfully use the store.
    - Search features
      WebSphere Commerce comes with a powerful and fully integrated search function. The search functions in WebSphere Commerce provide an enriched customer experience, with features such as automatic search term suggestions and spelling correction. Since it is built on open standards, WebSphere Commerce Search is highly flexible and extensible. Starter stores can use the search engine's most sophisticated features without requiring extra customization. A key feature of Search is that sales personnel can create and manage search term associations, and search-based merchandising rules, from within the Management Center and Store view.
    - Responsive Web Design (RWD)
      Responsive Web Design (RWD) is a web design approach that is aimed at crafting pages that are optimized for a wide range of devices. It advocates the use of primarily fluid layouts and media queries to optimize a site for different devices, instead of designing a separate site for each device.
    - Aurora starter store companion assets
      The IBM Starter Store Companion Assets are a customizable set of resources that are designed to reduce the overall cost of implementation. You can use the assets to understand, customize, test, and develop your store that is based on the starter store.
    - Replacing an existing store with Aurora
      Usually, new features that are introduced in feature pack releases require storefront changes. These changes can be in the form of data model changes, or modifications to the storefront JSP files to use new or updated APIs. For this reason, moving to the latest starter store is the easiest way to have newer components work on your existing store. Depending on the age and design of your site, this retrofitting can be done through several different approaches. If your site is relatively up-to-date, and you are interested in a particular feature, then you can find the migration steps for that solution or component and apply them to your store. Alternatively, you can attempt to replace the entire store with the Aurora starter store by following this set of high-level instructions.
    - Upgrading your store assets
      For existing WebSphere Commerce customers who are looking to upgrade to the next release, there are a number of approaches that you can take to upgrade your store. Review your requirements, and chose the proper path to upgrade your store assets to take advantage of the supplied features in the Aurora starter store.
    - WebSphere Commerce Dojo Enhancements API
      WebSphere Commerce extends the Dojo AJAX and events API, providing an easy to use framework that meets most AJAX requirements for storefront development.
    - Developing Aurora starter store pages
      Developing and maintaining store pages can become an efficient and consistent process by following the general practices that are used in existing Aurora starter store pages.
    - Site flows and interactions
      The site flows provide a screen capture and a detailed description for each store page. Store developers can use the site flows as a high-level guideline for each page to identify starting points when store pages are changed.
    - Checkout flows
      Checkout flows describe pages that your customers use to complete the checkout process.
    - Site flows
      The site flows provide a screen capture and description for each store page that includes Apple Pay on the Web functions.
    - My Account flows
      The My Account flows describe pages your customers use to register with the online store and maintain their account with the store. The My Account pages include the account summary, personal information, address book, personal wish lists, coupons, orders, order details, and browsing history. Certain pages are optional and are available to customers only if your store chooses those functions.
      - Sign In/Register page and panel
        The Aurora starter store provides multiple layouts for the Sign In/Register page and panel.
        B2C
        In the responsive Sign In/Register panel, registered customers for a B2C store can sign in to the store. Customers can access the panel from a link in the store header. From the Sign In / Register panel, guest customers can access the Registration page and register themselves with the store.
        B2B
        In the responsive Sign In/Register panel, registered buyers for a B2B direct store can sign in to the store. Potential buyers can access the Registration page and register themselves or their organization with the store.
      - Registration page
        The Aurora starter store provides multiple layouts for the Registration page.
      - Forgot Password, Enter Validation Code, and Change Password pages
        The Forgot Password page is where registered customers can request for a new password from the store. A validation code is generated and is sent to the email address that was used during registration. The Change Password page appears when registered customers sign in but their password expired.
      - Resend Activation email page (B2C)
        The Resend Activation email page is for customers who do not receive their account activation email after registration. Here they can request for a new email to be sent to the specified email address.
      - My Account Summary page
        The My Account Summary page is where registered customers can view their personal details and a summary of their activities on the storefront. Customers can also edit the information that they have specified in the Personal information page and view and reorder their past orders.
      - Address Book page
        The Address Book page is where registered customers can update their shipping and billing addresses. Customers may add an address, or remove an existing address from the address book.
      - Add Address page
        The Add Address page is where registered customers can save new addresses to their address book. Customers can specify multiple addresses and mark each address as a shipping address, or a billing address, or both.
      - Personal Information page
        The Personal Information page is where registered customers can update their personal details and account preferences.
      - Personal Wish List page
        The Personal Wish List page is where registered customers can view their wish lists. Each customer has a default wish list named Wish List, but they can create alternative wish lists with different names, such as Birthday wish list. Customers can also send an email to friends and family that contains a link to their wish list.
      - Quick Checkout Profile Page
        The Quick checkout profile page allows registered shoppers to predefine a separate billing address and shipping address. When the profile is completed, shoppers can use the quick checkout feature that auto-populates the billing and shipping addresses when you check out.
      - Order History page
        The Aurora starter store provides multiple layouts for the Order History page.
      - Recurring Orders page
        The recurring orders page displays the recurring orders of a shopper with the store in a table. The table shows the following details about the orders: Order number, order frequency, next order date, order status, and total price.
      - Recurring order details page
        The recurring order details page displays all the information that is related to a previously placed recurring order and its child orders. In the order details page, the information is broken down into four sections: Order details, shipping information, recurring order details and billing information. The order details section contains the recurring order number and date. The shipping information section contains the shipping address and method. It also contains the products included in the shipment, including the product picture, name, quantity, and price. The recurring order details section displays the order frequency, start date, and the next scheduled delivery. The billing information section contains the payment number, billing address, and billing method. The Print button formats a printable version of the current page.
      - Subscriptions page
      - Subscriptions details page
        The subscription details page displays all the information that is related to a previously ordered subscription and its child subscription. In the subscription details tab, the information is broken down into three sections: Subscription details, shipping information, and billing information. The subscription details section contains the order number, order date, and expiry date. The shipping information section contains the shipping address and method. It also contains the subscription product picture, name, quantity, and price. The billing information section contains the payment number, and billing address and method. The Print button formats a printable version of the Subscription Details page.
      - Order Details page
        The Order Details page is where registered customers can view detailed information for previously placed orders. Customers navigate to the Order Details page from the Order History page when they are signed in to their account.
      - The My Coupons page
        The My Coupons page displays the coupon wallet, which lists the coupons that registered customers have received from your store. Customers can view the details of a coupon or remove a coupon from the coupon wallet.
      - Requisition Lists page (B2B)
        In this page, customers can view a list of their current requisition lists, create a requisition list, and upload a requisition list from a file. Customers can click any list to view the items it contains, and they can add the requisition list items to their current order. A requisition list is a reusable list of items (SKUs) that customers can use to create orders.
      - Requisition Lists Log Details page (B2B)
        After customers upload a requisition list, they can view details about whether the requisition list uploaded successfully or not. If certain SKUs did not upload successfully, the page lists the SKUs and their line numbers in the file. Customers can use this information to correct the CSV file and then try uploading the file again. A new requisition list is created each time that the customer uploads a file, even if the file is a corrected version of a previously uploaded file.
      - Requisition List Details page (B2B)
        Customers can view and manage the items (SKUs) in an existing requisition list. Customers can add or remove items from the list, and change the quantity of items. They can also add an item from the requisition list to their current order, or add the entire requisition list to their current order.
      - Saved Orders page
        Customers can view a list of their current order and their saved orders. From the list, customers can access an action menu to view, duplicate, or delete the order, add the order to a requisition list, or set a saved order as a current order.
      - Saved Order Details page
        Customers can view details of any saved order, including the order name and number, last updated date, order total, and the items (SKUs) in the saved order. From Saved Order Details page, customers can edit the order name, add SKUs to the order, and set the order as the current order and proceed to the checkout flow to place the order.
    - IBM Customer Service for WebSphere Commerce
      IBM Customer Service for WebSphere Commerce provides customer service enhancements that enable a customer service representative (CSR) to resolve common issues and capture orders. These capabilities are built into the WebSphere Commerce Aurora storefront and enable a CSR to complete key tasks on behalf of a guest and registered customers for both B2B and B2C stores. Customer Service for WebSphere Commerce is offered for both Professional and Enterprise editions.
    - Additional flows
      The Additional flows describe the supplementary pages that are required to maintain your online store.
    - Organization and buyer administration flows (B2B)
      In the B2B direct business model, each company that purchases from your store must have one or more registered users who are assigned the Buyer Administrator role. Buyer Administrators administer the company's organizations, and they manage the company's buyers, including assigning roles and approving new buyers who register. The Aurora starter store provides a series of self-serve pages for Buyer Administrators to do their work directly in the storefront, rather than using the Organization Administration Console.
    - Order approval flows
      During organization setup, order approvals and contracts can be configured to set the criteria that determines which orders require approval. When order approvals are enabled, a Buyer Approver or Buyer Administrator must approve orders that exceed the order total limit that is specified in the contract before orders are submitted for processing. The Aurora starter store contains pages in which Buyer Approvers and Buyer Administrators can view and manage order approvals.
    - Buy-on-behalf-of flows
      The buy-on-behalf-of feature allows a Buyer Administrator to shop on behalf of a buyer in the same organization. After signing in to buy on behalf of a specific buyer, the Buyer Administrator sees the store exactly the way that buyer would see the store. The Buyer Administrator can then lock an order and proceed to create, modify, or view the buyer's information such as saved orders, order history, and requisition lists. When an order is locked, a symbol appears beside the order number.
    - Enabling punch-out payment
      You can enable punch-out payment in starter stores. Punch-out payment is a payment model where a third-party payment service provider processes payments for orders.
    - Facebook integration
      Use the power of the world's biggest social media community to spread the word on products or your store with embedded Facebook Like or Send/Share buttons.
    - Apple Pay on the Web integration
      Apple Pay on the Web integration with WebSphere Commerce provides you with an easy and secure way to accept and process payments. Apple Pay on the Web enables customers to purchase products in the Aurora starter store with a single touch in Safari on Mac, iPhone, and iPad.
    - Testing the WebSphere Commerce and Sterling Configurator integration
      After you install and configure the software components for the WebSphere Commerce and Sterling Configurator integration, test the integration with sample data and sample procedures.
    - Testing your store
      WebSphere Commerce provides a test assets package that contains documentation and tools to help introduce, plan, and run Functional Verification Testing (FVT) for your store.
  - Extended sites starter store
    Use an extended sites starter store to get started on setting up an extended sites solution that will allow your selling organization to provide unique storefronts for different enterprise customers or showcase a number of branded storefronts.
  - Sample stores
    A sample store is for learning purposes and some tutorials can use a sample store. Do not use a sample store as the base for building your site. Sample stores might not be accessible or translated.
- Developing
  The topics in the Developing section describe tasks performed by an application developer.
- Compliance
  The following section describes how you can leverage WebSphere Commerce features and functionality to help your site be compliant with different privacy and security standards.
- Securing
  These topics describe the security features of WebSphere Commerce and how to configure these features.
- Performance
- Troubleshooting

Consumer direct (B2C)

Sign In/Register panel

In the responsive Sign In/Register panel, registered customers for a B2C store can sign in to the store. Customers can access the panel from a link in the store header. From the Sign In / Register panel, guest customers can access the Registration page and register themselves with the store.

The Sign In/Register panel overlays the page that the customer is viewing, rather than opening in a new page. As a result, the shopping session is not disrupted if the customer wants to open the panel and sign in or out at any time.

The Sign In/Register panel does not replace the Sign In/Register page, which is still displayed when the customer's shopping session times out.

Elements of the Sign In/Register panel

The Sign In/Register panel has several states.

Sign In panel screen capture — Figure 1. Sign In/Register panel: initial state before the customer signs in.

Sign In panel screen capture — Figure 2. Sign In/Register panel: state after customer is signed in

Optional functions on this page

The following function can be enabled or disabled for the Aurora starter store by using the Store Management tool in Management Center. For more information, see Selecting store functions.

4 Account activation by email: Sends an account activation email to customers when they register. The customer must click a link in the email to activate the account.

JSP files

The layout of this panel is built with a widget that uses the Commerce Composer framework to retrieve and display content. However, this panel is not managed in the Commerce Composer tool, and the widget that is used in the panel is not available to Management Center users in the Commerce Composer tool.

GlobalLogin.jsp is the top-level JSP file for the Global Login widget, which displays the Sign In/Register panel content.

Links and buttons

1 Sign In: If the customer enters a valid login ID and password, the customer is signed in to the store.
2 Register: Opens the Registration page.
3 Forgot password?: Opens the Forgot Password page, in which the customer can request a validation code to get access to the store again.
4 Did not receive activation email?: Opens the Resend activation e-mail page in which customers can request to have their activation email resent.
5 Sign Out: Signs the customer out of the store.