Type - shows the custom action's type and it can be a file installed by the package, an attached file, a VBScript, a C++ DLL etc.
See Custom Actions List for a detailed description of the predefined custom actions used in Advanced Installer.
Action Data - represents the value of the CustomActionData property. This property can be retrieved as a regular property inside Deferred custom actions and it is available only for DLL, JScript and VBScript custom actions. A common usage scenario is to use the CustomActionData property in Rollback Custom Actions, since they are also deferred.
Deferred custom actions can receive information about the installation process, mostly only embedded in the CustomActionData property. However, this type of custom actions do not have access to installer properties.
You can specify a text that will be displayed in the progress dialog box or written in the log file, when the custom action is being run. Use the Edit Action Properties Dialog will be displayed and will allow you to specify the text. Note that only deferred custom actions can set an Action Text.button. The
- Immediately - the action will be executed immediately when it is found in the action sequence.
- When the system is being modified (deferred) - the action will be executed in order as part of the script built out of all the non-immediate actions. Custom Actions before InstallInitialize (Preparing action group) and after InstallFinalize (Finish Execution action group) can not be deferred and they must be Immediate. Note that deferred custom actions do not have access to installer's public properties.
- During installation rollback - execute the action only if something failed after this action and the installation is being rolled back.
- After the system has been successfully modified (commit) - the action will be executed in the Commit phase, after everything got installed successfully and there is no possibility for a rollback.
On Windows Vista or above the custom actions which affect the system or require Administrator privileges should run without impersonation. For this you can simply check the Run under the LocalSystem account with full privileges (no impersonation) option.
- Run under the LocalSystem account with full privileges (no impersonation) - the custom action will be executed under the LocalSystem account with full privileges. This option is not available for custom actions which are executed Immediately.
- Wait for custom action to finish before proceeding - determines if the main installation thread waits for the custom action to complete. Windows Installer always waits for custom actions executed during rollback.
- Fail installation if custom action returns an error - determines if the custom action return code is checked by Windows Installer. For more information about custom action return codes, please see the Custom Actions Page.
- Wait for return code at the end of the sequence - determines if the current stage (Wizard Dialogs Stage or Install Execution Stage) will wait for the custom action return code after all actions have been executed. The actual return code is ignored by the installation.
Custom actions that are executable files must return a value of 0 for success. The installer interprets any other return value as failure.
- Install - Enable this option if you want your
custom action to execute during installation of the package.
- First Time Install - The custom action will execute during installation of the package if no older version was found on the target computer.
- Upgrade - The custom action will execute during installation of the package only if an older version was found on the target computer.
- Uninstall - Enable this option if you want your
custom action to execute during removal of the package.
- Regular uninstall - The custom action will execute during a complete uninstall of the application, not during an upgrade. This option is available only during "Install Execution Stage".
- Replaced by a new version - The custom action will execute during removal of the application trigerred by the installation of a new version. This option is available only during "Install Execution Stage".
- Maintenance - Enable this option if you want your custom action to execute during a repair or customization of the package.
- Condition - a boolean expression which must be true for the Custom Action to be executed. Edit this field using Smart Condition Edit Control.
The First Time Install, Upgrade, Regular uninstall and Replaced by a new version options may not displayed by default, you should use the Show upgrade options link to display them.
- Advanced execution scenarios - this link displays the Advanced Execution Scenarios Dialog.