Functions to change reporting options

Use these functions to change the default settings for a report, and to configure output and printers. The functions are provided as part of the libgre.42x library.

Table 1. Environment Configuration functions
Function Description
fgl_report_setEnvironment(
   values om.SaxAttributes )
Specifies variable values in the private environment of the report.
Table 2. Data functions
Function Description
fgl_report_createProcessLevelDataFile(
   dataFileName STRING )
  RETURNS driver om.SaxDocumentHandler
Configures the report execution to output an XML datafile.
fgl_report_runFromXML(
   dataFileName STRING) 
  RETURNS ok BOOLEAN
Replays the report from an XML file.
fgl_report_runReportFromProcessLevelDataFile(
   out om.SaxDocumentHandler,
   fileName STRING )
  RETURNS ok BOOLEAN
Runs a report from a process level file.
fgl_report_setProcessLevelDataFile(
   dataFileName STRING ) 
Configures the report execution to output an XML datafile in addition to the regular processing.
Table 3. Form functions
Function Description
fgl_report_findResourcePath(
  reportName STRING )
Returns the path to a resource searching first the working directory, then FGLRESOURCEPATH, and finally DBPATH. This function is deprecated.
Table 4. Page Functions
Function Description
fgl_report_configureLabelOutput(
   paperWidth STRING,
   paperHeight STRING,
   labelWidth STRING,
   labelHeight STRING,
   labelsPerRow INTEGER,
   labelsPerColumn INTEGER)
Configures the physical layout of a label page.
fgl_report_configureMultipageOutput(
   pageExponent STRING,
   isoNumber INTEGER,
   portrait BOOLEAN )
Configure the multipage output for ISO or JIS formats.
fgl_report_configurePageSize(
   pageWidth STRING,
   pageHeight STRING)
Set values for the page height and page width.
fgl_report_getTotalNumberOfPages()
     RETURNS pageCount INTEGER
Returns the total number of pages produced by the report.
fgl_report_selectLogicalPageMapping(
   pageMapping STRING)
Configures the mapping of logical pages to physical pages.
fgl_report_setPageMargins(
   topMargin STRING,
   bottomMargin STRING,
   leftMargin STRING,
   rightMargin STRING)
Configure the logical margins of a report.
fgl_report_setPageSwappingThreshold(
   value INTEGER )
Sets the threshold for page-to-disk swapping.
fgl_report_setPaperMargins(
   topMargin STRING,
   bottomMargin STRING,
   leftMargin STRING,
   rightMargin STRING )
Configure the physical margins of a report.
Table 5. Output functions
Function Description
fgl_report_configureAutoformatOutput(
   fontName STRING,
   fontSize INTEGER,
   fidelity BOOLEAN,
   reportTitle STRING,
   fieldNamePatterns STRING,
   systemId STRING )
Configure the output when auto-formatting is enabled..
fgl_report_configureCompatibilityOutput(
   pageWidthInCharacters INTEGER,
   fontName STRING,
   fidelity  BOOLEAN,
   reportName NULL, 
   reportCategory STRING,
   systemId STRING)
Configure the output for BDL ASCII reports (compatibility reports) being run in graphical mode using Genero Report Writer.
fgl_report_configureHTMLDevice(
   fromPage INTEGER,
   toPage INTEGER,
   embedImages INTEGER,  
   imageGenerationDirectory STRING,
   imageURLPrefix STRING,
   removeWhitespace BOOLEAN,  
   ignoreRowAlignment BOOLEAN,
   ignoreColumnAlignment BOOLEAN,
   removeBackgroundImages BOOLEAN ) 
Configure the HTML output.
fgl_report_configureImageDevice (
   antialiasFonts BOOLEAN,
   antialiasShapes BOOLEAN,
   monochrome BOOLEAN,
   fromPage INTEGER,
   toPage INTEGER,
   fileType STRING,
   filePath STRING,
   fileNamePrefix STRING,
   resolution INTEGER)
Configure the image output.
fgl_report_configureLocalization(
   charSet STRING,
   resourcePath STRING,
   numberFormat STRING,
   dateFormat STRING)
Configures the localization for the current report.
fgl_report_configureOORTFDevice (
   fromPage INTEGER,
   toPage INTEGER,
   imagesResolution INTEGER,
   imagesFormat STRING )
