Components | All | New | MacOS | Windows | Linux | iOS | ||||
Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old |
Files.CopyFile
Copies files and folders without user interface.
Component | Version | macOS | Windows | Linux | Server | iOS SDK |
Files | 2.8 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
MBS( "Files.CopyFile"; SourcePath; DestPath { ; Overwrite; SkipSourcePermissionErrors; ProgressTitle } ) More
Parameters
Parameter | Description | Example | Flags |
---|---|---|---|
SourcePath | The native path to the file or folder to be copied. | "/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. (ignored on other platforms) |
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
Copies files and folders without user interface.SourcePath and DestPath must be valid and exist. So pass destination folder for the destination.
This function needs a native path. Please use Path.FileMakerPathToNativePath function in order to convert a FileMaker style path to a native path.
The Linux implementation copies file to dest. You need to have read permissions for source file. We try to preserve extended attributes and file permissions.
On Windows the 5th parameter can be 1 to use alternative copy function from Windows. This one is for copying one file only, but may be more successful in some cases.
Examples
Copy a file:
MBS( "Files.CopyFile"; "/Users/cs/Desktop/test.pdf"; "/Users/cs/Desktop/copy.pdf")
Copy file on Windows with alternative copy method:
MBS( "Files.CopyFile"; "D:\Arbeitsunterlagen\Problemloesungsbericht_SDAG_WM.xlsx"; "D:\Files_for_ZIP/CC__8D_1997_01_02__LU_53145345__2_97.xlsx"; 0; 0; 1)
Copy a file from desktop to a network volume:
MBS( "Files.CopyFile"; "C:\Users\Christian\Desktop\test.mov"; "Z:\Files\test.mov")
See also
Release notes
- Version 12.0
- Added workaround for Files.MoveFile and Files.CopyFile when it fails with MAX_PATH error.
- 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 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.
Example Databases
Blog Entries
- MBS Plugin Advent calendar: 12 - Files
- MBS FileMaker Plugin, version 11.6pr4
- Recursive Folder Copy Script
- MBS FileMaker Plugin 11.1
- MBS FileMaker Plugin, version 9.6pr2
- MBS FileMaker Plugin, version 8.5pr7
- MBS FileMaker Plugin, version 8.5pr2
- Comparing Base Elements Plugin to MBS FileMaker Plugin
- MBS FileMaker Plugin, version 7.0pr3
- Tip of the day: Mount drive on FileMaker Server
This function checks for a license.
Created 18th August 2014, last changed 3th January 2020
