Replacing Placeholder Text
Discover / Frameworks / SAP Fiori Elements / Replacing Placeholder Text
Intro
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: New Object (Title for the Create dialog)
Internationalization key (i18n): Fiori elements for OData V4: CREATE_DIALOG_TITLE
Example replacement: New Sales Order
Default text: New Object
Internationalization key (i18n): Fiori elements for OData V4: T_NEW_OBJECT
Example replacement: New Sales Order
Default text: Other users have edited the selected objects without saving the changes. Delete them anyway?
Internationalization key (i18n): Fiori elements for OData V2: ST_GENERIC_DELETE_UNSAVED_CHANGES_PLURAL
Example replacement: Other users have edited the selected contracts without saving the changes. Delete them anyway?
Default text: The selected objects have unsaved changes by other users. Delete anyway?
Internationalization key (i18n): Fiori elements for OData V4: C_TRANSACTION_HELPER_CONFIRM_DELETE_WITH_UNSAVED_CHANGES_MULTIPLE_OBJECTS
Example replacement: The selected contracts have unsaved changes by other users. Delete anyway?