Configure RTF output for Open Office.
fgl_report_configurePDFDevice(
   fontDirectory STRING,
   antialiasFonts BOOLEAN,
   antialiasShapes BOOLEAN,
   monochrome BOOLEAN,
   fromPage INTEGER,
   toPage INTEGER)
Configure the PDF output.
fgl_report_configurePDFFontEmbedding(
   preferUnicodeEncoding BOOLEAN )
Configure the font embedding in PDF output.
fgl_report_configureRTFDevice(
   fromPage INTEGER,
   toPage INTEGER,
   imagesResolution INTEGER,
   imagesFormat STRING ) 
Configure RTF output for Microsoft.
fgl_report_configureSVGDevice(
  antialiasFonts BOOLEAN,
  antialiasShapes BOOLEAN,
  embedFonts BOOLEAN,
  charsetToEmbed STRING )
Configure the SVG output.
fgl_report_configureSVGPreview(
   preview STRING)
Select how the document is handled by the SVG previewer.
fgl_report_configureXLSDevice(
   fromPage INTEGER,
   toPage INTEGER,
   removeWhitespace BOOLEAN,
   ignoreRowAlignment BOOLEAN,
   ignoreColumnAlignment BOOLEAN,
   removeBackgroundImages BOOLEAN,
   mergePages BOOLEAN ) 
Configure the XLS (Excel) output.
fgl_report_configureXLSXDevice (
   fromPage INTEGER,
   toPage INTEGER,
   removeWhitespace BOOLEAN,
   ignoreRowAlignment BOOLEAN,
   ignoreColumnAlignment BOOLEAN,
   removeBackgroundImages BOOLEAN,
   mergePages BOOLEAN) 
Configure Excel output in XLSX format.
fgl_report_getBrowserURL()
     RETURNS url STRING
Returns the URL that launches the browser-based report viewer.
fgl_report_selectDevice(
   device STRING )
Specify the output device for the report.
fgl_report_selectPreview(
   preview BOOLEAN )
The fgl_report_selectPreview function determines whether the report is shown in the previewer or written to a file on disk.
fgl_report_setAutoformatType(
   type STRING )
Sets the auto-formatting type if no 4rp template is specified.
fgl_report_setBrowserDocumentDirectory(
  directory STRING)
Configures the document directory for browser viewing.
fgl_report_setBrowserDocumentDirectoryURL(
  directory STRING)
Configures the URL by which the document directory for browser viewing will be visible from a web server.
fgl_report_setBrowserFontDirectory(
  directory STRING)
Configures the font directory for browser viewing.
fgl_report_setBrowserFontDirectoryURL(
  directory STRING)
Configures the URL by which the font directory for browser viewing will be visible from a web server.
fgl_report_setCallbackLocalization(
   share BOOLEAN )
Configure the report to use a function to retrieve localized field titles.
fgl_report_setPDFFacturXAttachment (
  out om.SaxDocumentHandler,
  url String)
Embeds a Factur-X XML attachment into a PDF file.
fgl_report_setImageShrinkImagesToPageContent(
   value BOOLEAN )
Configure image cropping.
fgl_report_setImageUsePageNamesAsFileNames(
   value BOOLEAN )
Configure image file name generation.
fgl_report_setOutputFileName(
   fileName STRING )
Configure the file location for the device output. This function works for all output formats except Image.
fgl_report_setPDFImageResolution(
   imagesResolution INTEGER )
Configure the resolution of embedded images in PDF output.
fgl_report_setPDFAttachDocumentModelXML (
fileName String,
fileDescription String)
Attaches a Document Model XML document to any PDF output.
fgl_report_setPDFJPEGImageEncoding(
   encodeImagesAsJPEG BOOLEAN,
   jpegQuality FLOAT ) 
Configure the encoding method of embedded images in PDF output.
fgl_report_setRenderingHints(
   values om.SaxAttributes )
Specifies the hints to be used in the rendering process.
fgl_report_setRTFMemoryThreshold (
   memoryThreshold INTEGER)
Set the RTF memory threshold.
fgl_report_setSharePortWithGDC(
   share BOOLEAN)
Configures the report engine to use the same port as the Genero Desktop Client for previewing.
fgl_report_setSVGCompression(
   compressOutput BOOLEAN) 
Specify whether the SVG output should be compressed.
fgl_report_setSVGCopies(
   copies INTEGER)
Specify the number of copies to be printed.
fgl_report_setSVGOrientationRequested(
   orientationRequested String)
