You are here:

fgl_upload()

Lycia supports transferring files between the client and the server. fgl_upload() is used to pass files in the client-to-server direction:

fgl_upload(client_file, server_file)

where

client_file is a string standing for the path, name and extension of the file to be downloaded
server_file is a string standing for the file target location, name and extension after the downloading

All the file names you use in your 4gl development must be platform-independent.

If you use platform-dependent names (e.g., combine upper and lower case, use colons, finish names with a full stop, etc.), please remember that they might cause different problems when you move your project to another platform.

fgl_upload() allows retrieving files stored on the client and passes it to the server. Both arguments are required and can specify the full path as well as the relative one.

For example, to send a file located at C:\Docs\Help.doc on the user's machine to the application server the following function call can be used:

CALL fgl_upload("C:\\Docs\\Help.doc", "Help.doc")

'\\' must always be used instead of "\", otherwise, the string is not treated as a path, and the function call takes no effect.

To perform a file passing in the server-to-client direction, the fgl_download() function must be used.

If the specified file does not exist, file transfer is not performed, and the function returns 0/FALSE. On success, 1/TRUE is returned.