C Localizing Challenge Questions and Responses

To localize challenge questions, you must upload localized questions per language by using the UploadResourceBundles.sh script.

You can copy existing localized challenge question text from the CommonModelBundle_LANG.properties file. To do so:

Note:

LANG is the locale code.

  1. Navigate to the OIM_HOME/server/apps/ directory, and extract the contents of the oracle.iam.ui.model.war file.

  2. Navigate to the APP-INF/lib/ directory, and extract the contents of the adflibCommonModel.jar file.

  3. Navigate to the oracle/iam/ui/common/model/ directory. The CommonModelBundle_LANG.properties file is available in this directory.

  4. In the CommonModelBundle_LANG.properties file, find the challenge question text. For example, for translation in French, you can find the following line in the CommonModelBundle_fr.properties:

    KEY_WHAT_IS_YOUR_MOTHER'S_MAIDEN_NAME?=Quel est le nom de jeune fille de votre mère?

To localize challenge questions:

  1. Add properties to the property file named customResources_LANGUAGE_COUNTRY.properties in the following format:

    global.Lookup.WebClient.Questions.QUESTION_TEXT?=VALUE

    Replace any white spaces in the question text with the tilde character (~).

    For example, to localize a challenge question 'What is your mother's maiden name?' in French locale, where language is French and country is France, create a property file named customResources_fr_FR.properties, and add the following property in the properties file:

    global.Lookup.WebClient.Questions.What~is~your~mother's~maiden~name?=VALUE_IN_FRENCH

  2. Upload the customResources_fr_FR.properties file to the Oracle Identity Manager server by referring to "Upload Resource Bundle Utility" in the Oracle Fusion Middleware Developer's Guide for Oracle Identity Manager.

Note:

The CommonModelBundle_LANG.properties file is also available in the OIM_HOME/server/apps/oracle.iam.ui.model.ear!APP-INF/lib/adflibCommonModel.jar location. To locate the CommonModelBundle_LANG.properties file, first extract the contents of the EAR file, and then the contents of the CommonModel.jar file.

If you add custom challenge questions to Oracle Identity Manager Design Console for lookup code Lookup.WebClient.Questions, then add corresponding properties to the common model bundles to localize the question text in the supported languages. Corresponding translations should be saved to the CommonModelBundle_LANG.properties file.

For example, you might add the new challenge question "What is your favorite sport?". To localize this text, add properties to the property files in the following format:

KEY_QUESTION-TEXT?=VALUE

Replace any white spaces in the question text with an underscore (_). For example, to localize the "What is your favorite sport?" challenge question in French, add the following property to the CommonModelBundle_fr.properties file:

KEY_WHAT_IS_YOUR_FAVORITE_SPORT?=Quel est votre sport favori?

To modify the text of the default challenge questions, add corresponding properties to the common model bundles (specific to the locale). For example, to modify the text of the "What is your favorite color?" question to use the British spelling (favourite and colour) instead of the American version (favorite and color), modify the following property in the CommonModelBundle_en.properties file:

KEY_WHAT_IS_YOUR_FAVORITE_COLOR?=What is your favourite colour?