Adding Support for XML Encoding Options

InstallShield 2019

InstallShield lets you specify what type of encoding should be used for an XML file. This setting is available on the Advanced tab when you select the XML file in the XML File Changes view. If the type of encoding that you want to use is not included in the list of available encoding options, you can modify one of the files that is installed in a subfolder of the InstallShield Program Files folder to add additional options. You can add any encoding that is supported by MSXML. The following instructions explain how.

Caution • The following instructions require that you modify the Settings.xml file that is installed with InstallShield. This file contains critical data; if it is edited incorrectly, it can cause InstallShield to fail to work. Use extreme care when editing this file.

To add additional encoding options to the Encoding list on the Advanced tab in the XML File Changes view:

1. Close InstallShield.
2. Find the Settings.xml file that is installed with InstallShield. Settings.xml is installed in one of the following locations, depending on which language version of InstallShield you are using:
EnglishInstallShield Program Files Folder\System\0409
JapaneseInstallShield Program Files Folder\System\0411
3. Create a back-up copy of the Settings.xml file, in case you later need to revert to the original version.
4. Use a text editor or XML file editor to open the Settings.xml file.
5. Search for the ISXML element and its child elements. They look something like this:

<ISXML>

  <Encodings>

    <Encoding>WINDOWS-1250</Encoding>

    <Encoding>WINDOWS-1251</Encoding>

    <Encoding>WINDOWS-1252</Encoding>

    <Encoding>WINDOWS-1253</Encoding>

    <Encoding>WINDOWS-1254</Encoding>

    <Encoding>WINDOWS-1255</Encoding>

    <Encoding>WINDOWS-1256</Encoding>

    <Encoding>WINDOWS-1257</Encoding>

    <Encoding>WINDOWS-1258</Encoding>

    <Encoding>ISO-8859-1</Encoding>

    <Encoding>ISO-8859-2</Encoding>

    <Encoding>ISO-8859-3</Encoding>

    <Encoding>ISO-8859-4</Encoding>

    <Encoding>ISO-8859-5</Encoding>

    <Encoding>ISO-8859-6</Encoding>

    <Encoding>ISO-8859-7</Encoding>

    <Encoding>ISO-8859-8</Encoding>

    <Encoding>ISO-8859-9</Encoding>

    <Encoding>US-ASCII</Encoding>

    <Encoding>UNICODE-1-1-UTF-8</Encoding>

    <Encoding>UNICODE-2-0-UTF-16</Encoding>

    <Encoding>UNICODE-2-0-UTF-8</Encoding>

    <Encoding>ISO-10646-UCS-2</Encoding>

    <Encoding>UCS-4</Encoding>

    <Encoding>UCS-2</Encoding>

    <Encoding>UTF-16</Encoding>

    <Encoding Default="true">UTF-8</Encoding>

  </Encodings>

</ISXML>

6. Between the opening and closing Encodings tags, add a new line such as this:

<Encoding>Type_of_Encoding</Encoding>

where Type_of_Encoding indicates the encoding that you want to be available. This should be the value that InstallShield should use for the encoding attribute of your XML document.

7. Save the Settings.xml file.
8. Ensure that your XML code is well formed; if it is not well formed, you may have problems using InstallShield. In most cases, you can identify improperly formed XML code by opening the Settings.xml file in Internet Explorer. You should be able to expand and contract the <ISXML> and <Encodings> elements; if you cannot, check the code for errors.

The next time that you open the XML File Changes view in InstallShield, you will see the encoding type that you added as one of the available options in the Encoding used for a new file list on the Advanced tab for an XML file in the XML File Changes view.

See Also