Script functions reference > Script functions in alphabetical order > O > OutputFile
OutputFile
Syntax
OutputFile(str_filename);
str_filename
A string containing the path and the name of the file whose contents are to be sent to the output connector.
Description
The OutputFile function is used in a Process to send the contents of a file directly to an output connector, without changing or modifying the contents. It can also be used for concatenating or encapsulating already existing data.
Note:
You must not specify any Device driver for the output connector to which the file is sent. The OutputFile function does not work with PageOUT, since PageOUT requires a device to be set on the connector.
See also the OutputString function.
Returns
1
The contents were successfully sent to the connector.
 
0
An error occurred. This may result if the file cannot be opened or read.
Example
Assume that you have an XMLOUT Process that produces the following output data:
<html>
<head>Tender</head>
<body>
<h1>Vitamins Inc. kindly offers the following products</h1>
</body>
</html>
You also have a file called fruits.txt that contains a price list:
<table>
<tr><td>Oranges</td><td>17.95</td></tr>
<tr><td>Bananas</td><td>14.95</td></tr>
<tr><td>Lemons</td><td>22.25</td></tr>
</table>
Instead of creating the table every time the XMLOUT Process is executed, you can include the price list in the output by calling the fruits.txt file from within the XMLOUT Process. Enter the following line in a script that is executed after the <h1> element:
OutputFile ("fruits.txt");
The output sent to the connector will be:
<html>
<head>Tender</head>
<body>
<h1>Vitamins Inc. kindly offers the following products</h1>
<table>
<tr><td>Oranges</td><td>17.95</td></tr>
<tr><td>Bananas</td><td>14.95</td></tr>
<tr><td>Lemons</td><td>22.25</td></tr>
</table>
</body>
</html>
OpenText StreamServe 5.6 Updated: 2013-03-01