Recent changes to ftpGetFileAction

ftpGetFileAction modified by Adam Tauno Williams

Adam Tauno Williams — Wed, 08 Jan 2014 14:04:20 -0000

--- v6
+++ v7
@@ -17,6 +17,23 @@
    passive   | Defaults to YES, a value of NO disables passive mode leaving the connection in Active mode.
    directory | Directory to change to on the FTP server after authentication.  If not specified no CHDIR is performed.
    mimetype  | MIME-type to use for message containing the retrieved file; if not specified defaults to "application/octet-stream".
+
+##Example
+
+Connect and authenticate to the FTP server "ftp.example.com" and retrieve the file "tvh.zip" as the work-flow message labeled "RetrievedData" having a MIME type of "application/zip".
+
+    
+      
+      
+        ftpGetFileAction
+        ftp.example.com
+        tvh.zip
+        ******
+        *******
+        application/zip
+      
+    

 ##Possible Errors

ftpGetFileAction modified by Adam Tauno Williams

Adam Tauno Williams — Tue, 07 Jan 2014 22:01:49 -0000

--- v5
+++ v6
@@ -1,4 +1,4 @@
-[OIE]
+[OIE](OpenGroupwareIntegrationEngine)

 [TOC]

ftpGetFileAction modified by Adam Tauno Williams

Adam Tauno Williams — Tue, 07 Jan 2014 22:01:21 -0000

--- v4
+++ v5
@@ -1,3 +1,5 @@
+[OIE]
+
 [TOC]

 #ftpGetFileAction

ftpGetFileAction modified by Adam Tauno Williams

Adam Tauno Williams — Tue, 07 Jan 2014 22:00:30 -0000

--- v3
+++ v4
@@ -2,7 +2,7 @@

 #ftpGetFileAction

-Retrieves a file from an FTP service.
+Retrieves a file from an FTP service.  See [ftpPutFileAction] for uploading a file to an FTP service.

 ##Parameters

ftpGetFileAction modified by Adam Tauno Williams

Adam Tauno Williams — Tue, 07 Jan 2014 21:59:59 -0000

--- v2
+++ v3
@@ -8,8 +8,13 @@

    Parameter | Description
    ----------|---------------
-   username  |
-   password  |
+   username  | The username to provide to the FTP server for authentication.  If no username is provided anonymous authentication will be attempted.
+   password  | The password to provide to the FTP server for authentication.  If not specified it defaults to the e-mail address of the process' owner.  Password will always be NULL if no username is provided.
+   server    | The network hostname of the FTP server.
+   filename  | The filename to retrieve from the FTP server.
+   passive   | Defaults to YES, a value of NO disables passive mode leaving the connection in Active mode.
+   directory | Directory to change to on the FTP server after authentication.  If not specified no CHDIR is performed.
+   mimetype  | MIME-type to use for message containing the retrieved file; if not specified defaults to "application/octet-stream".

 ##Possible Errors

ftpGetFileAction modified by Adam Tauno Williams

Adam Tauno Williams — Tue, 07 Jan 2014 21:53:45 -0000

--- v1
+++ v2
@@ -15,7 +15,7 @@

 ###File Does Not Exist

-Traceback (most recent call last):
+    Traceback (most recent call last):
       File "/srv/projects/coils-code/coils/logic/workflow/services/process.py", line 592, in work
         action_name, description = self.run_stanza( action_uuid )
       File "/srv/projects/coils-code/coils/logic/workflow/services/process.py", line 281, in run_stanza

ftpGetFileAction modified by Adam Tauno Williams

Adam Tauno Williams — Tue, 07 Jan 2014 21:53:28 -0000

ftpGetFileAction
- Parameters
- Possible Errors
  - File Does Not Exist

ftpGetFileAction

Retrieves a file from an FTP service.

Parameters

Parameter	Description
username
password

Possible Errors

File Does Not Exist

Traceback (most recent call last):
File "/srv/projects/coils-code/coils/logic/workflow/services/process.py", line 592, in work
action_name, description = self.run_stanza( action_uuid )
File "/srv/projects/coils-code/coils/logic/workflow/services/process.py", line 281, in run_stanza
parameters=stanza.get('params'))
File "/srv/projects/coils-code/coils/core/context.py", line 530, in run_command
command.run()
File "/srv/projects/coils-code/coils/core/logic/action.py", line 283, in run
self.do_action()
File "/srv/projects/coils-code/coils/logic/workflow/actions/doc/ftpgetfile.py", line 72, in do_action
callback=self._write_block_to_wfile,
File "/usr/lib64/python2.7/ftplib.py", line 409, in retrbinary
conn = self.transfercmd(cmd, rest)
File "/usr/lib64/python2.7/ftplib.py", line 371, in transfercmd
return self.ntransfercmd(cmd, rest)[0]
File "/usr/lib64/python2.7/ftplib.py", line 334, in ntransfercmd
resp = self.sendcmd(cmd)
File "/usr/lib64/python2.7/ftplib.py", line 244, in sendcmd
return self.getresp()
File "/usr/lib64/python2.7/ftplib.py", line 219, in getresp
raise error_perm, resp
error_perm: 550 File tvh.txt not found