File - Move

Moves one or more files from one location to another on the user's system.

Action ID:
Action Category:
Action List Syntax:

27
File 
File.Move (<<SOURCE>>, <<DESTINATION>>)

Settings

Locations

Source:

The path and filename to move "from" (this can include the wildcards "*" and "?").

Destination:

The destination folder and/or file. Do not use wildcards in this field.

NOTE

 

 

 

The destination folder MUST already exist when performing this action. If the Destination field specifies the path to a file, all of the folders included in that path must already exist. You can use a "Folder - Create" action to create any destination folder that is required.

Options

Recurse subfolders

Select this option if you want the move action to recurse through subfolders when a wildcard is used in the Source field.

Overwrite existing files

Select this option if you want any existing files in the destination folder to be overwritten by the source files.

When this option is enabled, the source files will just overwrite the destination files.

When this option is disabled, a source file won't be moved if a file with that name already exists in the destination folder.

Continue copying files even if one or more fail

Select this option if you want the move operation to continue even if some files fail to be moved correctly.

When this option is disabled, the move operation will stop as soon as the first error occurs.

Copy hidden and system files

Select this option if you want any files which have the "hidden" or "system" attributes set to be moved.

When this option is disabled, hidden and system files will not be moved.

Dialog

Dialog title:

The title that will be used for the "Moving files" dialog when it is displayed.

Error Codes

Value
(%LastErrorNum%)

Simple Message
(%LastErrorMsg%)

Verbose Message
(%LastErrorDetails%)

0 (OK)

 

 

1

MSG_ERR_MOVE_FILE

MSG_ERR_MOVE_FILE
MSG_ERR_INVALID_SOURCE
<<SOURCE>>

2

MSG_ERR_MOVE_FILE

MSG_ERR_MOVE_FILE
MSG_ERR_INVALID_DESTINATION
<<DESTINATION>>

3

MSG_ERR_MOVE_FILE

MSG_ERR_MOVE_FILE
MSG_ERR_FILE_NOT_FOUND
<<SOURCE>>

4

MSG_ERR_MOVE_FILE

MSG_ERR_MOVE_FILE
MSG_ERR_PATH_NOT_FOUND
<<DESTINATION>>

5

MSG_ERR_MOVE_FILE

MSG_ERR_MOVE_FILE
MSG_ERR_NOMOVE_ONEORMORE
Operating System Error

Examples

None