How to resolve Language Switching Dictionary XML Import errors

Tech Note: ISS-TN077
Published Date: October 17, 2008
Primary Product: InTouch HMI
Revision Date:

Applies to

  • Wonderware InTouch 9.5 SP1

Summary

The release of Wonderware InTouch 9.5 Service Pack 1 added a comprehensive Runtime Language Switching feature. This Runtime Language Switching feature gives developers the ability to create applications where the displayed language can be changed at runtime based upon the requirements of the user.
In addition, Wonderware released the Language Switching Translation tool: a Microsoft Excel file that can be used to export or import an application’s text fields to and from an XML file for easier translation.

Developers may not have access to Microsoft Excel during application development or may use a text editor to add the text translations to the XML file.
It is important to note that some text editors, by default, will change the character encoding format in which the XML file is encoded. UNICODE (UTF-2, -8, -16, etc.) will preserve language-specific characters. ANSI (Windows-1252) encoding will not preserve special character sets.
An XML file saved with the UNICODE encoding format other than UTF-8 will fail to import using the Language Switching Translation import option. To resolve this problem, the XML file should be saved in the UTF-8 encoding format.

This tech note provides steps for changing the XML encoding format to UTF-8.

Procedure

1. If you receive the following error during import of the Dictionary or Alarm Comment .XML files in the System Management Console Log Viewer, then there is a chance the .XML file has the incorrect encoding format.

2. To change the encoding format, locate the .XML files for either the
a. Dictionary: <ApplicationName>_<Locale ID>.XML” or,
b. Alarm Comments: <prefix>_<LocaleID>_AlarmComment.XML

Note: These are usually located within a subfolder (labeled with the Locale ID) of the InTouch application folder.

3. Open the file using Windows Notepad…

4. … and make sure the translated text is still usable

Note: All question marks indicate the XML file lost the character encoding mapping the translations will need to be recreated

5. Change the Encoding type by selecting File-> Save As from the file main menu, and then select UTF-8 in the encoding drop down. This will eliminate the import error.


All Industrial Software Solutions Tech Notes are provided "as is" without warranty of any kind.