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

JScript Custom Action Settings
Chapter 24: View Reference
Define Setup Requirements and Actions View
When you add a JScript custom action to the Custom Actions view, you need to configure its settings.
Table 24-58: Settings for JScript Custom Actions
Setting Description
Source Location Specify where the file that is used for this custom action is located:
• Browse File System—The file that is used for this custom action is on your
system.
• Installed with the Product—The file will be installed on the target system.
Depending on which part of the installation, uninstallation, or maintenance you
schedule the custom action, the Installed with the Product option may not be
available. For example, if you schedule the custom action for the Before File
Transfer part of the installation—which occurs before the file has been installed on
the target system—the Installed with the Product option is not available.
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 JScript 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 defined a function within your .js file, enter the name of the function that you want
to be called from your JScript. JScript functions cannot take arguments from custom
actions.
Note that it is not necessary to have a function—the custom action first executes the
script, then calls the function if one is 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.
InstallShield 2012 Express Edition User Guide ISE-1800-UG01 577