Navigating the SAP Commerce Cloud Backoffice User Interface

Objective

After completing this lesson, you will be able to identify and explain the purpose of key areas within the SAP Commerce Cloud Backoffice user interface, including the toolbar elements of the Administration Cockpit.

Introduction

​Backoffice is the primary business user interface (UI) in SAP Commerce Cloud. It’s a configurable, role-based UI where you manage your data and processes (products, content, customers, orders, workflows, cron jobs, etc.). ​

In this course, we will focus on the Backoffice Administrator role. Backoffice Administrators like Alex (see image below) are business users who usually work in the Backoffice Administration Cockpit. They configure access rights, ensure proper data validation, set up and manage workflows, such as the product approval workflow, and more.

Photo, showing Backoffice Administrator Alex at her desk.

In this lesson, we will focus on the structure of the Administration cockpit.

Note

​How you can access Backoffice, depends on your company’s setup. Usually, your system administrator will share with you a URL that you can bookmark.

Adminstration Cockpit Structure

​Here are the elements of the administration cockpit:

  1. Top Toolbar: This area usually contains global actions applicable across the entire Backoffice: The cockpit selector, a button to view current or completed processes, such as catalog synchronizations, and a silhouette button you can use to update your profile settings. However, the highly customizable nature of Backoffice means that its appearance and functionality may differ for each site, and even for each user. In the diagram below, we first see the most common global actions you will find in the top toolbar. But the second example shows additional functionality, as that user has access to the collaboration center, and has more than one role in the U.I. The header bar in the Administration cockpit features a hamburger icon to expand/contract the left hand menu, a cockpit selector, and the following icons: user role chooser, processes, collaboration center, and user settings
  2. Explorer Tree (left-hand pane): In the Administration Cockpit, this area displays a hierarchical tree view of the cockpit's functionalities available to you depending on your login credentials. For instance, you might be able to view and edit catalogs, but not create or modify employee login accounts.

    Functional areas include product management, order fulfillment, customer support, and administration, to name only a few.

    The list of functionalities is displayed hierarchically; sections with sub-elements are denoted by a caret on the right of the name; click on this caret to see the sub-elements, which can be functional pages or further nested sections.

    Another way to find the functionality you need is to type a search string in the filter box. The fully qualified path of every functionality containing that string will be shown and can be selected.

    The explorer tree shows a column of sections. Clicking on one, Catalog, shows the sub-pages Catalogs, Catalog Versions, and Categories. Entering the text ‘categories’ in the search box shows the complete location of all sections and pages containing that word.
  3. Common Controls: Most functional pages in the Administration Cockpit are structured in a similar manner. Consider the Categories page. It displays a list of categories, showing each category’s identifier, name, synchronization status, and catalog version. You can customize which columns are shown by clicking on the Personalization button. ​This icon is the rightmost of a row places at the top of the categories list. Some of these buttons may be grayed out, and thus not clickable, when no items are selected. One of them, the compare icon, requires that at least two items be selected. ​The first button, a large plus sign (+), is used to create a new category, and launches a creation wizard. In SAP Commerce, many data object types, such as category, have subtypes with additional attributes. The caret next to the plus sign allows you to create one of these subtypes instead. ​Past the next four icons, which are inactive until you select at least one item in the list, we can see a button to export category items as Excel files for edit, and another to import category items, often those same items you exported and then modified. Finally, the last icon, which resembles a gear, is used to select the columns that appear in the list view. The top of the Categories page features buttons to: Create a new category, create a category subtype, export to excel, import from excel, and personalize columns. Some buttons are grayed out because they’re not relevant in the current context.

    Finally, ​the following buttons become active when one item is selected:

    • Delete the selected item
    • Synchronize the selected item from the Staging to the Online catalog version

    When more than one item is selected, the sync icon becomes inactive and the compare button becomes available. It allows you to compare the attribute values of multiple items.

    The Bulk edit icon can be used to make the same change to multiple items. While it is active when a single item is selected, it’s only really useful when multiple items are selected.

    The top of the categories page shows the Delete selected item and Synchronize selected item buttons when a single item is selected in the categories list. When multiple items are selected, the Compare items and Bulk edit buttons become active.
  4. Searching for items: To the right of the common controls, a search box allows you to look for the items you are interested in. The search box looks for strings in the identifier and name fields only. If you wish to look for values in other attributes, click the Switch search modes button, which brings up a larger pane where you can look for values in specific attributes. Both the simple and advanced searches offer a save button, which will allow you to save the search to the Saved Searches pane at the bottom left of the browser window. ​At the right of these two icons, the link button provides you with links to Backoffice and to this specific page, in this case the Categories page. The category search box can be used to search the Identifier and Name fields only. A filter button gives access to a more detailed search environment, where any property of the category item type can be specified to narrow down the results. It is also possible to copy a link to the current page.
  5. Editing pane: When you select an item, the main area splits in two. The top half shows the list, while the bottom half shows the attributes of the item you just clicked on. These attributes are divided across tabs to make management easier. Each item type may offer different tabs, but you will always see the Administration tab on the right, which contains all the attributes not explicitly configured to appear in another tab. ​After making changes, you can either revert to the already-saved state of the item by clicking Refresh, which cancels any edits you have made. Otherwise, click Save to write your changes to the database. ​Each half of the main area has a minimize button. Click the one on the top half (the category list) and the editor takes the entire page, giving you more room to work. ​Some properties are marked as required, symbolized by a red asterisk next to their name. The validation system will prevent you from saving your changes if any required property is left blank. ​Some properties are multi-lingual. The UI denotes this with a globe icon next to the property value. Click the globe icon to see the values in other languages.
A button at the top right of the Categories list allows the upper half of the page to be minimized. In the lower half of the page, we see a list of tabs (General, Category Structure, Multimedia, and Administration). Buttons are provided to cancel or save changes to the item.
Editing page for a single category. A button at the right can restore the upper half of the page containing the list of categories. In the editor, a globe icon allows the user to enter or view the values of the Name property in English, Japanese, German, and Chinese.

​The multi-lingual Name property is an example of a text property. But other properties, such as the Catalog Version property, are references to other database objects. Hovering over such a property value displays an x at the right of the field, which allows you to delete the object reference. ​You may then select another value from the list that appears when you click in the empty field. If there are too many choices, click on the ellipse to bring up a search dialog window.

Hovering over a reference field brings up an X button to delete the reference. Once deleted, the reference box displays an ellipsis icon that brings up a Reference Search dialog, used to find the correct reference item.

​Let’s take a moment to revisit what you’ve just learned and see it in action. The following video demonstrates how you might use the Administration Cockpit to carry out daily tasks. ​

Summary

  • SAP Commerce Cloud Backoffice provides a role-based, single tool for managing an online store.

  • The interface offers different functionalities and layouts to support different roles, and their associated tasks.

  • The explorer tree gives each user access to the tools they need. It can be searched or navigated to find the UI supporting a particular task or data type.

  • Backoffice supports multiple roles, strong security features, and validation processes.

  • The framework is extensible, allowing for custom development and runtime deployment of changes.