|
Get SteelArrow!
|
|
|
|
<SAFTP/>
|
|
|
|
|
|
|
Secure Tag |
Return to Tag List |
|
The FTP tag offers a developer access to remote file systems through the FTP protocol. It
allows such operations as CONNECT, DISCONNECT, GET DIRectory, CURRENT DIRectory, CHANGE DIRectory,
MAKE DIRectory, REMOVE DIRectory, REMOVE FILE, RENAME, PUT FILE, PUT DATA, GET FILE and GET DATA.
All operations operate on local absolute paths.
Directory listing returns a table containing the following columns;
TYPE (d,-,l), OWNER, PERM (permissions rwxrwxrwx), NAME, SIZE, DATE, GROUP, OCTPERM (777)
|
|
Attributes:
NAME | variable (return value) |
CONNECTION | name of connection; supports connection re-use |
SERVER | server to connect to |
PORT | server port (default is 21) |
PASSIVE | passive FTP mode; "yes" or "no" (default is "no") |
ACTION |
CONNECT (default) |
NAME contains "Success"; else error message |
DISCONNECT | NAME contains "Success"; else error message |
GETDIR | NAME contains directory listing; else error message |
CURRENTDIR | NAME contains directory name; else error message |
CHANGEDIR | NAME contains "Success"; else error message |
MAKEDIR | NAME contains "Success"; else error message |
REMOVEDIR | NAME contains "Success"; else error message |
REMOVEFILE | NAME contains "Success"; else error message |
RENAME | NAME contains "Success"; else error message |
PUTFILE | NAME contains "Success"; else error message |
PUTDATA | NAME contains "Success"; else error message |
GETFILE | NAME contains "Success"; else error message |
GETDATA | NAME contains retrieved data; else error message |
|
SOURCE | source of operation |
DEST | destination of operation |
|
|
|
The following are examples of FTP;
|
|
<!--- Default ACTION is "connect" (path can be included) --->
<SAFTP NAME=ftp SERVER="10.0.0.1" USERNAME="a" PASSWORD="b"
CONNECTION="one">
<!--- get the directory listing --->
<SAFTP CONNECTION="one" ACTION="getdir" NAME=ftp1>
<!--- change directory (could be absolute) --->
<SAFTP CONNECTION="one" ACTION="changedir" SOURCE="someRemoteDir/subDir">
<!--- get a file and store locally --->
<SAFTP CONNECTION="one" ACTION="getfile" SOURCE="remoteFile.data"
DEST="C:\localFile.data">
<!--- get the directory listing --->
<SAFTP CONNECTION="one" ACTION="getdir" NAME=ftp2>
<!--- get remote data and store in variable --->
<SAFTP NAME=ftp3 CONNECTION="one" ACTION="getdata" SOURCE="remoteFile.data">
<!--- retrieve the current directory --->
<SAFTP NAME=ftp4 CONNECTION="one" ACTION="currentdir">
|
|
|
|