Multiple Folder Reference Properties

 OverviewGeneralAdvancedConditionsPackages

Source

Local folder:

The edit state of the location of the folders on your development system whose contents you want to include in the install. You can click the Browse button to select a different folder or click the edit button ( ) to open the Edit Multiple Values dialog where you can change the folder name for all selected folder references.

Recurse subfolders

Include all subfolders within the all selected Local folders. If unchecked, only the files within the root of the folders will be included. The recursion of the subfolders for each folder reference is based on the state of this tri-state check box.

Note: Folder references will not include empty folders in your setup. Only folders that contain files that are included in the setup (based on the file mask), will be created by Setup Factory at runtime.

File mask:

The file mask state that will be used to determine which files will be included or excluded from the setup at build time. You can use wildcards in this field. For example, *.* for all files, *.txt for all files with the .txt file extension etc.

You can click the edit button ( ) to open the Edit Multiple Values dialog where you can change the file mask for all selected folder references.

Files that match

Only include files that match the specified file mask for all selected folder references.

Files that do not match

Exclude any files that match the specified file mask for all selected folder references.

<<Don't change>>

Don't change the file mask for any of the selected folder references.

Description:

The edit state of the design-time description for the selected folder references. This description can be used by the developer to include further information about the particular folder. The end user will not see this information.

You can click the edit button ( ) to open the Edit Multiple Values dialog where you can change the description for all selected folder references.

Run-time folder:

The edit state of the location of each folder during the install, i.e. where the setup executable can find the folder at run time.

You can click the edit button ( ) to open the Edit Multiple Values dialog where you can change the run-time folder for all selected folder references.

Note: If the folder reference is located on the Archive tab of the design environment, this field will be read-only containing the text "Archive".

Destination

Install to:

The edit state of the location that you want each folder and its contents to be installed to on the user’s system. You can use any path-related session variable by itself or with a hard-coded path that you specify.

You can click the edit button ( ) to open the Edit Multiple Values dialog where you can change the destination for all selected folder references.

Note: Setup Factory will insert the correct directory here by default when you add the folder reference to the project. Generally, you will not need to change the Install to setting.

Overwrite:

The action that will be taken if a file with the same name already exists in the location you want to install to. The relative newness of the file is determined by the version resource information built into the file. If the file does not contain version information, the file's date and time will be used as the criteria. The options are:

Note: It is generally not a good idea to select "Always overwrite existing file" unless you are sure that is what you need to do. Also, do not select "Ask the user" unless you are sure that they have the knowledge to make such a decision. "Overwrite if existing file is older" is generally the safest and most conventional option for this situation.