DOWNLOAD

Downloads a text as a file to the local client computer.

Syntax

DOWNLOAD(text; fileName)

  • text - non-formatted text, as content of the file to be downloaded - Value type: text

  • fileName - the name of the file to be downloaded - Value type: text

Remarks

  • Calling this function uses the standard download processing of the browser to store the file on the local computer.

  • The function returns !ERROR in case that any error occurs (e.g. the maximum allowed file size is exceeded, or fileName is not a valid file name).

  • In the combination with RANGETOCSV, the DOWNLOAD function can be used to store the content of any table widget on the client computer.

Examples

Clicking on the "Download" button saves the file with name "myFile.txt" and the text content "Lorem ipsum..." on the client computer.

In combination with RANGETOCSV, the DOWNLOAD function can be used to store the content of any table widget on the client computer. The formula of the "Download" button is here analogue to the previous example: DOWNLOAD(#cell2; "myFile.txt")

Note: With the functions UPLOAD and CSVTORANGE, this file can used to restore the content of this or another table widget at a later time.