Using Siebel Tools > Localizing Strings and Locale Data > Converting Symbolic Strings >

Consolidating Symbolic Strings

Consolidating symbolic strings eliminates duplicate symbolic strings that the conversion utility might create when it converts these strings. The conversion utility converts all the symbolic strings for one object type, and then converts all the symbolic strings for the next object type. It does this until it finishes converting all the symbolic strings that you specify. It creates multiple symbolic string records for the same display value that occurs in multiple object types. Duplicate symbolic strings can include identical sets of locale records or one symbolic string might include more child locale records than another string. The strings that these objects use in common are identical. Consolidation can remove these duplicates.

To consolidate symbolic strings

1. Review the important caution information described in Caution About Converting and Consolidating Symbolic Strings.
2. Convert symbolic strings.

   For more information, see Converting Symbolic Strings.

3. Merge duplicate symbolic strings. Run the following command:

   consoleapp "ConsolidationExport:Filename=ConsExp.txt,Repository=Siebel Repository,LogFile=ConsolidationLog.txt,Language=ENU,MatchMin=2"

   Use values from the following table. For more information, see Running the Console Application Executable.

   Parameter	Description
   Filename	The name of the export file.
   Repository	The name of the repository.
   LogFile	The name of the log file.
   Language	Same as the Language parameter that you use to export candidates for an object type. For more information, see Separating Conversion Files into Smaller Files.
   MatchMin	The minimum number of matches that the utility must find in a set of matching symbolic strings before it writes them to the file. The default value is 2.
   SkipSBLStrings	You can use one of the following values: TRUE. Ignore all strings that include the SBL_ prefix in the Name property. FALSE. Consolidate all strings that include the SBL_ prefix and all custom strings that you create. MasterOnly. Do not consolidate strings that include the SBL_ prefix, but use them as master strings. The default value is TRUE.

   After you convert locale strings to symbolic strings, you can use the consolidation utility to find duplicate symbolic strings and merge them and their references into a single symbolic string. As input, this utility uses the file that the consolidation export creates. It deletes redundant symbolic strings. It replaces all references that objects make to these strings with a reference to the master string. This consolidation might consume a significant amount of time because the object types in the repository include approximately 80 translatable string properties.

4. Import consolidated strings. Use the ConsolidationImport business service method.

   For example:

   consoleapp "ConsolidationImport:Filename=ConsExp.txt,Repository=Siebel Repository, LogFile=ConsolidationLog.txt,UnlockProjects=false,SkipParentUpdates=true"

   These are the same parameters that you use to import the symbolic strings in Step 8. For more information, see Running the Console Application Executable.

5. (Optional) Separate a consolidation export file into smaller files.

   To separate a consolidation export file into smaller files, you use the same parameters that you use to separate a conversion export file. You can then do Step 4 to import each of these smaller files. For more information, see Separating Conversion Files into Smaller Files.

Using a Batch File to Consolidate Strings

You can use a batch file to consolidate strings.

To use a batch file to consolidate strings

1. Navigate to the SIEBEL_TOOLS_ROOT\BIN directory.
2. Enter the following command:

   strcons Action User_Id Password

   You use the same parameters that you use when you use a batch file to convert strings. The only difference are:

   • If you set the action parameter to Import, then the utility imports the files from the working directory that the TEST_LOCATION parameter in the batch file identifies.
   • You do not specify an object type.

     For more information, see Using a Batch File to Convert Strings.