File Destination and Properties¶
This feature lets you specify custom properties for each file in the package, including destination folders, extraction conditions, and uninstall options.
Accessing the File Properties Editor¶
- Open the File Manager.
- Select the file(s) whose properties you want to edit.
- Press the Properties button to open the editor.
File Properties Editor¶
Customizing File Destination¶
Specify the path to the folder where the file should be extracted.
- Default behavior: If left blank, files are extracted to the default destination folder or its subfolder if path information is stored in the archive.
- Custom destination: Use a path variable instead of an absolute path. For example, use
%SYS%
to extract files to the system directory.
On the screenshot, files are extracted to %MYDOCDIR%\New Document.
Warning
Specifying a target folder overrides stored path information when extracting files.
Advanced Example¶
If a file’s destination is determined dynamically, use a custom action to set a variable with the desired path, and use that variable as the target folder.
Conditional File Extraction¶
Control file extraction with a conditional variable:
- Set a conditional variable: Enter the variable name in the "Conditional Variable" field. Use the Variable Manager for easier selection.
-
Add a custom action: Use a "Perform operation on a variable" action to define the variable’s value before the extraction phase.
-
If the variable is
1
(true), the file is extracted. - If the variable is
0
(false), the file is ignored.
Reset File Properties¶
To clear all custom properties: - Right-click the file list and select "Clear Files Properties."
Component Variables vs. Conditional Variables¶
When a file is part of a component, its extraction depends on the component variable. If both a component variable and a conditional variable are defined, the conditional variable takes precedence.
Example¶
- A file belongs to a component with its variable set to
0
(false). - The conditional variable for the file is set to
1
(true).
The file will still be extracted because the conditional variable overrides the component variable.
File Uninstall Options¶
Prevent File Removal During Uninstall¶
If you include an uninstaller, files are removed by default unless marked as shared. To keep specific files: - Enable the "Do not remove the file when uninstalling the package" option.