Reveal File (script step reference)

By May 1, 2017 May 22nd, 2019 Online Help, Troi File Plug-in
Troi File Plug-in for FileMaker Pro

Reveal File

Reveals a file in the Finder or Windows Explorer.

SyntaxScript step badge

Reveal File [ Select ; Result (error) ; FilePath ]

Options

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
FilePaththe path to the file to be revealed

Returned Result

Data type returned

Error code

Result

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 file 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

Compatibility

FileMaker Pro 16 to 18

Considerations

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

Example

Reveal File [ Select ; $ErrorCode ; "C:\readme.doc" ]

This will make the file 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
  gFilePath		Global, text

gFilePath should contain the path to the file, for example “D:\Logs\L01.TXT” (Windows) or “Mac HD:Logs:Log 1” (Mac). In a script add the following script step:

Reveal File [ Select ; gErrorCode ;  gFilePath ]

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

Related script stepsScript step badge

Launch Application
Launch File
Open Folder
Reveal Folder

Related functionFunction badge

TrFile_Reveal

Related topics

Troi File Plug-in online help (overview)


Online Help Page for Troi File Plug-in for 14 to 18 –> Reveal File (filep7299) 2019-0522 16:39:07