Standard Action
The Standard Action executes one of the built-in InstallMate actions. In general, we recommend that you do not change the predefined order of the standard actions, unless you are familiar with the operation of the installer. The predefined action sequences execute the various standard actions in the order that works best across different installation scenarios and Windows versions, and any ill-advised changes might cause the installation or removal of your product to fail, or to leave behind traces that should have been cleaned up.
Available standard actions
The following built-in actions are available:
| Action | Description |
|---|---|
| CheckAccessRights | Checks the access rights of the installing user and determines which folders and registry keys must be redirected for a successful installation. The action uses and possibly modifies the value of the TsuInstallLevel variable based on the outcome. |
| CheckCustomerInfo | Checks the customer registration information if so configured on the User interface project page. |
| CheckInstallOptions | Verifies that enough disk space is available for the installation and that the installing user has read/write access rights in the installation folders. |
| CheckPrerequisites | Checks if any of the applicable prerequisite handlers requires Administrator rights and prevents installation if this is the case and the installer runs without Administrator rights. |
| CheckProcesses | Performs the running process check if so configured on the Installer options project page. |
| CheckRequirements | Checks the target system requirements as configured on the Requirements project page. |
| CreateFolders | Creates any folders that have an explicit "Create" action, subject to their parent component's installation state. (Other folders may be be created on demand during the installation of files and shortcuts.) |
| CreateShortcuts | Creates all shortcuts that must be installed, subject to their parent component's installation state. |
| DeleteServices | Executes all Service Action actions that specify Delete Service as their action, subject to their parent component's installation state. |
| DownloadArchives | Downloads all component and installation archives that are marked for downloading. |
| EndProcessing | Wraps up the installation. |
| EndSequence | Terminates the current action sequence. This will cause a return to the calling action sequence if the terminated sequence was entered through a Run sequence type of Run Sequence action, or it will terminate the installer if the terminated sequence was a top-level sequence. (Upon termination of the installer, the _ExitHandler action sequence is still executed.) |
| InitComponents | Initializes the component states based on the component conditions, platforms, and languages. |
| InstallFiles | Installs all files that must be installed, subject to their parent component's installation state. |
| InstallPrerequisites | Executes the applicable prerequisite handlers. If any handler fails, the installation is terminated. |
| InstallServices | Creates all services that must be installed, subject to their parent component's installation state. |
| LoadCustomerInfo | Initializes the customer registration information from the registry if so configured on the User interface project page. |
| PauseServices | Executes all Service Action actions that specify Pause Service as their action, subject to their parent component's installation state. |
| Previous | Returns control to the previous action in the action sequence. Only executable actions are considered; i.e., action conditions and platforms are taken into account when the installer searches for a previous action in the current sequence. This action may cause an infinite loop if it is the first action in an action sequence. |
| QueryCancel | Asks the user to confirm that the installation must be cancelled. If the installer runs in silent mode, the cancellation is always denied. |
| RedirectFolders | Redirects any folders and registry keys that must be redirected for a successful installation by the user. This action uses the results of the CheckAccessRights action and the current TsuInstallLevel value. |
| RegisterFiles | Registers all files that specify some form of self-registration and were installed during this run. If one or more delayed file copy operations are pending, the file registration is skipped and a post-boot registration run is scheduled instead. |
| RegisterODBC | (reserved for future use) |
| RegisterProduct | Registers the product information on the target system, including uninstaller information, if any. |
| RemoveEnvironment | Uninstalls all environment variables that must be removed, subject to their parent component's installation state. |
| RemoveFiles | Uninstalls all files that must be removed, subject to their parent component's installation state. |
| RemoveFolders | Uninstalls all folders that must be removed, subject to their parent component's installation state. |
| RemoveIniFiles | Uninstalls all INI file values that must be removed, subject to their parent component's installation state. |
| RemoveRegistry | Uninstalls all registry keys and values that must be removed, subject to their parent component's installation state. |
| RemoveShortcuts | Uninstalls all shortcuts that must be removed, subject to their parent component's installation state. |
| RepairDependents | Repair all products that have registered themselves as add-on/update products for the current product. |
| ResolvePaths | Resolves all installation paths: folders, files, shortcuts, registry keys, prior to the actual installation. This ensures a stable and restartable installation environment during installation. |
| ResumeServices | Executes all Service Action actions that specify Resume Service as their action, subject to their parent component's installation state. |
| SaveCustomerInfo | Stores the customer registration information in the registry if so configured on the User interface project page. |
| ShowAboutBox | Displays the built-in About InstallMate dialog box with the version and copyright information of the installer. |
| StartProcessing | Prepares the installer for the actual installation by resolving resource actions and creating the installer's own folder TinProductFolder. |
| StartServices | Executes all Service Action actions that specify Start Service as their action, subject to their parent component's installation state. |
| StopServices | Executes all Service Action actions that specify Stop Service as their action, subject to their parent component's installation state. |
| UninstallDependents | Uninstall all products that have registered themselves as add-on/update products for the current product. |
| UnregisterFiles | Unregisters all files that specify some form of self-registration and that will be removed during this installer run. |
| UnregisterODBC | (reserved for future use) |
| UpdateComponents | Updates the component installation actions and the associated installation size for all components, according to their current selection states. |
| WriteEnvironment | Creates or updates all environment variables that must be installed, subject to their parent component's installation state. |
| WriteIniFiles | Creates or updates all INI file values that must be installed, subject to their parent component's installation state. |
| WriteRegistry | Creates or updates all registry keys and values that must be installed, subject to their parent component's installation state. |
Attributes
The following attributes and options are available.
| Attribute | Description |
|---|---|
| Action name | Enter the name of the action, or click ... (browse) to open the Select Action Name dialog box that allows you to select the desired action. In contrast to other actions, the name of a Standard Action specifies the built-in action to execute and therefore has special significance both in InstallMate and the actual installer. |
| CPU | Select the Windows architectures on which the action must be executed. This CPU selection acts as an additional condition for the action. |
| Condition | Enter the conditional expression that determines if the action will be executed, or leave empty for unconditional execution. |
| Disabled | Check this box to disable the action. A disabled action is not included in the installer and not checked during the build. You can use this option to remove actions temporarily from your installer without permanently deleting them. Disabled actions are shown with a grayed-out icon. |