File Search

MSI Factory

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

Property

Property ID:

The name that uniquely identifies the property. The full path and filename of the file 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 file 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 file cannot be found. It has the effect of putting this search into the CPPSearch table as well as the AppSearch table.

File Criteria

Languages

Check this checkbox to include the target file's language as part of the search criteria. Note that only versioned files will have a language identifier (such as EXEs, DLLs, etc.) and non versioned files will generally not (such as TXT files). If checked, specify the list of language identifiers that must match in the field below. Enter a specific language identifier such as "1033" (english) or "0" for a language neutral file.

Min version

Check this checkbox to require a minimum version of the target file as part of the search criteria.

Note: When searching for a minimum version, you should specify a language in the Languages field. If you do not, you must make the minimum version one less than the one that you are actually trying to find. For example, if you are trying to set "1.0.1.120" as your minimum version, use "1.0.1.119" instead.

Max version

Check this checkbox to require a maximum version of the target file as part of the search criteria.

Min date

Check this checkbox to require a minimum date and time of the target file as part of the search criteria. This will check the last modified date of the file.

Max date

Check this checkbox to require a maximum date and time of the target file as part of the search criteria. This will check the last modified date of the file.

Min size

Check this checkbox to require a minimum size (in bytes) of the target file as part of the search criteria.

Max size

Check this checkbox to require a maximum size (in bytes) of the target file as part of the search criteria.

File

Start search in folder:

The folder to start the file 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 filename:

The name of the file to find. For example, "My file.exe."

Depth:

The number of levels deep in the folder (specified in "Start search in folder" above) to look for the file. 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")