Customizing Character Mappings
Support is provided for custom character mappings of standards such as International Components for Unicode (ICU) and non-ICU Japanese encodings.
International Components for Unicode
The integration platform uses International Components for Unicode (ICU) 3.2 to convert internally between Unicode and most other source and target data encodings.
The following procedure shows how to customize these encoding conversions using mapping tables and a conversion utility to generate the ICU 3.2 character mappings.
The mapping tables have the file extension .ucm. The conversion utility is called makeconv.exe. Contact Engineering Support to receive a .zip archive that includes this .exe file.
Note: You must run makeconv.exe as administrator.
To customize an ICU encoding
1. As with all manually added files, you must implement this customization in each installation where you use it, including maintenance upgrades.
2. Obtain the .zip archive for ICU customization from Support.
3. Extract the .zip archive to <installdir>\runtime\di9\mappings (you will need to create the mappings folder).
4. In the extracted mappings directory, find the file makeconv.exe and a folder called tables containing .ucm files.
5. Move makeconv.exe up a level to the di9 directory.
6. In the tables folder, select the .ucm file to customize. For reference, see Customizable ICU Encodings.
7. Copy the selected .ucm file to the di9 directory.
8. Using
ICU encoding rules, open the .ucm file in a text editor, customize the character mappings, then save and close the file.
9. Open a command prompt in the di9 directory and run the following command:
makeconv mapping-table.ucm
where mapping-table is the name of the edited file. Makeconv produces the file mapping-table.cnv.
10. Move the new .cnv file to the mappings directory.
11. Restart any designer applications. Encoding conversions to and from Unicode are now handled based on the custom mappings.
12. A user-defined folder other than di9\mappings can be set in the cosmos.ini file (located in <install location>/runtime/di9) by adding the following lines:
[Preferences]EncMappingsPath=pathname
13. You can use two or more .cnv files with the same file name but alternate mappings by giving each file its own folder. To select the .cnv file to use, change the EncMappingsPath value.
See Also