Connect-FTP method
Use this method to copy a file from one file system to another file system using File Transfer Protocol.
Parameters
The Connect-FTP method has four parameters:
| Parameter | Description |
|---|---|
| FTPServer | Select the name of an FTP server data instance to use for this file transfer. |
| RemoteFile | Specify the relative path to the destination directory specified on the FTP
service. Use forward slashes regardless of whether the FTP Service is running on
Windows or Linux. For example, if the FTP directory on the FTP service is set to c:\ftp, specify the relative path as a blank path between quotes: If the c:\ftp directory on the fTP service has a documents directory under it, c:\ftp\documents, specify the relative path as: You can enter a property name, property reference or expression that at runtime evaluates to the remote file path. |
| LocalFile | Identify the source file path and file name. Use syntax appropriate to the
operating system that hosts the Pega Platform server. If the path
contains backslash characters, escape each backslash character by doubling it.
You can enter a property name, property reference or expression that at runtime evaluates to the local file path and name. |
| TransferMode | Select ASCII for character-mode data transfers, or
Binary for binary data. The default is ASCII. |
Results
The system uses information on the Environment tab of the FTP server data instance to log into the FTP server. Upon successful log-in, the system transfers the file identified in the LocalFile parameter to the filename and directory identified in the RemoteFile parameter, and then ends the FTP connection.
Checking the method status
This method updates the pxMethodStatus property. See How to test method results using a transition.
Example
For an example use of this facility, see the PDN article How to copy files to remote systems using File Transfer Protocol.