Upgrading a project using ISO character sets to UTF8 character sets

From WinCC OA version 3.16 on, creating projects with ISO character sets (e.g. en_US.iso88591) is no longer supported. Already existing projects are still supported and the conversion of ISO settings to utf8 settings is done internally.

This new regulation influences the upgrade procedure of existing projects.

Projects that can be converted transparently

Projects with these specific language settings in the config file can be handled automatically:

  • Monolingual projects

  • Multilingual projects if all project languages belong to the same ISO character set (e.g. iso8859-1).

When compatible language settings are detected in the config file the

  • Upgrade process changes the names of languages in use from .isoXXXXX (XXXXX represents the character set) to .utf8 in the config file.

  • The setting useDbAsIso = 1 will be amended in the general section of the config file.

  • The order of languages will be kept.

Projects that need manual conversion

Multilingual projects with languages from different ISO character sets cannot be migrated automatically. For a project upgrade a manual conversion of the project is necessary. This includes export and import of project files. For further information please do not hesitate to get in touch with your WinCC OA support channel.

CAUTION: A manual conversion of your project will lead to a loss of your historical data!

Converting panels from ISO projects

If panels in the PNL format from an ISO project shall be used in a UTF8 project, some parameters (e.g. if you pass a text with special characters as a dollar parameter) may not be correctly displayed. In this case these panels must be converted to XML panels in the ISO project. In the UTF8 project you can convert them back to the PNL format (see also Format conversion). To convert all panels to XML and back to PNL proceed as follows:

1) Save the panel directory of the ISO project (since all panel files are overwritten by the conversion)

2) Open the ISO project

3) Execute "WCCOAui -PROJ <ISO project name> -xmlConvert=XML" in Command Line

4) Copy the panel directory to the UTF8 project

5) Close the ISO project and open the UTF8 project

6) Execute "WCCOAui -PROJ <UTF8 project name> -xmlConvert=PNL" in Command Line

Limitations

The customer shall ensure the compliant usage of characters in UTF8 based projects equivalent to the original ISO character sets. Otherwise data which is not included in the corresponding character set could be lost. Below you’ll find a table of the equivalent ISO-character sets. All languages listed in one block can be transformed automatically. All other languages belong to separate language sets and cannot be combined with any other language.

ISO8859-1
Danish Denmark da_DK
Dutch Netherlands nl_NL
English Great Britain en_GB
English US en_US
Finnish Finland fi_FI
French Canadian fr_CA
French France fr_FR
French Swiss fr_CH
German Austria de_AT
German Germany de_DE
German Swiss de_CH
Icelandic Iceland is_IS
Indonesian Indonesia id_ID
Italian Italy it_IT
Italian Swiss it_CH
Norwegian Norway no_NO
Portuguese Portugal pt_PT
Spanish Spain es_ES
Swedish Sweden sv_SE
ISO8859-2
Croatian Croatia hr_HR
Czech Czech Republic cs_CZ
Hungarian Hungary hu_HU
Polish Poland pl_PL
Rumanian Romania ro_RO
Slovakian Slovakia sk_SK
Slovenian Slovenia sl_SI
ISO8859-5
Bulgarian Bulgaria bg_BG
Russian Russian Federation ru_RU