Logo
EMCO MSI Package Builder Documentation MSI Package Builder Overview | Download | Purchase

Uninstall File Filters Page

The Uninstall File Filters allow you to prevent removing system-critical files while uninstalling a generated MSI package. All changes to files and folders in the filtered folder that are captured by the Live Monitoring technology are treated as permanent. To configure the Uninstall File Filters open the program preferences using the Preferences button from the Application Menu and click the Uninstall File Filters link on the navigation bar on the left of the Preferences dialog within the Filters group Pic 1.

Configuring Uninstall File Filters

Pic 1. Configuring Uninstall File Filters

The filters are divided into two categories; those are User Filters and System Filters. The system filters are predefined ones and cannot be deleted, but can be disabled, if required, using the Disable Selected item from the pop-up menu. You can then re-enable any filter using the Enable Selected menu item. To enable/disable a filter condition and to check if it is enabled, you can use the check boxes located on the left of each row representing the filter condition. It is also possible to refuse from filtering files and folders from uninstall by disabling the Use the following filter conditions option.

Toolbar Overview

Add Filter

Add Filter

The Add Filter button should be used to add a new user-defined Uninstall File Filter condition.

Edit

Edit

The Edit button allows you to change the selected user-defined Uninstall File Filter condition.

Delete

Delete

The Delete button allows you to delete the selected user-defined Uninstall File Filter conditions.

Clear User Filters

Clear User Filters

The Clear User Filters button should be used to delete all user-defined Uninstall File Filter conditions.

As for the user filters, those are the user-defined ones. To add a new filter condition, use the Add Filter item from the pop-up menu or press the Add Filter button on the toolbar.

Configuring an Uninstall File Filter condition

Pic 2. Configuring an Uninstall File Filter condition

When configuring an Uninstall File Filter condition Pic 2, you should provide a file system path to be treated as persistent. No files and folders in the specified path, including the one represented with this path, will be deleted while uninstalling a generated MSI package. You can provide the path manually or select it through the file picker using the Select File button built into the edit box. It is possible to use the system folder definition placeholders while specifying the filter condition, these placeholders are automatically replaced with the corresponding file system paths during an MSI package uninstall process. See System Folder Definition Placeholders section of this document for the list of available placeholders.

Info

Each system folder definition should be proceeded with ${ and succeeded with }$, e. g. ${SystemFolder}$.

The Roll System Folder and Unroll System Folder buttons built into the edit box can help you with replacing specific paths to their system folder definitions and vice versa. If you enable the Use a regular expression while specifying the filter condition option, you can define a filter that will treat as permanent all paths matching the expression. See the How should I correctly specify the filter condition? section of this document for a detailed description of possible conditions.

To edit a user-defined Uninstall File Filter select it in the filters table and choose the Edit menu item from the pop-up menu or press the Edit button on the toolbar. The filter condition editing process is similar to the above-stated creation process. To delete the user-defined conditions that are no longer needed, you can select those conditions in the filters table and choose the Delete menu item from the pop-up menu or press the Delete button on the toolbar. It is also possible to delete all user-defined conditions using the Clear User Filters menu item and the corresponding button on the toolbar.