{{ transformations:DownloadFileAction.png}}
====== DOWNLOAD FILE ======
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.

\\ 
=====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.|

\\ 
=====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]]