Skip to main content
Version: 20 R7 BETA

WEB SEND FILE

WEB SEND FILE ( htmlFile )

ParameterTypeDescription
htmlFileTextHTML Pathname to HTML file or empty string for terminating SEND HTML FILE

Description

The WEB SEND FILE command sends, to the Web browser, the HTML page or the Web file stored in the document whose pathname you pass in htmlFile.

By default, 4D looks for the HTML document within the root folder, defined in the Database Settings.

This command accepts as a parameter either pathnames in Posix syntax (names of directories or folders are separated with a slash "/") or in the system syntax.
Specifying an invalid pathname generates an error related to file management for your operating system. You can intercept this error using a method installed by the ON ERR CALL command. If the method displays a warning or message dialog box, it will appear on the browser machine.

Once WEB SEND FILE is executed, the OK system variable is updated: if the file to be sent exists and if the timeout has not run out, OK is equal to 1. Otherwise, it is equal to 0.

Note: If you call WEB SEND FILE from within a process that is not a Web process, the command does nothing and returns no error; the call is simply ignored.

The references to 4D variables and 4DSCRIPT type tags found on the page are parsed when the document type allows for it (document based on text).

Example

The HTML root folder of the database is the WebDocs folder. It contains the following elements:

 ..\WebDocs\HTM\MyPage.HTM

Sending the Web page "MyPage.HTM" must be carried out in the following manner :

 WEB SEND FILE("HTM/MyPage.HTM")

System variables and sets

If the file to be sent exists and if the timeout has not run out, OK is set to 1. Otherwise, it is equal to 0.

See also

WEB SEND BLOB

Properties

Command number619
Thread safe
Modifies variablesOK