Folder Search

MSI Factory

A folder search allows you to locate a folder on the user's system.

Property

Property ID:

The name that uniquely identifies the property. The full path of the folder will be stored in this property if it is found. If not found, the property will contain the Default value below.

Default value:

The default value of the property. This value will be assigned to the property if the folder cannot be located. Note that you cannot set a property with another property. The literal value that you enter will be assigned to the property.

Hide from log output

If checked, the property is not logged during installation. Used to prevent the installer from displaying passwords or other confidential information in the log file.

Save value during admin installation

If checked, the property is saved during administrative installation. When users install from the administrative image, the installation uses the saved values of the properties, rather than the values in the .msi file.

Allow transfer to server side (property is secure)

If checked, the property can be passed to the server side when doing a managed installation with elevated privileges.

Include in compliance check

If checked, the install will abort if the folder cannot be found. It has the effect of putting this search into the CPPSearch table as well as the AppSearch table.

Folder

Start search in folder:

The folder to start the folder search in. This value can be a standard built-in path, a directory reference from your installer, or a property (even a property obtained from a previous search). Examples of valid folders are:

[ProgramFilesFolder]

[ProgramFilesFolder]Some Product Name

[MY_SEARCH_VAR]

[WindowsVolume]

Tip: You can right-click on the edit field and select Insert > Folder ID from the context menu to open the Folders dialog for a list of the folders in your project and other common system folders.

Search for folder name:

The name of the folder to find. For example, "Product X."

Depth:

The number of levels deep in the folder (specified in "Start search in folder" above) to look for the folder. A depth of "0" means only look in the folder itself and not in any sub-folders. Anything greater than 0 is the maximum number of sub-folders (depth-wise) that will be searched. For example:

Existing directory structure:

C:\Program Files\a

C:\Program Files\b

C:\Program Files\b\b1

If the depth is set to "0" and the "Start search in folder" is "[ProgramFilesFolder]" the following folders will be searched:

C:\Program Files

If the depth is set to "1" and the "Start search in folder" is "[ProgramFilesFolder]" the following folders will be searched:

C:\Program Files

C:\Program Files\a

C:\Program Files\b

(but not "C:\Program Files\b\b1")