Appendix B: Application Properties

This section describes the application properties related to the report generator in the alphabetical order.

reporting.backgroundReportProcessingTimeoutMs

Defines the processing timeout in milliseconds for the report execution if the reporting.useBackgroundReportProcessing is set to true.

Default value: 10000.

Stored in the database.

Used in the Middleware block.

reporting.curl.path

The report generator uses the cURL tool to create reports by URL. The property value represents the path to the tool.

Default value: curl.

Used in the Middleware block.

reporting.displayDeviceAvailable

false value allows running OpenOffice/LibreOffice in the server operating system without a window interface.

Default value: false

Used in the Middleware block.

reporting.enableTabSymbolInDataSetEditor

Defines whether TAB key should be handled as \t symbol instead of focus navigation in Script fields of the report editor.

Default value: false

Used in the client blocks.

reporting.executionHistory.cleanup.days

The scheduled task deletes all execution history records older than the specified number of days. If the property value is 0, the scheduled task does not consider this property when deleting records. See Cleanup the History for details on setting up the scheduled task.

Default value: 730

Stored in the database.

Used in the Middleware block.

reporting.executionHistory.cleanup.itemsPerReport

The scheduled task leaves no more than this number of execution history entries for every report. It is not recommended to use a number greater than 1000 as the value of this property. If the property value is 0, the scheduled task does not consider this property when deleting records. It is useful for frequently run reports such as email templates, invoicing document templates, etc. See Cleanup the History for details on setting up the scheduled task.

Default value: 1000.

Stored in the database.

Used in the Middleware block.

reporting.executionHistory.enabled

Activates the report execution history mechanism.

Default value: false.

Stored in the database.

Used in the Middleware block.

reporting.executionHistory.saveOutputDocument

If set to true, report results files are saved to the file store, if the reporting.executionHistory.enabled property is on. See Output documents for details.

Default value: false.

Stored in the database.

Used in the Middleware block.

reporting.fontsDir

Path to the fonts directory for converting HTML to PDF.

For example: reporting.fontsDir = C:/Windows/Fonts.

Used in the Middleware block.

reporting.docFormatterTimeout

Sets the LibreOffice timeout in seconds for converting DOCX/XLSX to HTML/PDF.

When the time is up, the user will receive an error message.

Default value: 20

Used in the Middleware block.

reporting.office.docx.useOfficeForDocumentConversion

Turns on using OpenOffice to convert the report having DOCX template to HTML/PDF, which significantly increases the conversion accuracy.

Default value: false

Used in the Middleware block.

reporting.office.path

Sets the path to OpenOffice.

Default value: /

Used in the Middleware block.

reporting.office.ports

Specifies the comma- or vertical bar-separated list of available ports for OpenOffice/LibreOffice.

For example: reporting.office.ports = 8100|8101|8102|8103|8104|8105.

Default value: 8100, 8101, 8102, 8103.

Used in the Middleware block.

reporting.putEmptyRowIfNoDataSelected

Sets the mode when the bands which datasets have returned no records are still displayed once.

Default value: true

Used in the Middleware block.

reporting.useBackgroundReportProcessing

Allows you to set the report execution as a background task. This property is used in order to add the cancel option.

Default value: false.

Stored in the database.

Used in the Middleware block.