Monkeybread Software - MBS FileMaker Plugin: Component: Files

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.5 10.0 10.1 10.2 10.3 10.4 10.5 11.0 11.1 11.2 Statistic FMM Blog

Component: Files

Functions to work with files and folders.

Item	Details
Files.AccessDate Queries the access date of the file or folder.	All 2.9
Files.AddedToDirectoryDate Queries the date of the file or folder when it was added to parent folder.	Mac only 6.4
Files.AppPath Returns the path to the main executable for this FileMaker solution.	All 2.7
Files.AudioTags Queries audio tags for audio file.	Mac/Win 9.4
Files.CanOpenFile Checks if plugin can read file.	All 5.4
Files.CopyFile Copies files and folders without user interface.	All 2.8
Files.CopyFiles Copies multiple files in parallel.	Mac/iOS 10.0
Files.CreateAlias Creates an alias or link file.	Mac/Win/iOS 8.4
Files.CreateBookmark Creates a bookmark from a file path.	Mac/iOS 3.1
Files.CreateDirectory Creates a directory.	All 2.7
Files.CreateHardLink Creates a new hard link.	All 6.3
Files.CreateSymbolicLink Creates a new symbolic link.	All 6.3
Files.CreationDate Queries the creation date of the file or folder.	All 2.9
Files.Delete Deletes a file directly without moving it to trash.	All 3.3
Files.DeleteFolder Deletes a file or folder directly without moving to trash.	All 4.2
Files.DirectoryExists Checks whether a directory exists with the given path.	All 2.7
Files.DiskInfo Queries information about a volume.	All 5.0
Files.FileDisplayName Queries the display name of the file or folder.	All 2.9
Files.FileExists Checks whether a file exists with the given path.	All 2.7
Files.FileExtension Queries the file extension of the given path.	All 5.2
Files.FileInfo Queries some file information.	Mac/Win/iOS 4.3
Files.FileKind Queries the file kind string.	Mac/Win 2.9
Files.FileName Queries the file name of the given path.	All 2.9
Files.FileNameWithoutExtension Queries file name without extension.	All 11.1
Files.FileSize Queries file size.	All 2.7
Files.FileUTITypes Queries uniform type identifiers for this file.	Mac only 2.9
Files.FolderSize Calculate sizes of folder.	All 6.2
Files.GetComment Queries Finder's file comment.	Mac only 6.2
Files.GetFinderLabel Queries the label of the file or folder.	Mac only 6.2
Files.GetNodeID Queries the NodeID fo the file or folder.	Mac/Win 3.1
Files.GetPathFromNodeID Finds the file or folder for the given NodeID on the given volume.	Mac/Win 3.1
Files.GetPosixPermissions Queries posix file permissions.	Mac/Linux/iOS 4.3
Files.GetTagNames Queries names of the tags assigned to the file/folder.	Mac only 3.5
Files.IsHidden Queries hidden state of a file or folder.	Mac/Win 7.1
Files.ItemExists Checks whether a item exists with the given path.	All 2.7
Files.Launch Launches the file.	Mac/Win 2.7
Files.LaunchFile Launches the file.	Mac/Win 2.7
Files.List Queries list of file names in folder.	All 2.8
Files.ListAsJSON Queries list of file names in folder as JSON.	All 10.5
Files.ListRecursive Queries list of paths in folder.	All 4.1
Files.ListVolumes Lists mounted volumes.	Mac/Win 6.5
Files.ModificationDate Queries the modification date of the file or folder.	All 2.9
Files.Mount Mounts a network share.	Mac/Win/Linux 5.1
Files.MountPath Queries mount path for a volume.	Mac/Win 8.3
Files.MoveFile Moves a file or folder without user interface.	All 2.8
Files.MoveToTrash Deletes an item by moving it to trash without user interface.	All 2.8
Files.ReadAndWriteFile Reads a file and writes it elsewhere.	All 11.1
Files.ReadFile Reads a file with the given path.	All 3.5
Files.ReadJPEG Reads a JPEG file from the file system.	All 4.3
Files.ReadPDF Reads a PDF file from the file system.	All 4.3
Files.ReadPNG Reads a PNG file from the file system.	All 4.3
Files.RenameFile Renames a file or folder without user interface.	All 2.8
Files.ResolveAlias Resolves an alias file.	Mac/Win/iOS 8.4
Files.ResolveBookmark Resolves a bookmark.	Mac/iOS 3.1
Files.RevealFile Reveals the file/folder in the shell.	Mac/Win 2.7
Files.SetAudioTags Sets audio tags for audio file.	Mac/Win/Linux 9.4
Files.SetComment Sets the file comment.	Mac only 6.2
Files.SetCreationDate Sets the file creation date.	Mac/Win/iOS 7.2
Files.SetFinderLabel Sets the Finder label.	Mac only 6.2
Files.SetHidden Sets the hidden state of a file or folder.	Mac/Win 7.1
Files.SetModificationDate Sets the file modification date.	All 7.2
Files.SetPosixPermissions Sets posix file permissions.	Mac/Linux/iOS 4.3
Files.SetTagNames Sets the tags for a file/folder.	Mac only 3.5
Files.StandardizePath Standardized a path.	All 10.3
Files.Unmount Unmount a volume.	Mac/Win/Linux 5.1
Files.WriteFile Writes a file with the given data.	All 3.5
Icon.ClearIcon Clears the custom icon for the file or directory at the specified path.	Mac only 2.7
Icon.GetIcon Queries the Finder icon for the file or folder with the given path.	Mac/Win 2.3
Icon.GetIconWithQuickLook Queries the Finder icon for the file or folder with the given path.	Mac/Win 2.3
Icon.SetIcon Sets the icon for the file or directory at the specified path.	Mac only 2.7
MountNotification.Install Installs a script trigger to be called when a disk mounts/unmounts.	Mac/Win 5.0
MountNotification.Uninstall Uninstalls notification for mount script trigger.	Mac/Win 5.0

