Updated: November 5, 2020

Notifications

Intro

Notifications are the best way to make users aware of a situation that requires timely action or attention. This could be a situation that has just arisen or a task triggered by a workflow or by SAP CoPilot.

Users access notifications by clicking the bell icon in the shell bar at the top right of the screen.

In the notifications popover, the user can order notifications in various ways, take action, and navigate to the source of a specific notification.

Usage

  • Use notifications to make users aware of situations that require attention.
  • Reduce the amount on informations and actions to its minimum, but provide enough informations to decide weather it´s important or not
  • Notification list items and notification list groups must only be used in the SAP Fiori notifications popover.

Responsiveness

Notifications are fully responsive. For smaller screens, the actions wrap underneath the item and remain accessible on mobile devices.

Users can access truncated text by pressing a Show More button that expands the item. Nevertheless, we recommend avoiding truncation when an item is displayed on a desktop device.

Size S
Size S
Size XL
Size XL

Types

You can show individual notification list items, or aggregate similar items in notification list groups.

Properties for notification list items:

  1. Headline*
  2.  Operation*
  3. Actions
  4. Subtitle
  5. Author/source1
  6. Show truncated text
  7. Timestamp*
  8. Priority*
  9. Image
Schematic visualization of notification item
Schematic visualization of notification item

Properties for notification list groups:

  1. Headline*
  2. Bulk operations*
  3. Bulk actions
  4. Image
  5. Author/source1
  6. Expand groups
  7. Timestamp*
  8. Group priority*
  9. Group item counter*
Schematic visualization of notification group
Schematic visualization of notification group

* Mandatory properties
1 The properties “Author” and “Source” are currently not available. They are enabled by SAPUI5 but are not supported by the SAP Fiori launchpad.

Components

Notification List

Items are added to the list based on internal events within apps or systems. The list can display various types of notifications, which can differ in terms of appearance, content, and functionality. The list can be ordered as follows:

Latest on Top

The list is ordered by the timestamp, meaning that the most recent notification appears first. The order resembles that of a common inbox.

By App

If the user chooses to order the items by type (by app), they appear as grouped notifications. Ordering by the type makes it easier for the user to handle a high volume of notifications, and to act on all notifications for a group at once.

  • The highest priority of a single item defines the priority for the group.
  • The time stamp for a notification group is based on the most recent notification within the group.

Hint: Bulk actions can be hidden by the system administrator. Single actions can still be executed within a notification group.

By Priority

When the user chooses to order notifications by priority, the items are ordered by highest to lowest priority.

Notifications sorted by date
Notifications sorted by date
Notifications sorted by type
Notifications sorted by type
Notifications sorted by priority
Notifications sorted by priority

Icon and Badge

The Notifications icon button is embedded in the shell bar and is the central access point for all notifications.

  • A counter and red badge appears over the upper right-hand corner of the notification icon every time a new notification is added to the list. It displays the number of new notifications.
  • Truncation:
    Desktop: If the notification count is 1000 or more, the counter shows +999.
    Mobile: If the notification count is 100 or more, the counter shows +99.
  • The badge is set to zero when the user opens the notification popover.
  • When the notification popover is displayed, the badge continues to function as usual.
Notifications - Icon/badge
Notifications - Icon/badge

Banner

High-priority notifications are shown using the banner. The banner appears on the upper right-hand corner of the screen for a short period of time and then disappears. We recommend setting a notification to high priority if you need to get the user’s immediate attention. The banner is shown on all floorplans.

Notification banner
Notification banner

Groups

If the notification list is ordered by type/app, single notification items are aggregated in one group. Within a group, single items retain their interaction principles, but the user can also execute bulk actions on an entire group. The Show More button expands the group.

  • The highest priority for a single item within a group defines the priority for the entire group.
  • The entire group can be dismissed at once. However, this does not affect processes behind the notifications. An item that was deleted from the notification list might still need to be processed.
  • We strongly recommend including a count in the group headline.

Hint: Bulk actions can be hidden by the system administrator. Single actions can still be executed within a group.

Collapsed notification group
Collapsed notification group
Expanded notification group
Expanded notification group

Items

The notification item contains several properties:

Actions

Actions are associated with notifications to allow users to act on notifications from within the notification popover. Only two actions can be displayed at a time. We recommend displaying only self-explantory actions that don’t require additional context.

Status

You can indicate the notification status using a visual bar within the notification item. There are four levels: red, orange, green, and grey. For more information about semantic colors, see How to Use Semantic Colors.

All high-priority notifications are also displayed as a banner to catch the user’s attention.

Operations

A notification operation can be dismissed. When dismissed, the notification item disappears from the list, but the task might still need to be processed. Bulk operations are exposed at group level.

Headline, Subtitle, Truncation 

Provide a short, meaningful headline. If necessary, expose additional content using a subtitle. Longer texts are truncated after the second line. However, we recommend avoiding truncation altogether. If a text truncates, users can display the full text using the Show More button.

Image and Author

You can associate images or icons with a notification.

There is also a property for displaying the author, which would typically be combined with an image. However, the “author” property is currently not supported by the SAP Fiori launchpad, and therefore cannot be used.

Read/Unread

The “read” or “unread” status of a notification is visualized using medium and bold headlines. Unclicked/unopened notifications are shown as “unread” and in bold. When an item is clicked/opened, it is shown with a medium headline.

Navigation

Navigation is triggered by clicking the item.

Content

As of today, no other content is possible nor allowed.

Notification item
Notification item

Settings

All notification types are displayed in the settings dialog. Users can switch each type on or off without affecting the underlying processes.

Users can activate the banner function for each notification type. This sets the notification status to high priority and corresponding notifications have a red status indicator. Banners are also displayed for all other high priority notifications.

If the Show High-Priority Alerts setting is switched off, banners for high-priority notifications are deactivated, and the user can work without being interrupted.

Users can also receive notifications through other channels:

  • Email: If this option is active, the user gets an email with a link to the underlying app.
  • Mobile: If this option is active, notifications are sent to a mobile device.
    Note: This feature is currently only available for Apple iOS devices and SAP S/4HANA apps. For more information, see Mobile Integration.
Notification settings
Notification settings

Behavior and Interaction (incl. Gestures)

Accessing the Notifications

Users open and close the notification popover by clicking the notification icon in the shell bar.

Accessing notifications
Accessing notifications

Executing Actions

Actions are executed by clicking the action buttons, such as Approve or Reject.

Action
Action

Close

Clicking the Close icon   in the upper right corner of the item removes the item from the list.

Dismiss notifications
Dismiss notifications

Banner/Preview

Clicking within the notification banner or preview triggers navigation to the source.

Banner
Banner

Show More

Clicking the Show More button displays the truncated text.

Mobile Integration (SAP S/4HANA only)

Apple iOS

The app icon badge on the mobile device might have a different count to the badge for notifications in the SAP Fiori shell bar. This can happen if some notifications have been disabled in the SAP Fiori settings dialog.

On a mobile device, only non-sensitive data is exposed. For legal reasons, no business data is shown on a locked screen or passed through third party networks. To see the sensitive data, users can always access the notifications on the SAP Fiori launchpad.

Similarly, business actions cannot be displayed or executed on native notifications.

Clicking a native notification triggers navigation to the corresponding app.

Resources

Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.

Elements and Controls

Implementation