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

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

For more information, see Converting Symbolic Strings.

Run the following command to merge duplicate symbolic strings:

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

The following table describes the parameters in the command that you can set. 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.

Import consolidated strings using the ConsolidationImport business service method.

For example:
```
consoleapp "ConsolidationImport:Filename=ConsExp.txt,Repository=Siebel 
Repository, LogFile=ConsolidationLog.txt,UnlockProjects=false,SkipParentUpdates=true"
```
These parameters are the same parameters that you use to import the symbolic strings in Step 8 of Converting Symbolic Strings. For more information, see Running the Console Application Executable.
(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.