File Manage

Manages copying and moving files including local files, UNC paths. FTP, SFTP and FTPS.

This Node has been replaced by File Copy, File Move, FTP Copy, FTP Move, SFTP Copy, SFTP Move and should not be used for new Workflows. These Nodes are only available in the 2023 Refresh.

Revision History

1.0.0.35 - Added support for explicit passive & active FTP, added support for custom timeout, some bug fixes
1.1.0.0 - Added support for SSH Authentication by providing certificate contents, changed property names for consistency.
1.1.0.2 - Updated the SFTP library which contains bug fixes.
1.1.0.6 - Provide a meaningful error when properties are missing
1.2.0.8 - Upgraded Libraries, Improved SFTP, FTP&FTPS Support, QoL fixes.
1.2.0.9 - Fixed an issue affecting SFTP Copy/Move Operations where the overwrite on conflict connection flag was not being correctly evaluated.
1.2.0.10 - Fixed issue where SFTP Move operation was resulting in an exception on some servers.
1.2.0.11 - Fixed issue where SFTP Move operation was failing to create nested directories.
1.2.0.12 - Fix to correctly surface inner exception in FTP Error cases.

Added override for FTP encryption mode in connection properties.

Properties

Connection

Type: Connection Input
Provides a Connection and optionally a DropPoint to service the request.

Username
Type: String
The username used to authenticate access to the FTP or SFTP server

Password
Type: String
The password used to authenticate access to the FTP or SFTP server

ClientPrivateKeyFileContents
Type: Multiline Text Data
The SSH Certificate contents used to authenticate to the SFTP server

TrustedServerCertificateThumbprint
Type: String
The SHA-1 Fingerprint of the certificate of the FTPS server to connect to. Submitted as numbers and all uppercase letters, no colons. Note that leaving this field empty will trust any certificate presented by the server.

CreateTargetDirectory
Type: Boolean
When True****, indicates that the target path should be created if it does not already exist.

OverwriteOnConflict
Type: Boolean
When True****, indicates that the target path file should overwrite a pre-existing file on conflict.

UsePassiveFTP
Type: Boolean
Some servers are configured to expect the PASV command when a connection is initialized. The Node then sends the PASV command instead of the PORT command when initiating a connection to the Server.

Action

Type: List Input
Copy
Move
The action to perform on the specified files.

SourcePath

Type: String Input
The path to the source file (see Remarks).

DestinationPath

Type: String Input
The path to the destination file (see Remarks).

Remarks

Use this Node to perform operations on files in the same system, for example moving files on a local network, or from folder to folder on an FTP server.

As of Version 1.2.0.8, the File Manage Node is no longer executable in Run From Cloud configuration and should instead be run from a DropPoint. Should the from cloud configuration be required, this can be arranged by submitting a support ticket.

The prefix provided as part of SourcePath determine the file type as follows:

  • [Drive]:\ local drive
  • \\ UNC path for network share
  • ftp:// FTP
  • sftp:// SFTP
  • ftps:// FTPS

Authentication

The Username and PasswordorClientPrivateKeyFileContents provided in the ConnectionProperty will be used to authorize FTP or SFTP sessions only. If you require specific credentials to gain access to a local file or UNC path, change the Windows Service account used by the DropPoint.

See Also

File
File Watcher
File Compressor
Flat File
File Splitter