Managing Custom Program Types with Text Replacement

Objective

After completing this lesson, you will be able to Manage Custom Program Types with Text Replacement.

Managing Custom Program Types with Text Replacement

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 custom program types and decide which replacement pack to use when you create a new program.

Provisioning Settings for Program-Level Text Replacement

  1. Go to ProvisioningCompany Settings. Make sure that the necessary Language Packs are enabled and that the box for Enable Manage Languages tool is also checked.
  2. Go back to the Provisioning home and go to Manage Languages.
  3. Add a custom locale for the default active language of your system, for example en-US.
  4. For the custom locale, upload a custom text pack that specifies the detailed replacement text (see section below to configure the custom text packs for custom program types).
  5. 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 ProvisioningManage 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, message key and 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:

  • TYPEA

  • TYPEB

  • TYPEC

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 CenterManage Mentoring ProgramsSettingsText Replacement Configuration.

en_US

Enter your replacement text.

Example:

Code Snippet
Copy code
Switch to dark mode
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 (e.g. 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 click on Update to set the maximum number of keys to 10,000.

Maximum Number of Keys

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 CenterManage Mentoring ProgramsSettingsText 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.

Enable Text Replacement at Mentoring Program Level

As a result, the program-level text replacement options are enabled and are available for use when you create new mentoring programs.

Text Replacement Option

Log in to track your progress & complete quizzes