fgl_report_configureCompatibilityOutput

Configure the output for BDL ASCII reports (compatibility reports) being run in graphical mode using Genero Report Writer.

Syntax

fgl_report_configureCompatibilityOutput(
   pageWidthInCharacters INTEGER,
   fontName STRING,
   fidelity  BOOLEAN,
   reportName NULL, 
   reportCategory STRING,
   systemId STRING)
  1. pageWidthInCharacters - This value overwrites any RIGHT MARGIN specification in the report definition. If the report does not contain a RIGHT MARGIN specification and this value is not set, a value of 132 is assumed.
  2. fontName - Specifies the font to use. This parameter is optional; pass a value of NULL if you don't want to set its value. The default is a fixed pitch font.
  3. fidelity - Ensures that the text preview and text printout are100% the same. The font is not embedded in the report document, it is drawn similar to an image. As a result, you may not be able to select the text in the resulting report, depending on the output format chosen (pdf, for example). For further information, see the fidelity property.
    Note: To specify a BOOLEAN value, enter TRUE or FALSE without quotation marks.
  4. reportName - the value for this parameter is now provided internally. However, because of backwards compatibility, you must set the value to NULL when you call this function.
  5. reportCategory - Specifies the category of the report. The value specified is passed to the overloadable callback function compat_placePageBackground in $GREDIR/src/overloadables/CompatCustom.4gl. By default, the Genero Report Engine calls compat_placePageBackground(out,reportName,reportCategory,pageNumber); if the report category is "demo" or "form", specific actions are taken to the report as written in the source code of CompatCustom.4gl. To provide for custom report categories, create a copy of CompatCustom.4gl in a different path, then update FGLLDPATH and put the path containing your copy BEFORE the path containing the original; the DVM will load your file instead of the default. For example, you may want to place a company logo in all reports with the category "correspondence", such as an invoice, delivery receipt, and so on.
  6. systemId - Specifies an absolute URL against which relative resources such as images in overlays are resolved.

Usage

Function to optionally configure the output for BDL ASCII reports (compatibility reports) being run in graphical mode using Genero Report Writer.

This function is applicable when no 4rp template has been specified in the call to either fgl_report_loadCurrentSettings or fgl_report_loadAndCommit. All arguments to this function are optional; pass a value of NULL if you don't want to set a value.

For an example of Genero code using a reporting function, see Using report output functions. This example may not use the specific function discussed in this topic, however it provides details on where you would place this (and other) report output functions.