Document Properties
Last Modified
Added to KB
Public Access
Doc Type
  • ICM 7.10
  • ICM 11
Concept - Dashboard


A dashboard is a configurable entry point into a system. It has to provide easy-to-read information and key performance indicators of the system.

The dashboard can be configured by the creator of the dashboard (=owner) by placing widgets on it. This enables the user to create an overview over the system for his personal needs, i.e., a business manager can create, e.g.,  an overview of order numbers while somebody managing product data can create a dashboard holding the results of the last product validation.

The present concept is primarily addressed to business users who work with the ıntershop Commerce Management application.


DashboardA Dashboard is a container for widgets. It is represented by a single page, that provides a good overview and/or a good entry point into the system.
WidgetWidgets can be added to a dashboard and provide a quick access to information.
WidgetTypeA WidgetType is a container that provides a defined set of functionality and/or information, that will be displayed in a widget instance. WidgetTypes can be defined to be configurable. In that cases the user can configure parameters that are proceeded by a widget instance.


Dashboard Management

The dashboard feature brings along two new objects: dashboards and widgets.

Dashboards are written to the persistence layer and are also provided as a business object. Those business objects are handled by a dashboard repository, which is an extension of the user business object. This ensures that only the owner of a dashboard can see, edit or delete the dashboard and the dashboard content. Since the main goal of a dashboard is to access information fast and easy, a link to dashboards is available in the global menu bar, and therefore, a user's dashboards are accessible from everywhere in the commerce management application.


To customize a dashboard, widgets need to be added. A widget is an instance of a certain WidgetType. Those WidgetTypes are defined in *.component files, determine amongst others the default displayname and content of the widgets and can be found in the widgetTypeRegistry which is attached to all applications.

If added to a dashboard, a widget is available as a WidgetBO, which can be accessed via the DashboardBO. The added widget is also persisted in the database and linked to the dashboard. It is up to the user how many widgets are added to the dashboard, widgets of a certain widgetType can be added multiple times.

If a WidgetBO is of a WidgetType that is not available in the system anymore, a PlaceholderWidgetType is used instead. This PlaceholderWidgetType is always available and notifies the user, that the original WidgetType cannot be found anymore.

The WidgetType provides an URI that displays its content. It can refer to an external URL or to an internal view pipeline which have access to configuration values of the WidgetType.

By using property groups WidgetTypes are easily configurable using Java interfaces without further creation of code artifacts to manipulate the values. An appropiate user interface is provided by each widget to the user. Entered values are stored on each WidgetBO. Furthermore,

WidgetTypes can be categorized to provide a better overview over all existing WidgetTypes.

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to if you experience login issues,
or if you want to register as customer.