Reveal Folder (script step reference)

By May 1, 2017May 20th, 2020Online Help, Troi File Plug-in
Troi File Plug-in for FileMaker Pro

Reveal Folder

Reveals a folder in the Finder (on Mac OS) or in Windows Explorer.

SyntaxScript step badge

Reveal Folder [ Select ; Result (error) ; folderPath ]


Select entire contentsreplaces the entire contents of a field with the result. If not checked the result replaces the currently selected portion of the field
Result (error)an error code
FolderPaththe path to the folder to be revealed

Returned Result

Data type returned

Error code


The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be:

0no errorThe folder was revealed in the Finder or Explorer
$$-35nsVolErrNo such volume (Wrong disk name or not mounted)
$$-43fnfErrFile not found
$$-50paramErrParameter error

Other errors may be returned.

Originated in

Troi File Plug-in 9.0


FileMaker Pro 16 to 19


You can use FileMaker styled paths, like “filewin:/C:/MyFiles/TheFolder”.


Reveal Folder [ Select ; $ErrorCode ; "C:\MyFiles" ]

This will make the folder visible in a Windows Explorer window and select it.

Example 2

We assume that in your FileMaker file the following fields are defined:

  gErrorCode		Global, number
  gFolderPath		Global, text

gFolderPath should contain the path to the folder, for example “D:\Data\My Folder” (Windows) or “Mac HD:Data:My Folder” (Mac). In a script add the following script step:

Reveal Folder [ Select ; gErrorCode ;  gFolderPath ]

This will show the folder specified by gFolderPath in the Finder or Explorer. It will open the enclosing folder and show the folder selected.

Related script stepsScript step badge

Launch File
Open Folder
Reveal File

Related functionFunction badge


Related topics

Troi File Plug-in online help (overview)

Online Help Page for Troi File Plug-in for 15 to 19 –> Reveal Folder (filep7310) 2020-0520 15:45:10