- Overview
- Common Parameters
- Options - Options Tab


- The utility set identifier for this utility is: oku_set01
- The utility identifier is: merging

The Text Merging utility allows you to merge extracted text back into its original format. The input files are documents created with the Text Extraction utility: Primilary XLIFF, but also Table format.

You must also have available the original files used to create the extracted documents (a.k.a. the "skeleton" files) and the same parameters file for the filter (if one was used). This is necessary to get match the same set of items in the extracted document and in the original file. The location of the skeleton files is computed from the root specified in Option Tab and the information in the extracted document itself.

The filter settings associated to the input file is not used. The utility expects the input files to be the extracted documents and to have information about the filter used for the original extraction. For more information about the expected extracted formats this utility uses, see the Text Extraction utility.

Common Parameters

The common parameters are the options specified from the application calling the utility rather than in the options dialog box of the utility itself. For this utility the common parameters you need to specify are the following:

Files of the first input list - Needed (the files to merge)
Root for the first input list - Not Needed
Files of the second input list - Not Needed
Root for the second input list - Not Needed
Files of the third input list - Not Needed
Root for the third input list - Not Needed
Input language - Needed
Output language - Needed
Input default encoding - Needed
Output default encoding - Needed
Location and names for output files - Not Needed

Options - Options Tab

Root of the skeleton files -- Enter the root of the folder where the skeleton files are located. The skeleton files are the files the processor needs to merge back the text into its original format. In the case of Okapi Framework filters, those files are simply the original files that were used to extract the text.

Root of the output merged files -- Enter the root of the folder where the output files should be generated.

In XLIFF, the full path of both the skeleton file and the output file are the specified roots plus the relative path of the file defined in the okp:original attribute of each <file> element. Output folders are created as needed if they do not exist yet.

You can specify a relative path (a path with one or more "..\" at the front) for both roots. If the root specified is a relative path the complete root is calculated based on the root of the input file. In XLIFF, the root of the input file is itself computed by removing the value of the okp:original attribute in the <file> element from the full path of the input file.

For example:

       Skeleton root = ..\Original
         Output root = ..\Merged
     Input file path = C:\My Projects\Pack5\Work\SubDir\MyFile.rc.xlf
'original' attribute = \SubDir\MyFile.rc.xlf

The root of the input file will be: C:\My Projects\Pack5\Work
         The skeleton root will be: C:\My Projects\Pack5\Original
           The output root will be: C:\My Projects\Pack5\Merged