RtReports Remoting Host defaults

AdobePDFLocation

The AdobePDFLocation setting controls the location where unofficial printouts of reports are stored (by selecting Printers in the RtReports generator), when printed via Adobe PDF. The default location is C:\AdobePDFLocation. This folder is not created automatically; it must be created manually by the system administrator. It matches the entry in OSISoft.RtReports.RtRemotingHost.exe.config. It is used by automatic report generation. See Configure automatic report generation.

DefaultPageMargin

Default page margins , Top Bottom Left Right (inch) example value="0.4 0.5 1 1",

EnforceDefaultPageMargin

True, DefaultPageMargin are used, user-defined margin will not be used. False by default.

EnforceMarginMin

False by default. If it is true, this flag enforces RtReports 4.0 margin behavior for the left, right, and top margins. If user-defined margins are below a certain threshold (0.24), set them to default values. The left and right margins are set to 0, the top is set to 0.4.

FooterAdjustment

Added in 4.1, 0 by default. The additional margin for the page footer.

HeaderAdjustment

Added in 4.1, 0 by default. The additional margin for the page header.

IgnorePhysicalPrinterName

The IgnorePhysicalPrinterName setting allows you to ignore using a physical printer.

InstallationPath

The InstallationPath setting controls where RtReports is installed.

MaximumJobsInQueue

The default is 20. The maximum size for the printing queue.

MSHtmlBrowserWidth

Added in 4.1. This property determines or reflects the virtual browser width when rendering HTML. Only use for MSHtml rendering. The default is 0.

• Issue1:

  • When using MSHtml (i.e <add key="PDFConversionEngine" value="0" />), some reports had scaling issues.

    • Solution1: These issues can be resolved by adjusting the MSHtml Browser Width setting. By default, this setting is `0` which tries to automatically scale the report, which may not produce the desired output. Other suggested values to try are 800 and 1024. (i.e. <add key="MSHtmlBrowserWidth" value="1024" />)

• Issue2:

  • When using MSHtml, some styling such as table and text alignment may not work correctly if the LegacyPrint setting is used (i.e. <add key="LegacyPrint" value="true" />).

    • Solution2: This issue can be resolved by disabling LegacyPrint when using MSHtml (i.e. <add key="LegacyPrint" value="false" />)

OfficialAdobePDFLocation

The OfficialAdobePDFLocation setting controls the location where official printouts of reports are stored (by clicking the Print link in the RtReports generator), when printed via Adobe PDF. The default location is C:\AdobePDF_Official. This folder is not created automatically; it must be created manually by the system administrator.

PDFConversionEngine

The rendering engine to use for HTML conversion. 1- Gecko Engine, 0 MSHtml engine. The default is 1 (Gecko.).

PrintTimeOut(seconds)

The maximum time allowed for a report to print. If the time is exceeded, the print job is stopped.

ReportPDFReadonly

The ReportPDFReadOnly setting controls what version of Adobe is used to view printed reports. When set to "true," Adobe X is required to view a printed report. When set to "false", earlier versions of Adobe can be used.

ShutDownInterval

The ShutDownInterval value denotes, in milliseconds, the amount of time after the last report was printed. The default value is 61 seconds.

SkipCoverSheetPage

False by default. If it set to true, the coversheet is excluded from page numbering (RtReports 4.0 behavior).

Tracelog

The TraceLog setting defines the level of verbosity that printing messages and errors are recorded on the RtReports server. Values are: 0 (Default; only errors are added to the Event Log ), 1 (Errors and warnings are added to the Event Log), and 2 (Errors, warnings and trace messages are added to the Event Log).

ViewablePDFTimeout(minutes)

It is used internally. When the user prints a report, the report is temporarily saved in one of the folders [RtReports_Install_Directory]\ViewOfficialPDF or [RtReports_Install_Directory]ViewUnOfficialPDF based on the type of print. This is used to show a resulting pdf on the Download page. The setting is a timeout of how long to keep a report before it gets removed from one of these directories.