Updated: August 25, 2020

Situation Handling Framework – UI Text Guidelines

Intro

This guideline applies for the standard situation templates in the SAP S/4HANA situation handling framework. For each standard template, you need to define the following texts for key users and end users.

Texts for end users:

All texts are translated, except for the template ID.

For the individual texts, follow the guidelines below.

Warning
The situation handling framework is still evolving. This UI text guideline is a first draft based on the current implementation. If you see any issues when applying the guidelines to your use case, please share your feedback with Susanne Wilding.

Template ID

Use

Non-translatable unique ID of the standard template. The template ID is seen only by key users.

Guidelines

  • Use the following naming convention: LOB NAME_TEMPLATE NAME
  • For the line of business name, use only the official names known by customers. For example:
    CA_ for Cross Applications
    ENG_ for R&D / Engineering
    FIN_ for Finance
    MAN_ for Manufacturing
    PROC_ for Procurement
    SD_ for Sales
  • If you have space, consider using an underscore to separate the words within your template name. This makes the ID easier to read.
  • Maximum length: 30 characters

Examples

  • CA_RSH_PLANITEM_CHANGE
  • FICA_MASSACT_ERROR_RATE_AND_TIME
  • FIN_ALLOCATION_RUN_WARNING_ERROR
  • LCM_RELATIONSHIP_HEALTH_TRIGGER
Template ID in the standard situation template
Template ID in the standard situation template

Template Name

Use

Short name for the standard template. The template name is seen only by key users.

Guidelines

  • Use title case.
  • Use a meaningful text that will help the key user to find the right template. Don’t just copy the situation template ID.
  • Don’t mention the terms “situation” or “notification” (or abbreviations or variants thereof, such as “sit” or “notify”). The usage is already implicit in the template.
  • Be as concise as possible to save space. Leave out unnecessary articles or verbs.
  • Don’t end with a period.
  • Maximum length (all languages): 40 characters

Examples

  Staffing Request Updated
  Digital Access License Warning
  Blocked Invoice Due Soon
 

Template name in the standard situation template
Template name in the standard situation template

Template Description

Use

Summary of the situation for an administrator or key user.

Guidelines

  • Start with one of the following standard formulations:
    • If situation applies to a specific user role:
      Informs [user role in plural] about/when [situation].
    • If the situation can apply to different user roles:
      Informs users about/when [situation]
  • Write full sentences in sentence case, ending with a period.
  • Be concise.
  • Avoid “responsible” (as in “responsible buyers”). In English, this can also mean a person’s attitude (as opposed to irresponsible).
  • Maximum length (all languages): 255 characters

Examples

  Informs resource managers when staffing requirements in a resource request have been changed.
  Informs users when they have used over 80% of their digital access entitlement so that they can renew their license.
  Informs users when invoices that are blocked for payment will soon be overdue.

Template description in the standard situation template
Template description in the standard situation template

Short Description

Use

Summary text to help users see at a glance what the situation is about. Note that the same string is used for both in-app messages and secure notifications in the SAP Fiori launchpad.

In the template, you can see a preview of the short description as it appears in an app or notification.

Information
In the secure notification, the short description is currently shown underneath the detail text.

Guidelines

  • Phrase the text with the end user in mind. This may differ from the template name you defined for the key user.
  • Use sentence case.
  • Don’t end with a period, even if your text is a (short) sentence.
    Reason: The short descriptions can also appear in a list (table), so a consistent format is required. Most short description texts will not be a complete sentence.
  • Don’t use placeholders for variables. (Currently, placeholders aren’t supported for the template short description.)
  • Optimize your short description for the in-app situation message. Ignore any redundancy that is caused by the current display in the SAP Fiori notification (short description displayed below the details).
  • Maximum length: 40 characters (in all languages)

Examples

  Staffing request was updated
  Digital license nearly used up
  Blocked invoice overdue soon


Short description for in-app message and secure notification (text and preview)
Short description for in-app message and secure notification (text and preview)

Message Details

Use

Detail in-app message to explain the situation to the user in full.

In the standard template, you can see a preview of the message as it appears in an app.

Guidelines

  • Describe the essence of the situation as concisely as possible.
  • Don’t just repeat the short description (the message appears directly below the short description).
  • Don’t repeat contextual information that is shown on the same page (for example, the item number or the projects affected).
    However, you may include variables if highlighting a particular value would benefit the user.
  • Write full sentences in sentence case, ending with a period.
  • Never include text variables. To prevent translation issues, only IDs or number variables are permitted.
  • Maximum length: 200 characters + max. 15 variables

Examples

  The project manager has updated the staffing requirements in the resource request. Check the staffed resources in the Resource Management app.
  You have used 80% of your digital access entitlement. Please renew the license if you want to continue using this service.
  An invoice that is blocked for payment will soon be overdue. Risk of late payment fee.

Details for the in-app message (text and preview)
Details for the in-app message (text and preview)

Secure Notification Details

Use

Situation details that are shown in the secure notification message on the SAP Fiori launchpad. The situation details may contain variables.

In the standard template, you can see a preview of the notification as it appears on the launchpad.

Guidelines

  • Describe the essence of the situation as concisely as possible.
  • Don’t just repeat the short description.
  • Write full sentences in sentence case, ending with a period.
  • If necessary, use variables to provide context and to help the user identify the object affected. Focus on the most relevant values. The user can access all other details by navigating to the underlying app.
  • If you include variables, ensure that their meaning is clear in your context.
  • Never include text variables. To prevent translation issues, only IDs or number variables are permitted.
  • Maximum length: 200 characters + max. 15 variables

Examples

  Staffing requirements have changed for project “Quartz” (work package: Software, work item: Upgrade, role: Administrator)
  You have used 80% of your digital access entitlement. Please renew the license if you want to continue using this service.
  Invoice 1234678 is blocked for payment and will soon be overdue. Risk of late payment fee.


Details for the secure notification (text and preview)
Details for the secure notification (text and preview)

Public Notification

Use

Public notifications appear outside the SAP Fiori launchpad (for example, email notifications). They are more general than internal messages and never contain variables or sensitive information. To resolve the situation, users can follow a link to the SAP Fiori system.

In the standard template, you can see a preview of the notification in the body text of an email.

Note: The email subject line is a standard text that is not specific to the situation.

Guidelines

  • Describe the essence of the situation as concisely as possible.
  • Don’t just repeat the short description.
  • Write full sentences in sentence case, ending with a period.
  • Don’t use variables.
  • Maximum length: 255 characters

Examples

  A staffing request was updated. Check the staffed resources in the Resource Management app.
  You have nearly used up your digital access entitlement. Please renew the license if you want to continue using this service.
  An invoice is blocked for payment and will soon be overdue. Risk of late payment fee.

Public notification text
Public notification text

Top Tips

  • Don’t just re-use the template name and description for the end user message. The texts should reflect the different target groups.
    • Template descriptions take the third person
    • End-user texts address users directly
  • Keep in mind the different use cases for in-app messages and notifications.
    • On the situation page in an app, the message just needs to summarize the issue. All the relevant data is on the same page. Typically, in-app message details need fewer variables.
    • Notifications initially appear out of context, so additional specifics can help users identify and evaluate the relevance of a situation. Typically, detail notification texts include key variables.
  • Think carefully about how much detail you really need. Shorter texts are easier to read and allow more space for translation.
  • Avoid using lists of variables without indicating what they stand for. This makes it harder for translators to understand the overall context.

Resources

Elements and Controls

Implementation