InstallShield 2012 Express Edition User Guide - Knowledge Base ...

Chapter 24: View Reference
Define Setup Requirements and Actions View
Table 24-57: Settings for VBScript Custom Actions (cont.)
Setting Description
File Name If you selected Browse File System in the Source Location setting, click the ellipsis
button (...) in the File Name setting to browse to the VBScript file that you want to use for
the custom action. When you build your installation, this file is automatically incorporated
into your installation. Although the custom action is run during installation, the file is
removed following installation.
If you selected Installed with the Product in the Source Location setting, click the ellipsis
button (...) in the File Name setting to browse for the file from the list of files that have
already been added to your project through the Files view. Files that are installed on the
target system are launched from their destination on the target system.
Function Name If you have defined a function within your .vbs file, enter the name of the function that you
want to execute. This is executed after the VBScript. VBScript functions cannot take
arguments from custom actions. Additionally, it is unnecessary to have a function—the
custom action first executes the script, then calls the function if specified.
In-Script Execution Select the iteration of the sequence that should trigger the selected custom action. For
detailed information about each option, see Action Execution Options.
Note that this setting does not apply to some sequences. For example, if you add a
custom action under After Initialization (before first dialog), the action will be
scheduled for immediate execution; it cannot be scheduled for deferred, rollback, or
commit execution.
Wait for Action Specify whether you want the installation, uninstallation, or maintenance to wait until the
custom action exists before proceeding with the rest of the installation.
If you select No, the installation, uninstallation, or maintenance continues while your
custom action runs.
Ignore Exit Code Specify whether you want the Windows Installer to ignore the return value of this custom
action and continue the installation, uninstallation, or maintenance.
Comments Enter comments about this custom action. These comments are for your reference only
and are not displayed to end users.
Condition This setting lets you specify one or more conditions that must be true in order for the
selected custom action to be run. For example, you can create a condition that checks
the target system for a specific operating system or minimum system requirements. If
the conditions evaluate to True at run time, the custom action is run. If one or more of
the conditions evaluate as False, the custom action is not run.
To specify one or more conditions, click the ellipsis button (...) in this setting.
When you add a condition, InstallShield adds a new setting under the Condition setting.
This new setting displays the conditional statement for the condition that you added.
To edit or delete a condition, click the ellipsis button (...) in the Condition setting.
576 ISE-1800-UG01 InstallShield 2012 Express Edition User Guide