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.
- Apply the UI Text Guidelines for SAP Fiori Apps when you replace the default text.
- Review the default text and replace generic terms with the business terms familiar to users.
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.
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:
|
The selected contracts have unsaved changes by other users.
Delete anyway? |
Your feedback has been sent to the SAP Fiori design team.