createDriverForAppend()

The TextReportDriver.createDriverForAppend() opens the specified report driver file so that you can append your report information as it is generated by the report engine. If the specified file does not exist, it will be created.

For example, you can use the textReportDriver.getFileName() to get the name of the report driver file that the TextReportDriver.createDriverFromTempFile() function creates. You can then call TextReportDriver.createDriverForAppend() and add one or more reports to the same output file.

Typically, you call this function directly from the TextReportDriver external type. Although it is possible to call the function from a variable that is based on the driver type, you must also be able to create a driver variable without another driver variable already in existence. The function is declared as static, meaning that it exists apart from any variables you create based on the TextReportDriver.

Syntax

  TextReportDriver.createDriverForAppend(
     fileName STRING in)
  returns (reportDriver TextReportDriver)
fileName
The name of a report driver file that the text report engine uses for output of new report information.
reportDriver
A reference variable that is based on the TextReportDriver external type.

Example

In the following example, you can call functions from the myReportDriver variable after you have created it.

myReportDriver = TextReportDriver.createDriverForAppend("C:/temp/reportFile.txt");
...
myReportDriver.closeFile();

Use a forward slash as a directory separator in the file name; EGL translates this character to the appropriate separator for the local platform.


Feedback