Product Documentation
Abstract
Chinese, Japanese, or Korean (CJK) characters in a legacy PDF file that uses predefined CMaps require the corresponding CMap files for mapping the CJK encoded characters to the required encoding.
If these files are not available, blank spaces or "junk" characters are seen in place of the characters.
Content
In order to resolve this issue, download the complete set of CMap fonts from the link at the foot of this technote (cmaps_0.zip and cmaps.zip), extract the set of CMap files and then upload them into a folder embedded in your viewer application (so for IBM Content Navigator users for example, ensure the folder is packaged as part of the Navigator deployment). Use the attached file:
- cmaps_0.zip for version till 5.0.10 ifixes.
- cmaps.zip for version 5.0.11 onwards.
Now add the HTML parameter cmapLocation to the application or code that runs up the viewer and which points to the location of the folder containing the CMap files:
cmapLocation
This parameter must be set to the location containing the CMaps files.
The location can be a path to the CMaps, or an HTTP(S) URL to the location. For example, /myapp/cmaps or http://host:port/myapp/cmaps
The CMap files must be downloadable from an HTTP GET request to that location. For example, http://host:port/myapp/cmaps/Adobe-Japan1-UCS2 would return the content of this CMap file.
cmapLocation
This parameter must be set to the location containing the CMaps files.
The location can be a path to the CMaps, or an HTTP(S) URL to the location. For example, /myapp/cmaps or http://host:port/myapp/cmaps
The CMap files must be downloadable from an HTTP GET request to that location. For example, http://host:port/myapp/cmaps/Adobe-Japan1-UCS2 would return the content of this CMap file.
For IBM Content Navigator users, it is suggested that you include the \cmap location under the main WAR file and in the same location used for other custom resource files such as Image Stamps used for annotations.
Like this:
Extract and copy the "cmaps" folder into the directory navigator.war/resources/ folder. If the resources folder does not exist, you need to create it.
Open the administrator tool, click Settings > Daeja View ONE, and then click the Virtual tab.
Under Additional settings, add the following parameter name and value pairs:
Open the administrator tool, click Settings > Daeja View ONE, and then click the Virtual tab.
Under Additional settings, add the following parameter name and value pairs:
Parameter name: cmaplocation
Value:/navigator/resources/cmaps
Value:/navigator/resources/cmaps
Like this:
Once you have set up the folder containing the CMap files and completed the configuration, it is recommended that you restart the application to ensure it takes effect.
There is an optional more parameter, required whether the CMap files are of the compressed "bcmap" variety
cmapPacked
This parameter determines whether the CMap files are compressed 'bcmap' files or standard text files.
If the CMap files are compressed files with the "(dot).bcmap" extension then the parameter must be set to true. The default value is false.
Typically, this parameter is not required.
If a document still fails to render multi-byte characters further to this fix being applied, use the browser developer tools console output to confirm if the CMaps are configured and found. The following example shows that the CMap location is configured but that the required CMap file is not present in the location:
Document Location
Worldwide
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSTTN8","label":"IBM Daeja ViewONE Virtual"},"Component":"Virtual","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.0.6 iFix4+","Edition":"ViwONE Virtual","Line of Business":{"code":"LOB45","label":"Automation"}}]
Was this topic helpful?
Document Information
Modified date:
30 October 2022
UID
ibm11076613
Manage My Notification Subscriptions