Displaying Control Labels in Different Languages

This topic describes how to modify the custom_messages.js file so that Siebel Open UI displays the text for a client-side control label according to the language that the client browser uses. You can also modify the presentation model instead of modifying the custom_messages.js file. For more information about how to do this, see Customizing Presentation Models to Display Control Labels in Different Languages. For more information about language support, see Languages That Siebel Open UI Supports.

To display control labels in different languages

Create the following folder structure, if it does not exist, where <lang> is the language code such as DEU:
```
AI_DIR/siebel/scripts/siebel/custom/<lang>
```
Copy custom_messages.js from the following folder to the folder created in Step 1:
```
AI_DIR/siebel/scripts/siebel/samples
```
Open the file you saved in Step 2 using a JavaScript editor.

Locate the following code:

function _SWEgetGlobalCustomMsgAry()   
{   
  if (! _SWEbCMsgInit)   
  {   
    SWEbCMsgInit = true;   
  }   
  return _SWEcustommsgAry;   
}

Add the code in bold to the code that you located in Step 4:
```
function _SWEgetGlobalCustomMsgAry()   
{   
  if (! _SWEbCMsgInit)   
  {   
    SWEbCMsgInit = true;   
    SWEcustommsgAry["CUSTOM_ID"] = "custom_string";   
  }   
  return _SWEcustommsgAry;   
}
```
where:
- CUSTOM_ID is a string that you use to reference the custom_string. You can use any value for CUSTOM_ID.
- custom_string is a text string that includes text that you manually translate into the language that your deployment requires.

Add the following code at the beginning of the new file:

SiebelApp.S_App.LocaleObject.m_bClientStringsInitialized = false;

Save the file.
Navigate to the Administration - Application screen of your Siebel client, then the Manifest Expressions view.
Note: You need to have administrative privileges in the Siebel client.
In the Expressions list, add the following expression for the language where the string will be used:

Field Name Expression

Value

<Name of the expression> such as Dutch

Language()= “<Language code>” such as “DEU”
Navigate to the Manifest Files view to add the new file under manifest files.
Add an entry for custom_message.js in the new folder created in Step 1 as follows:
```
siebel/custom/deu/custom_messages.js
```
Navigate to the Manifest Administration view to add a new record.
In the Objects UI list, create a new entry and specify the object as follows:

Field Type Usage Type Name

Value

Application

Common

PLATFORM INDEPENDENT
In the Object Expression list, add the following subexpression:

Field Group Name Expression Level

Value

Not Applicable

DEU

1
In the Files list, click Add.
In the Files dialog box, query for the path and filename that you added in Step 11.
Click Go.
Save the changes to the manifest.
Customized translated string is now available for creating client side control via customized presentation model. Use the locale object GetLocalString API to retrieve the customized string. Update customized presentation model and provide appropriate values to the GetCtrlTemplate API to retrieve the string.
Log out of the Siebel client, clear browser cache, and log in again.
Test your work:
1. Navigate to the screen that includes the control that Siebel Open UI uses to display the translated string that you modified in Step 4.