Configuring Siebel Open UI > Customizing Styles, Applets, Fields, and Controls > Customizing Controls >

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 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

1. Copy custom_messages.js file from:

   INSTALL_DIR\eappweb\PUBLIC\DEU\build_number\scripts\siebel\samples

2. Save a copy of the file that you copied in Step 1, to:

   INSTALL_DIR\eappweb\PUBLIC\DEU\build_number\scripts\siebel\custom

3. Open the file you saved in Step 2 using a JavaScript editor.
4. Locate the following code:

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

5. Add the following bolded code to the code that you located in Step 4:

   function _SWEgetGlobalCustomMsgAry()
   {
     if (! _SWEbCMsgInit)
     {
       SWEbCMsgInit = true;
       SWEcustommsgAry["ID"] = "custom_string";
     }
     return _SWEcustommsgAry;
   }

   where:

   • ID is a string that you use to reference the custom_string. You can use any value for ID.
   • custom_string is a text string that includes text that you manually translate into the language that your deployment requires.

     For example, you can use the following code to convert the text label that Siebel Open UI uses for the New button that it displays on the Contact List Applet to Neu, and the Delete button to Löschen:

   function _SWEgetGlobalCustomMsgAry()
   {
     if (! _SWEbCMsgInit)
     {
       SWEbCMsgInit = true;
       SWEcustommsgAry["New"] = "Neu";
       SWEcustommsgAry["Delete"] = "Löschen";
     }
     return _SWEcustommsgAry;
   }

6. 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.
   2. Verify that the control displays the translated string.

Customizing Presentation Models to Display Control Labels in Different Languages

This topic describes how to customize a presentation model so that it displays a control label in a different language instead of modifying the custom_messages.js file.

To customize presentation models to display control labels in different languages

1. Use a JavaScript editor to open the presentation model that Siebel Open UI uses to display the control label that you must modify.

   For more information, see About the Presentation Model.

2. Add the following code to call the ExecuteMethod method that the presentation model uses. You can add this code anywhere in the presentation model file:

   pm.ExecuteMethod("AddLocalString","ID","custom_string");

   where:

   • AddLocalString is the name of the method that ExecuteMethod calls to add your custom string.

     For more information about how this example uses ID and custom_string, see Step 5. For more information about these methods, see AddLocalString Method and ExecuteMethod Method.

     For example, add the following code:

   pm.ExecuteMethod("AddLocalString", "New", "Neu");
   pm.ExecuteMethod("AddLocalString", "Delete", "Löschen");

3. Do Step 6.