get_file

Locates a file on the client or copies it from a server and then displays it in a viewer (browser, Adobe Acrobat Reader, etc).

Syntax

get_file(server,file-path,file-name,file-type,html-name);
string     server, file-path, file-name, file-type,
           html-name attribute

Description

get_file() first looks in client cache for the file and displays it if found. If not in cache, the connection to the server is opened and the file is copied to local cache and opened. If get_file() fails, error_msg() is displayed.

get_file() uses the server name to determine which connection to use to find the file. Server names are listed in the CIS file with their IP addresses. For example, a help file may be on appserver which is connection 0 while a PDF file may be on imageserver which is connection 1. These connections are usually opened in the Connect Window at the start of the CIS application

Example

get_file() can be deployed in an Action Button to get a PDF file from the image server and open it in Adobe Acrobat Reader

 {
 get_file("image_server","c:\image\","quinine.pdf","b","");
 }
 Get_file() could also be used in a menu item trigger to open an HTML
 document and put the cursor on the relevant paragraph:
 {
 get_file("appserver","c:\daspects\help","help.htm","a"," #structure");
 escape(input);
 }