With text replacement at the program level, you can create and manage up to three custom program types by replacing UI text in mentoring programs. SAP SuccessFactors also provides a standard feature for text replacement at the system level. It is used when you have only one type of program and want to replace the text in all mentoring programs. The program-level text replacement, on the other hand, gives you the freedom to manage up to three custom program types in addition to the default mentoring program. For example, you want to keep the default mentoring program and create other types of programs such as coaching programs or learning circles. With the program-level text replacement, it is possible to define a text replacement pack for each of the custom program types and decide which replacement pack to use when you create a new program.
Provisioning Settings for Program-Level Text Replacement
- Go to Provisioning → Company Settings. Make sure that the necessary Language Packs are enabled and that the box for Enable Manage Languages tool is also checked.
- Go back to the Provisioning home and go to Manage Languages.
- Add a custom locale for the default active language of your system, for example en-US.
- For the custom locale, upload a custom text pack that specifies the detailed replacement text (see the section below to configure the custom text packs for custom program types).
- Repeat step 3 and 4 for all active system languages. The text replacement only works in languages that have a defined custom text pack.
Configuring Custom Text Packs for Custom Program Types
From Provisioning → Manage Languages, download the default labels to get all the system labels.
Although you must still activate Language Packs and the Enable Manage Languages tool in Provisioning, once activated you can manage languages in Admin Center as well. For more information, review the Managing Languages, Text Customization, and Localization guide on the SAP Help Portal.
Save the file to your local drive and open it to edit the labels and messages. Identify mentoring-related labels. You can sort by key. Keys of mentoring-related labels and messages start with either of the following:
DEVELOPMENT_MENTORING
DEVELOPMENT_GO_DRTMMentoring
DEVELOPMENT_GO_MentoringProgram
DEVELOPMENT_MENTEE
DEVELOPMENT_MENTOR
DEVELOPMENT_MENTORING
Keep the mentoring-related labels and messages in the sheet and delete all others. Delete column C. Save as the file with a new name (for example MessagesV2.csv).
Note
Excel is not recommended to edit the CSV file as it may break special characters in the text or change the commas into semi-colons.After the heading and before all the mentoring-related labels and messages, add definitions of replacement text for the following default text elements:
Mentee
Mentor
Mentoring Program
Activity
Note
Capitalization, plural, and singular forms of these elements must be defined as well. So, each spelling variant has its own definition.Each line of the definition must contain a key and the detailed replacement text. The two elements must be separated by a comma. Instructions on how to define keys and the replacement text are as follows:
| Key | Enter a unique identifying key for the replacement text definition. The key consists of two parts, the message key and the replacement text key. The complete key must be formulated as: <message key>_<replacement text key>.The message can by anything that makes sense to you. The replacement text keys, however, must be one of the following:
Each represents a replacement option. For example, you can use TYPEA in all replacement definitions for "Coaching Programs" and TYPEB for "Learning Circles." These three replacement text keys are also listed on the program-level text replacement configuration page, where you can further define a meaningful name for each key. You can access the configuration page through Admin Center → Manage Mentoring Programs → Settings → Text Replacement Configuration. |
| en_US | Enter your replacement text. |
Example:
12345 DEVELOPMENT_Mentoring_Programs_TEXTREPLACEHEADING_TYPEA,Coaching Programs
DEVELOPMENT_mentoring_programs_TEXTREPLACEHEADING_TYPEA,coaching programs
DEVELOPMENT_MENTORING_PROGRAM_MENTOR_TEXTREPLACEHEADING_TYPEA,Coach
DEVELOPMENT_MENTORING_PROGRAM_mentors_TEXTREPLACEHEADING_TYPEA,Coaches
Replace all mentions of mentoring programs, mentors, mentees, and activities with the keys of the relevant replacement text definition.
Example:
Before: Your $(employees) have applied to be mentors for the following mentoring programs.
After: Your $(employees) have applied to be $(DEVELOPMENT_MENTORING_PROGRAM_mentors_TEXTREPLACEHEADING_TYPEA) for the following $(DEVELOPMENT_mentoring_programs_TEXTREPLACEHEADING_TYPEA).
Save as your file with a new name, for example, MessagesV3.csv, and upload the .csv file to the custom locale as its custom labels.
If the maximum number of keys is the default (25 keys), you will receive an error message when uploading the file. You need to choose Update to set the maximum number of keys to 10,000.
Enabling Custom Text Packs in Admin Center
The replacement will be effective for all UI labels and system-generated e-mails. However, as to the e-mail invitations for program sign-up, the text replacement will only work if the e-mail text has not been customized during program setup.
Go to the configuration page for program-level text replacement: Admin Center → Manage Mentoring Programs → Settings → Text Replacement Configuration. Enable the feature by selecting the Enable Text Replacement at Mentoring Program Level checkbox. Enable the individual replacement options and enter meaningful names, for example, Coaching Program, for the replacement options.
As a result, the program-level text replacement options are enabled and are available for use when you create new mentoring programs.
