Monkeybread Software - MBS FileMaker Plugin: Files.MoveFile

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.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 11.0 Statistic FMM Blog

Files.MoveFile

Moves a file or folder without user interface.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
Files	2.8	Yes	Yes	Yes	Yes	Yes

MBS( "Files.MoveFile"; SourcePath; DestPath { ; Overwrite; SkipSourcePermissionErrors; ProgressTitle } ) More

Parameters

Parameter Description Example Flags

SourcePath The native path to the file or folder to be moved. "/Users/John/Desktop/test.txt"

DestPath The native path to the destination folder or file. "/Users/John/Desktop/Backup/"

Overwrite Mac only: Whether to allow overwriting existing files. Default is off. Pass 1 to enable and 0 to disable.
On Windows, it overwrites always. 1 Optional

SkipSourcePermissionErrors Mac only: Whether to skip files with permission errors. Default is off. Pass 1 to enable and 0 to disable. 1 Optional

ProgressTitle Title for the progress window.
For Windows only and the text may not be visible in your version of Windows. "Copying FileMake files" Optional

Parameter	Description	Example	Flags
SourcePath	The native path to the file or folder to be moved.	"/Users/John/Desktop/test.txt"
DestPath	The native path to the destination folder or file.	"/Users/John/Desktop/Backup/"
Overwrite	Mac only: Whether to allow overwriting existing files. Default is off. Pass 1 to enable and 0 to disable. On Windows, it overwrites always.	1	Optional
SkipSourcePermissionErrors	Mac only: Whether to skip files with permission errors. Default is off. Pass 1 to enable and 0 to disable.	1	Optional
ProgressTitle	Title for the progress window. For Windows only and the text may not be visible in your version of Windows.	"Copying FileMake files"	Optional

Result

Returns OK or error message.

Description

Moves a file or folder without user interface.
SourcePath and DestPath must be valid and exist. So pass destination folder for the destination.

The Linux implementation does only move files within the same file system.
On Mac you may get error -43 for file not found if you refer to a file in a folder, where you don't have file permissions to look inside the folder.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Move a file:

MBS( "Files.MoveFile"; "C:\Users\Christian\Desktop\test1.txt"; "C:\Users\Christian\Desktop\test2.txt")

Example Databases

Files/FileOperation

Blog Entries

FileMaker Magazin

Release notes

Version 10.0
- Fixed an issue for Files.MoveFile and Files.CopyFile where unability to move an old file to trash caused a problem on AFP volumes.
Version 8.5
- Improved error handling for Files.CopyFile and Files.MoveFile.
- Rewrote Files.CopyFile and Files.MoveFile for Mac/iOS to better overwrite files.
Version 7.0
- Added progress window option to Files.CopyFile and Files.MoveFile for Windows.

Created 18th August 2014, last changed 20th August 2018

Files.MountPath - Files.MoveToTrash

Feedback: Report problem or ask question.