Specify whether the report is printed in portrait or landscape.
fgl_report_setSVGPageRange(
   fromPage INTEGER,
   toPage INTEGER )
Select which pages should be printed.
fgl_report_setSVGPaperSource(
   paperSource STRING)
Select the input source of the printer.
fgl_report_setSVGPrinterName(
   printerName STRING )
Select a specific printer by name.
fgl_report_setSVGSheetCollate (
   sheetCollate STRING )
Control the collation of multiple copies.
fgl_report_setXLSHandleBorders (
  handleBorders BOOLEAN) 
Enable borders in XLS (Excel) output.
fgl_report_setXLSXHandleBorders (
  handleBorders BOOLEAN) 
Enable borders in XLSX (Excel) output.
fgl_report_setXLSMergeCells (
  mergeCells BOOLEAN) 
Configure cell merging in XLS (Excel) output.
fgl_report_setXLSXMergeCells (
  mergeCells BOOLEAN)
Configure cell merging in XLSX (Excel) output.
fgl_report_stopGraphicalCompatibilityMode()
Restore text-based report output.
Table 6. Printer functions
Function Description
fgl_report_setPrinterChromaticity(
   chromaticity STRING )
Control color selection of the printer.
fgl_report_setPrinterCopies(
   copies INTEGER )
Specify the number of copies to be printed.
fgl_report_setPrinterDestinationUrl(
   destination STRING )
Specify an alternate destination for the spooled printer formatted data.
fgl_report_setPrinterFidelity(
   fidelity BOOLEAN )
Select printer high fidelity mode.
fgl_report_setPrinterJobImpressions(
   jobImpressions INTEGER )
Specify the total size in number of impressions.
fgl_report_setPrinterJobMediaSheets(
   jobMediaSheets INTEGER )
Specify the total number of media sheets.
fgl_report_setPrinterJobName(
   jobName STRING )
Specify a name for the printer job.
fgl_report_setPrinterJobPriority(
   jobPriority INTEGER)
Specify a priority for the printer job.
fgl_report_setPrinterJobSheets(
   jobSheets STRING)
Control job sheet printing.
fgl_report_setPrinterMediaName(
  mediaTray STRING)
Select the type of media to use.
fgl_report_setPrinterMediaSizeName(
   mediaSizeName STRING )
Select the media size to be used.
fgl_report_setPrinterMediaTray(
  mediaTray STRING)
Select the tray of the printer.
fgl_report_setPrinterName(
   printerName STRING)
Select a specific printer by name.
fgl_report_setPrinterNumberUp(
   numberUp INTEGER )
Specify the number of print stream pages for a single side of an instance.
fgl_report_setPrinterOrientationRequested(
  orientationRequested STRING)
Control the paper orientation on the printer.
fgl_report_setPrinterPageRanges(
   pageRanges STRING )
Specify the ranges of pages to print.
fgl_report_setPrinterPJLVariables(
   values om.SaxAttributes STRING )
Specify the variables for printers that support Printer Job Language (PJL).
fgl_report_setPrinterPrintQuality(
   printQuality STRING )
Control the quality used by the printer.
fgl_report_setPrinterRequestingUserName(
   requestingUserName STRING )
Specify name of the end user who submitted the print job.
fgl_report_setPrinterResolution(
   resolution STRING )
Specify an exact resolution for the printer.
fgl_report_setPrinterSheetCollate(
   sheetCollate STRING)
Controls the collation of multiple copies on the printer.
fgl_report_setPrinterSides(
   sides STRING)
Specify the mapping of pages on the physical media.
fgl_report_setPrinterWriteToFile(
   file STRING)
Specify a file where the report is written in postscript. (deprecated!)
Table 7. Distributed Mode functions
Function Description
fgl_report_configureDistributedEnvironment(
   FGLDIR STRING,
   FGLPROFILE STRING,
   FGLRESOURCEPATH STRING,
   DBPATH STRING )
Configure the environment in the case of distributed processing.
fgl_report_configureDistributedProcessing(
   host STRING,
   port INTEGER )
Configure processing via a dedicated server.
fgl_report_setDistributedRequestingUserName(
   requestingUserName STRING )
Specify end user's name for the purpose of identifying log entries in the case of distributed processing.
fgl_report_configureDistributedURLPrefix(
   urlPrefix STRING )
Configures the URL prefix containing the host and optionally the port and prepended paths for previewing a document.