Move

Operation name

Move

Function overview

Moves the file or directory.

Properties

= Remarks =

For details on use of variables, refer to Variables.

Basic settings

Item name

Required/Optional

Use of variables

Description

Remarks

Name

Required

Not available

Enter a name that is used on the script canvas.

 

Required settings

Item name

Required/Optional

Use of variables

Description

Remarks

Move source

Required

Available

Enter the path of the file or directory to move.

The Browse button launches a file chooser that allows you to select a file.

Note

Move to

Required

Available

Enter the path of the destination directory for the moved file.

The Browse button launches a file chooser that allows you to select a file.

Note

Option

Item name

Required/Optional

Use of variables

Description

Remarks

Error when file already exists in moving destination

Optional

Not available

Select whether to raise an error if the specified source file exists in the destination.

Selected

(Default)

Raise an error.

Not selected

Move.

  • This option is only for files. When the specified directory exists in the destination, FileExistsException is thrown.

Comment

Item name

Required/Optional

Use of variables

Description

Remarks

Comment

Optional

Not available

You can write a short description of this connector.

 

Schemas

Input schema

None.

Output schema

None.

Transaction

Transaction isn't supported.

Parallel Stream Processing

PSP isn't supported.

Available component variables

Variable name

Description

Remarks

success

The result of the operation is stored.

  • The default value is null.

  • When succeeded, "true" is stored. When failed, "false" is stored.

moveCount

The number of the files or the directories moved is stored.

  • The default value is null.

message_category

When an error occurs, the category of the message code corresponding to the error is stored.

  • The default value is null.

message_code

When an error occurs, the code of the message code corresponding to the error is stored.

  • The default value is null.

message_level

When an error occurs, the severity of the message code corresponding to the error is stored.

  • The default value is null.

error_type

When an error occurs, the error type is stored.

  • The default value is null.

  • The format of the error type is as follows.

    Example: java.io.FileNotFoundException

error_message

When an error occurs, the error message is stored.

  • The default value is null.

error_trace

When an error occurs, the trace information for the error is stored.

  • The default value is null.

Destination path

If the path specified in Move to is for a file or directory that doesn't exist, the file or directory is renamed and moved.

 

Example: Suppose the directory named sample specified in Move to doesn't exist.

 

Move source: /data/before/test

Move to: /data/after/sample

 

The result becomes "/data/after/sample" and the sample directory is what the test directory is renamed to.

If any files or directories exist in the test directory, they are all moved.

Message codes, exception messages, and limitations

Connector

Message code

Exception message

Limitations

Messages and limitations of the File Operation connector

check

check

check