Replacing Placeholder Text

Onscreen text and messages that are familiar to users in their business context simplify their work.

Both SAP Fiori elements for OData V2 and SAP Fiori elements for OData V4 define default or “placeholder” text for labels and messages, but it’s often too generic to be meaningful to users.

Guidelines

This article:

  • Explains where you can find the default text to review
  • Highlights the most valuable replacements to make

Reviewing the Default Text

To review all default text for labels and messages, see the tables for SAP Fiori elements for OData V2 and SAP Fiori elements for OData V4 respectively in Localization of UI Texts.

Guidelines
Refer to Localization of UI Texts for the current version of the default text, not in the examples in this article.

The tables at this link show:

  • i18n Key: a unique key that identifies the default text string in the application’s internationalization (i18n) file.

The application developer uses the key to identify the text to replace with the improved text you provide.

Note that Fiori elements for OData V2 and Fiori elements for OData V4 do not share keys.

  • Default Text in SAP Fiori Elements: the default text
  • Used In: a description of the UI element where the text is displayed and when it is displayed
  • (Optional) Recommendation: advice on how to improve the default text

Important Replacements to Make

For a seamless user experience, replace the following generic text with the specific and meaningful business terms that are familiar to users.

  • “Object” and “objects”
  • “Item” and “items” for subobjects
  • “Perform action,” “process,” and other generic actions

Also, pay close attention to revising the various messages related to the delete action. Because an unintentional delete action results in data loss, make sure the text warns the user about what will be deleted and confirms what has been deleted.

Replacement Examples

Replace “object” and “objects” with the business terms familiar to the users
Default Text Internationalization (i18n) Key Example Replacement
New Object  (Title for the Create dialog) Fiori elements for OData V2 : CREATE_DIALOG_TITLE New Sales Order
New Object Fiori elements for OData V4: T_NEW_OBJECT New Sales Order
Other users have edited the selected objects without saving the changes.

Delete them anyway?

Fiori elements for OData V2: ST_GENERIC_DELETE_UNSAVED_CHANGES_PLURAL Other users have edited the selected contracts without saving the changes.

Delete them anyway?

The selected objects have unsaved changes by other users.

Delete anyway?

Fiori elements for OData V4:

C_TRANSACTION_HELPER_CONFIRM_DELETE_WITH_UNSAVED_CHANGES_MULTIPLE_OBJECTS

The selected contracts have unsaved changes by other users.

Delete anyway?

Related Links