Change Set Settings

InstallShield 2019 » Text File Changes » Change Set

Project • The Text File Changes view is available in the following project types:

Basic MSI
DIM
InstallScript MSI
Merge Module
MSI Database
Transform

This view is not available in InstallScript projects; however, the InstallScript language includes string functions for finding and modifying string variables and literals.

When you select a change set item in the Text File Changes explorer of the Text File Changes view, the following settings are available for you to configure.

Change Set Settings

Setting

Description

Target Folder

Specify the location of the text file (that is, any non-binary file, such as a .txt, .htm, .xml, .config, .ini, or .sql file) on the target system. Instead of entering a hard-coded path, you can select a Windows Installer folder property from the list.

Tip • Do not separate subfolders from the folder property with a backslash, but separate further levels of subfolders with a backslash—for example, [ProgramFilesFolder]MyCompany\Subdirectory.

Include Files

Specify one or more text files that you want to be searched. Separate multiple files with a semicolon (;).

To indicate a wild-card character, use an asterisk (*). For example, if you want to search all .xml and .config files in the specified directory, enter the following:

*.xml;*.config

Tip • You can use Windows Installer public properties to specify the names of the text files that you want to include in or exclude from your search. This enables you to use data that end users enter in dialogs, or other configuration information that is determined at run time, when your product’s text files are modified at run time. To learn more, see Using Windows Installer Properties to Dynamically Modify Text Files.

Exclude Files

Specify the file or files that you want to be excluded from the search. Separate multiple files with a semicolon (;).

To indicate a wild-card character, use an asterisk (*). For example, if you want to exclude all .htm and .html files in the specified directory, enter the following:

*.htm;.html

Tip • You can use Windows Installer public properties to specify the names of the text files that you want to include in or exclude from your search. This enables you to use data that end users enter in dialogs, or other configuration information that is determined at run time, when your product’s text files are modified at run time. To learn more, see Using Windows Installer Properties to Dynamically Modify Text Files.

Include Subfolders

Specify whether you want the installation to search the subfolders of the location that you specified in the Target Folder setting.

Run on Install

Specify whether you want the search-and-replace behavior to occur when the change set’s component is installed on the target system.

Run on Uninstall

Specify whether you want the search-and-replace behavior to occur when the change set’s component is removed from the target system.

Component

Select the component with which you want to associate this text file by using one of the following methods:

To select from a list of components that are already in your project, click the arrow.
To browse to the component that you want to use or to create a new component for the text file changes, click the ellipsis button (...).

See Also