Using Siebel Tools > Working with Strings and Other Locale-Specific Data >

Using Symbolic String References

Symbolic string references allow you to select translatable strings for properties such as Applet titles, or Application display names, from a centralized list of strings. There are two ways you can associate objects to symbolic string references. You can use the String Reference pick applet or you can type directly into the field that displays a translatable text string value.

To select a symbolic string reference using the String Reference pick applet

1. Navigate to the object and property for which you want to define a string, such as Applet Title.
2. Navigate to the Title - String reference field (in the Object List Editor) or the Title field (in the Properties window).

   NOTE:  The string reference field name can vary, depending on the object you are working on. For instance, with the Applet object, the name is displayed in Siebel Tools as described above, but with the Application object, the fields are shown as Display Name - String Reference in the Object List Editor, and Display Name in the Properties window.

3. Click the drop-down arrow in either field.

   A String-Reference picklist appears.

4. Search for the appropriate string reference, select it, and then click Pick.

   After you associate the string reference, the display value is entered based on the current Tools language mode and the Current String Value of the corresponding symbolic string locale record.

   If no existing symbolic strings meet your needs, do one of the following:

   1. Using the Object List Editor, close the pick applet, and enter the string override into the Title - String Override field.
   2. Using the Properties window, click the Use Override button in the pick applet, and focus is shifted to the corresponding String Override field in the Properties window.

To select a symbolic string reference by typing a value into the Object List Editor

1. Navigate to the object and property for which you want to define a string, such as the Title field in the Applet object, or the Display Name field in the Application object.
2. Type a value into the field, then tab out of the field.

   Siebel Tools searches for a string reference with a Current String Value that matches the value entered and one of the following occurs:

   • If one unique match exists, that string reference is associated with the object and the display value is entered based on the current Tools language mode and the Current String Value of the corresponding symbolic string locale record.
   • If there are multiple exact matches, or a match does not exist, an error message appears. Click OK, and do the following:
   1. Click the drop-down arrow in the String References field.

      The String References picklist appears.

   2. Select the appropriate reference from the picklist, then click Pick.

      You may also create a new string reference or create an override.

      NOTE:  To be able to create symbolic strings or enter values for string override properties, the EnableToolsConstrain parameter in the tools.cfg file must be set to FALSE.

To select a symbolic string reference by typing a value into the Properties window

1. Navigate to the object and property for which you want to define a string, such as the Title field in the Applet object, or the Display Name field in the Application object.
2. Type a value into the field, then tab out of the field.

   Siebel Tools searches for a string reference with a Current String Value that matches the value entered and one of the following occurs:

   • If one unique match exists, that string reference is associated with the object, and the display value is entered, based on the current Tools language mode and the Current String Value of the corresponding symbolic string locale record.
   • If there are multiple exact matches, or a match does not exist, the String Reference picklist appears, allowing you to choose the appropriate record.

     You may also create a new string reference or create an override.

     NOTE:  To be able to create symbolic strings or enter values for string override properties, the EnableToolsConstrain parameter in the tools.cfg file must be set to FALSE.

Related Topics

Creating Symbolic Strings

Entering String Overrides

Setting the Constrain Mode for Working with Symbolic Strings