Differences

This shows you the differences between two versions of the page.

--- transformations:downloadfile [2018/01/11 20:33] – created dmitry
+++ transformations:downloadfile [2021/07/15 11:39] (current) – craigt
@@ Line 1: / Line 1: @@
-===== Download file =====
+{{ transformations:DownloadFileAction.png}}
+====== DOWNLOAD FILE ======
+Category: Workflow / External\\
-Category: Workflow / External.
+\\
+=====Description=====
+This action downloads a file over one of the following network protocols: HTTP, HTTPS, FTP, FTPS. It supports basic authentication with a login and password.
-This transformation downloads a file over one of the following network protocols: HTTP, HTTPS, FTP, FTPS. It supports basic authentication with a login and password.
+\\
+=====Action settings=====
+^ Setting  ^ Description  ^
+|URL<sup>*</sup>| Enter the URL to the file to be downloaded, using the appropriate protocol (HTTP, HTTPS, FTP, or FTPS) .|
+|Use credentials|When checked, the connection with use the supplied credentials to access the remote resource.  Enter the //User name// and //Password// to use.|
+|Save to file<sup>*</sup>|Enter the fully-qualified path and filename to save the file to.|
+|If a file with such name already exists|Select how EasyMorph will handle saving the file if a file with the same name exists in the destination folder.  Options:  //Overwrite//, //Rename//, or //Halt project execution//.  See the table below.|
+<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\
+\\
+====File already exists options====
+^Option ^Description ^
+|Overwrite|The new file replaces the original file.|
+|Rename|The original file will be renamed with "backup" and a serial number appended to the file name.  The new file will\\ possess the name specified in the //File// or //Path// setting.|
+|Halt project execution|The project will stop processing and this action will display an error.|
-No restriction on file size. Interrupted downloads are not resumed.
+\\
+=====Remarks=====
+There is no restriction on file size.
+Interrupted downloads are not resumed.
 Downloading fails if the remote site uses an expired or invalid SSL certificate.
+\\
+=====Community examples=====
+  * [[https://community.easymorph.com/t//1812/2|CSV import from Web]] ([[https://community.easymorph.com/uploads/short-url/1hFZQKQ4aBDtpZSp6f8g99NCDe5.morph|Project]]; Module: //Main//; Group: //Tab 1//; Table: //Table 1//; Action position: //1//)
+  * [[https://community.easymorph.com/t//2653/1|Extracting all projects published in the Community and their actions]] ([[https://community.easymorph.com/uploads/short-url/mrnJQUJJL8Do1T8ioicyzE1VgmK.morph|Project]]; Module: //Download & parse//; Group: //Group 1//;\\ Table: //Project metadata//; Action position: //1//)
+\\
+=====See also=====
+  * [[transformations:filetransfer|File transfer]]