72 functions.

Release notes

Version 11.1
- Added Files.FileNameWithoutExtension function.
- Improved error message for Files.MoveToTrash when file to delete is in use.
Version 11.0
- Rewrote Files.FileSize, Files.AccessDate, Files.CreationDate and Files.ModificationDate to use newer APIs on macOS.
Version 10.5
- Added Files.ListAsJSON function to list files and return it as JSON.
- Changed Files.CreateDirectory to create folders recursively on Windows, too.
Version 10.4
- Implemented Files.FolderSize for iOS and Linux.
Version 10.3
- Added Base64URL as output option for RSA.Sign, CURL.ReceiveData, Files.ReadFile, Hash.DigestFile, Hash.Digest, Encryption.Cipher and for other functions as text encoding parameter.
- Added Files.StandardizePath function.
Version 10.0
- Added Files.CopyFiles function.
- Fixed an issue for Files.MoveFile and Files.CopyFile where unability to move an old file to trash caused a problem on AFP volumes.
- Fixed crashes with Files.CopyFiles function with invalid paths.
Version 9.4
- Added Files.AudioTags to read ID tags from audio files.
- Added Files.SetAudioTags to change ID tags for audio files, e.g. ID3v2 tags in MP3 files.
- Fixed Files.FileSize for iOS.
Version 9.2
- Added check to Files.Delete to prevent you using paths ending in // or \\, which may unexpectedly delete a whole folder.
- Added new parameter for Files.CreateAlias to specify icon for the alias/link file.
Version 9.0
- Added MinimalBookmark parameter to Files.CreateBookmark function.
Version 8.5
- Changed Files.FileName to work on Windows/Linux if last character in path is (back)slash.
- Implemented Files.GetNodeID and Files.GetPathFromNodeID for Windows.
- Improved error handling for Files.CopyFile and Files.MoveFile.
- Rewrote Files.CopyFile and Files.MoveFile for Mac/iOS to better overwrite files.
Version 8.4
- Added Files.CreateAlias and Files.ResolveAlias functions.
- Changed Files.ListRecursive to use either / or \ for path delimiter on Windows.
- Upgraded Files.GetPathFromNodeID and Files.GetNodeID to use newer APIs which work for AFS volumes.
Version 8.3
- Added Files.MountPath function.
Version 8.2
- Fixed a rare problem on Mac with Files.RenameFile.
- Rewrote Files.RenameFile for Mac.
Version 8.1
- Improved Files.Launch to better handle passing flag as text.
Version 7.5
- Added selector CopyRight for Files.FileInfo to query copyright string on Mac.
Version 7.4
- Changed Files.RenameFile to accept only file name as second parameter instead of file path for Windows. That was inconsistent to the Mac behavior where the name was enough.
Version 7.3
- Added new flag for Files.ListRecursive to ignore invisible folders and better check for hidden elements.
- Added new option DriveType for Files.DiskInfo on Windows.
Version 7.2
- Added Files.SetCreationDate.
- Added Files.SetModificationDate.
- Added NewInstance parameter for Files.LaunchFile and Files.Launch function.
Version 7.1
- Added Files.IsHidden and Files.SetHidden.
- Improved error handling for Files.ListRecursive.
Version 7.0
- Added progress window option to Files.CopyFile and Files.MoveFile for Windows.

Blog Entries

FileMaker Magazin

Example Databases

Feedback: Report problem or ask question.