Page 5 - Report Runner Viewer INI Settings Reference
General Notes
JNRRV.INI is the main Viewer settings file. By default, it lives in C:\Users\Public\Documents\Jeff-Net\Report Runner Viewer.jnrrv-backup.ini is the master backup/default file that can be replaced by software updates. The main JNRRV.INI is not ever overwritten by new releases/updates/installers.- Most switches use
1 for on/active and 0 for off/inactive. The meaning still depends on the setting name: Hide...=1 hides something, Lock...=1 disables editing, and Show...=1 shows something.
- Some older settings use
YES / NO, Y / N, or ON / OFF. The live INI shows the expected style for most settings. These remain active for backward compatibility (of settings and software that have been in use for over 25 years).
- Blank values usually mean "do not override" or "use the built-in/default behavior."
- Prefer lock settings over hide settings when users should know what value is being used. A locked field lets users see the setting but prevents edits/changes.
File Locations And Multi-User Behavior
Report Runner Viewer can either use one shared JNRRV.INI for everyone or create a separate user settings file for each Windows user/machine.
| Setting group |
File |
Notes |
| Main Viewer settings |
JNRRV.INI |
Settings for the Viewer application. This file controls most interface, login, report viewer, export, mail, and Enterprise behavior. |
| Master backup/default |
jnrrv-backup.ini |
Backup copy of available settings. This can be replaced by updates; do not use it for permanent customer customizations. Note, this file can generally NOT be used to "restore" your JNRRV.INI file. |
| Multi-user template |
jnrrv-multiuser-template.ini |
Used to initialize new per-user INI files when Per-user settings are enabled (usually in a Citrix/Terminal Server environment). If you have "starter" settings you want to use for new users, set them here (you can then change them in their per-user file below) |
| Per-user settings |
[machine]_[windows-user].ini |
Created when SaveMultipleIDs=1 or SaveMultipleDSNDatabaseAndPaths=1. Location is controlled by SaveMultipleConfigFileInUsersMyDocuments. |
| Enterprise SQL config |
ev.ini beside Enterprise data files |
Used only when Enterprise Viewer data files indicate SQL mode (vs XML storage mode). Contains encrypted SQL Connection String and Schema. |
For a shared Citrix/Terminal Server setup, the support article recommends SaveINISettingsOnExit=0, SaveMultipleIDs=0, and SaveMultipleDSNDatabaseAndPaths=0. For user-specific Citrix/Terminal Server settings, use SaveINISettingsOnExit=1, SaveMultipleIDs=1, SaveMultipleDSNDatabaseAndPaths=1, and optionally (but not recommended) SaveMultipleConfigFileInUsersMyDocuments=1.
[Options]
Main Window Buttons
These control the buttons on the main Viewer screen.
| Setting |
Values |
Notes |
LockViewButton |
1 or 0 |
1 disables the normal View Report button. Use this when users may browse reports but should not only be able to view reports with Saved data (and not run live/refreshed reports). |
LockViewSavedButton |
1 or 0 |
1 disables the View Saved Data button. This is useful when you do not want saved data in reports to be seen/viewed. |
LockReportInformationButton |
1 or 0 |
1 disables the Report Information button. Users can see the button but cannot open the report information view. |
LockFavoritesButton |
1 or 0 |
1 disables the Favorites button and Add to Favorites command. Existing favorites remain stored, but users cannot manage or use them from the main UI. |
HideViewButton |
1 or 0 |
1 hides the normal View Report button. Use carefully, because hiding gives the user less explanation than locking. |
HideViewSavedButton |
1 or 0 |
1 hides the View Saved Data button. Common in locked-down environments where users should only run reports one way. |
HideReportInformationButton |
1 or 0 |
1 hides the Report Information button. |
HideFavoritesButton |
1 or 0 |
1 hides Favorites and the Add to Favorites right-click command. |
HideRibbonTabHelp |
1 or 0 |
1 hides the Help tab in the ribbon/menu area. |
HideRibbonTabAbout |
1 or 0 |
1 hides the About tab in the ribbon/menu area. |
HideAdvancedDataConnection |
1 or 0 |
1 hides the Advanced Data Connection button. Use this when users should not create or edit per-table login overrides. |
LockAdvancedDataConnection |
1 or 0 |
1 disables the Advanced Data Connection button but leaves it visible. This is usually friendlier than hiding it when users need to know an ADC exists. |
Main Window Panels
These control the left folder browser, right data connection panel, and bottom record selection panel.
| Setting |
Values |
Notes |
LockLeftBrowse |
1 or 0 |
1 disables the left browse/folder panel. The folder panel remains visible but cannot be changed by the user. |
LockRightDataConnection |
1 or 0 |
1 disables the login/data connection panel. This is useful when an administrator sets the ID, password, DSN, or database and wants users to see but not edit them. |
LockBottomRecordSelection |
1 or 0 |
1 disables the record selection panel. Users can see the area but cannot edit/select criteria from it. |
HideLeftBrowse |
1 or 0 |
1 hides the left browse/folder panel. Use this with HighPath or DefaultPath when the Viewer should be locked to a known location. |
HideRightDataConnection |
1 or 0 |
1 hides the login/data connection panel. See IgnoreHideRightDataConnectionIfWindowsID if an administrator still needs access. |
AutoHideRightDataConnectionBar |
1 or 0 |
1 starts the right data connection panel in auto-hide mode, but only when the panel is visible, enabled, and user configuration is allowed. |
HideBottomRecordSelection |
1 or 0 |
1 hides the record selection panel. Helpful when users should not manually edit Crystal record selection syntax. |
DisableUserConfigurationOfLeftBrowse |
1 or 0 |
1 prevents users from pinning/unpinning or auto-hiding the left browse panel. |
DisableUserConfigurationOfRightDataConnection |
1 or 0 |
1 prevents users from changing the docking/auto-hide behavior of the right data connection panel. |
DisableUserConfigurationOfBottomRecordSelection |
1 or 0 |
1 prevents users from changing the docking/auto-hide behavior of the record selection panel. |
IgnoreHideRightDataConnectionIfWindowsID |
Windows ID, blank |
Lets one Windows user bypass HideRightDataConnection=1. Use the form DOMAIN\UserName or the value shown in the log. This is useful for an admin who needs to configure ADC files while normal users cannot see the panel. |
Login And Data Connection Area
These control the visible login fields and how Viewer applies saved IDs, passwords, DSNs, and database overrides.
| Setting |
Values |
Notes |
ShowLoginIDAndPasswordOnly |
1 or 0 |
1 limits the right-side login area to only ID and password. DSN/database override controls are not shown. |
LockID |
1 or 0 |
1 disables the User ID field while leaving it visible. Useful when a saved ID should be used but not changed. |
LockPassword |
1 or 0 |
1 disables the password field while leaving it visible. |
SavePassword |
1 or 0 |
1 allows the Viewer to save the password when settings are saved on exit. Passwords are stored encrypted by the application. |
LoadDSNs |
1 or 0 |
1 loads DSNs from the Windows registry into the DSN dropdown. Set to 0 if registry DSN loading is slow, confusing, or not wanted. |
OverrideDatabaseScheme |
schema/owner name, blank |
Adds a schema/owner prefix when setting table locations. Use only when reports need to run under a different database owner/schema than the one saved in the report. |
ResetLoginAfterCommandTable |
1 or 0 |
Legacy/support option intended for reports using command tables. It is present in the wrapper but the active call path appears commented in current source. |
PromptEachReportForLogon |
1 or 0 |
1 prompts for an optional ID/password each time a report is run. Useful when users should not store credentials in the INI. |
UseINIIDAndPasswordToRunPassedReports |
1 or 0 |
1 uses [Standard Viewer] ID and PW when reports are launched by command line or externally passed report paths. |
DisableIDAndPasswordsForXBaseConnections |
1 or 0 |
1 prevents ID/password values from being applied to xBase connections for global/manual login modes. Helpful for file-based connections that fail when credentials are forced. |
DisableIDAndPasswordsForXMLConnections |
1 or 0 |
1 prevents ID/password values from being applied to ADO.NET XML connections for global/manual login modes. |
DisableIDAndPasswordsForAccessExcelConnections |
1 or 0 |
1 prevents normal ID/password values from being applied to Access/Excel DAO connections. The code uses admin with blank password in this path. |
DisableDSNAndDatabaseValidation |
1 or 0 |
Source-supported, not in the stock live INI. 1 skips validation of DSN/database override choices on the main Viewer screen. Comments say this should normally not be needed. |
UseAlternateLogonLogic |
1 or 0 |
Source-supported, not in the stock live INI. 1 uses the newer alternate PropertyBag login logic instead of the historical Crystal login path. Use as a Support-recommended fallback option. |
BypassSetLocation |
1 or 0 |
Support option that changes how Crystal table locations are processed during login. Leave at 0 unless troubleshooting a connection issue. |
IgnoreTestConnectivity |
1 or 0 |
When not 0, Viewer continues even if Crystal TestConnectivity fails for a table. This avoids false failures but can also defer connection errors until the report actually runs. |
DisableCrystalRegistryUpdates |
1 or 0 |
Support option for Crystal runtime registry update behavior. Leave at 0 unless Support recommends otherwise. |
BypassAutomaticOLEDBLoginFix |
1 or 0 |
Source-supported support option used by shared Crystal login logic. Not in the stock Viewer INI. |
Folder Browsing And Startup Path
| Setting |
Values |
Notes |
ShowAllDirectories |
1 or 0 |
1 allows normal directory browsing. |
DoNotLoadDriveList |
comma list, blank |
List drive letters to exclude from the left folder tree, such as X,Y,Z. Useful when mapped/network drives are slow, unavailable, or should not be shown. |
DefaultToSavedDataReportsFirst |
1 or 0 |
1 changes the command-line Viewer path to prefer saved-data viewing first. Mainly useful for external launch scenarios. |
Path limits and starting folders are set in [Standard Viewer] or per-user [Settings] with LastPath, HighPath, and DefaultPath.
Report Viewer Window And Crystal Toolbar
These affect the pop-up report viewer window after a report opens.
| Setting |
Values |
Notes |
HidePrintButton |
1 or 0 |
1 hides the small Crystal toolbar Print button. This does not necessarily hide the larger Report Runner print button. |
HideGroupTreeButton |
1 or 0 |
1 hides the Crystal group tree button. |
HideExportButton |
1 or 0 |
1 hides the small Crystal toolbar Export button. Report Runner's alternate export button is controlled separately. |
HideCopyButton |
1 or 0 |
1 hides the small Crystal toolbar Copy button. |
HideRefreshButtonForSavedData |
1 or 0 |
1 hides the Crystal toolbar Refresh button when the report is opened with saved data. This is the usual safe default for saved-data reports. |
ShowParametersPanelFor2008AndGreater |
1 or 0 |
1 shows Crystal's parameter panel for Crystal Reports 2008 and later. Default 0 keeps the interface simpler for most users. |
EnableViewerAutoCloseAtHowManyMinutes |
minutes, 0 |
Auto-closes open report viewer windows after this many minutes. 0 disables auto-close. |
DisableUserConfigurationOfViewerAutoClose |
1 or 0 |
1 prevents users from disabling/changing the auto-close checkbox in the report viewer. |
MaximizeViewerWindow |
1 or 0 |
1 opens report viewer windows maximized. |
ZoomViewer |
1, 2, or percent |
1 means actual size. 2 means full page. Other numeric values are treated as a percent, such as 65. |
HideViewerToolBarOnMaximize |
1 or 0 |
1 hides the Report Runner toolbar area when the viewer window is maximized. |
HideViewerStatusBarOnMaximize |
1 or 0 |
1 hides the Report Runner status bar area when the viewer window is maximized. |
AlwaysHideViewerToolBar |
1 or 0 |
1 always hides the Report Runner toolbar area in the report viewer. If both always-hide settings are on, the bottom panel is also hidden automatically. |
AlwaysHideViewerStatusBar |
1 or 0 |
1 always hides the Report Runner status bar area in the report viewer. If both always-hide settings are on, the bottom panel is also hidden automatically. |
SaveLastViewerWindowSizeAndLocation |
1 or 0 |
1 saves each report viewer window's size, position, maximized state, and zoom in [Window Sizes And Locations]. |
EnableDrillDown |
1 or 0 |
1 allows Crystal drill-down behavior. Set 0 to disable drill-down in the report viewer. |
SuppressParameterRefreshPrompt |
1 or 0 |
1 suppresses Crystal's parameter refresh prompt. Use when users should not be prompted again during refresh. |
HidePrinterSetupButton |
1 or 0 |
Wrapper exists in jnINIViewer.vb, but the current report viewer form does not appear to actively call it. Treat as source-supported/legacy. |
Report Viewer Bottom Buttons
| Setting |
Values |
Notes |
HideEmailButton |
1 or 0 |
1 hides the Email button in the report viewer. |
HideEmailSettingsButton |
1 or 0 |
1 hides the Settings button on the email window. Use after mail settings are centrally configured. |
HideAlternateExportButton |
1 or 0 |
1 hides Report Runner's alternate/custom export button in the report viewer. |
HideCopyToClipboardButton |
1 or 0 |
1 hides the larger Copy to Clipboard button in the Report Runner button area. |
EnableClickAndCopyToClipboard |
1 or 0 |
1 enables click-and-copy behavior from the viewer. Use only when users need that workflow. |
HideCopyReportDataButton |
1 or 0 |
Default hidden. Set to 0 to show the button. When shown, it fetches data from a report formula named {@jnViewerCopyAndPaste}. |
HideEZPrintButton |
1 or 0 |
Default hidden. Set to 0 to show the large EZ Print button, useful for kiosk/touch/warehouse-style users. |
ShowAlerts |
0, 1, 2 |
0 disables alert display. 1 shows alerts when report alerts exist. 2 always shows the Alerts button. Invalid values reset to 1. |
Export Window
| Setting |
Values |
Notes |
HideExportBrowseButton |
1 or 0 |
1 hides the Browse button on the Report Runner export window. |
HideExportButtonInExport |
1 or 0 |
1 hides the Export button inside the export window. Useful when only "Export and Open" should be available. |
DoNotOpenWindowsExplorerAfterExport |
1 or 0 |
1 prevents Windows Explorer from opening after export. |
HideExportAndOpenButton |
1 or 0 |
1 hides the Export and Open/Quick View button. |
DefaultExportSelection |
number |
Source-supported, not in the stock live INI. Sets the default selected export format in the export window. Users count from 1; internally the code subtracts one. Invalid/blank defaults to the PDF-with-bookmarks selection. |
Default export folders are stored under [Global Options] as DefaultExportDirectory1 through DefaultExportDirectory20, or in per-user [Settings] files when multi-user settings are enabled.
Email And SMTP Behavior
Mail identity fields live under [Global Options] or per-user [Settings], but these transport/security switches live under [Options].
| Setting |
Values |
Notes |
MailPort |
number |
SMTP port. Current code defaults to 587 if blank/missing. Common values are 25, 465, and 587. |
MailSSL |
1 or 0 |
Enables SMTP SSL behavior. Use with the correct port and server requirements. |
MailTLS |
1 or 0 |
Enables SMTP StartTLS behavior. Current code defaults to 1 if blank/missing. |
MailSSLTLSAllowedCiphers |
comma list, blank |
Advanced SMTP cipher restriction. Blank allows normal/default cipher behavior. Only use when a mail server requires specific cipher handling. |
MailSSLTLSProtocol |
DEFAULT, protocol value |
Advanced SMTP protocol setting. Blank defaults to DEFAULT. Examples in code include TLS 1.2, TLS 1.1, TLS 1.0, SSL 3.0, and "or higher" variants. |
Auto-Refresh
| Setting |
Values |
Notes |
EnableViewerRightClickAutoRefresh |
1 or 0 |
1 enables the right-click auto-refresh feature in the report viewer. |
ShowViewerButtonsDuringAutoRefresh |
1 or 0 |
1 keeps viewer buttons visible during auto-refresh. Default 0 hides/simplifies the interface during refresh. |
MaximumAutoRefreshLimit |
minutes |
Minimum allowed refresh interval. Values less than or equal to zero, blank, or non-numeric values fall back to a very high limit. |
EnableAutoRefreshCountDown |
1 or 0 |
1 shows the refresh countdown. Set 0 to hide the countdown text. |
Multi-User, Citrix, RDP, Terminal Server
| Setting |
Values |
Notes |
SaveMultipleIDs |
1 or 0 |
1 stores each user's ID, password, mail settings, favorites, and export directories in a per-user INI file instead of the shared JNRRV.INI. |
SaveMultipleDSNDatabaseAndPaths |
1 or 0 |
1 stores each user's DSN, database, LastPath, HighPath, and DefaultPath in a per-user INI file. |
SaveMultipleConfigFileInUsersMyDocuments |
1 or 0 |
1 stores the per-user INI under the user's Documents folder at Jeff-Net\Report Runner Viewer. 0 stores it beside JNRRV.INI. |
SaveINISettingsOnExit |
1 or 0 |
1 allows Viewer to save settings on exit. Set 0 for a shared locked-down setup where users should not change the shared INI. |
Report Results And Prompts
| Setting |
Values |
Notes |
ShowZeroRecordsReports |
1 or 0 |
1 still opens a report that returns zero records. 0 stops and shows "Report produced zero records. There is nothing to display." |
DisableFindParameterWindow |
1 or 0 |
1 prevents the parameter utility/search window from launching (it's a separate executable). Use if the helper window is unwanted or causes support issues. |
HideThereIsNothingToPrintMessage |
1 or 0 |
1 suppresses the pop-up message when there is nothing to print. |
Interface Style And Customization
| Setting |
Values |
Notes |
HideStyleAndColorCustomization |
1 or 0 |
1 hides the end-user style/color customization area on the main Viewer screen. |
DisableCreateShortcutsInMenu |
1 or 0 |
1 disables creation of shortcut menu items. This also affects Enterprise shortcut/loading behavior. |
HideSaveTemplateButton |
1 or 0 |
1 hides the Save Template button in the mail window. Users can still retrieve templates if the Get Template button remains visible. |
ShowLegacyNoSecurityLabel |
1 or 0 |
1 restores the older "No Security" wording in the login area. Default/current UI uses friendlier wording. |
Debug, Logging, Startup, And Support
| Setting |
Values |
Notes |
DEBUG |
YES or NO |
Enables general debug logging. The main Viewer has a debug toggle that writes this value. |
HideLogPasswords |
ForceNo, anything else |
Passwords are now hidden by default. The only value that shows passwords in plain text is ForceNo. Old 0/1 behavior is now intentionally ignored to prevent the accidental displaying of passwords in plain text. |
BypassAmpersandRemoval |
1 or 0 |
1 bypasses automatic ampersand removal in string cleanup logic. Use only if ampersands are being incorrectly changed. |
BypassFileMaintenance |
1 or 0 |
1 skips built-in file maintenance. Leave at 0 unless you are handling cleanup externally. Turning this off is not recommended. |
UsePrintMethod2 |
1 or 0 |
Uses alternate print logic when enabled. Leave off unless Support is troubleshooting print behavior. |
ParameterCommaReplacement |
character/string |
Replacement text used when parameter values contain commas and the app needs to safely parse selected values. Live INI uses \. |
[Global Options]
Mail Identity And Defaults
These settings are used by the Viewer email window. In multi-user mode they may be stored in each user's [Settings] file instead.
| Setting |
Values |
Notes |
MailDelivery |
SMTP, token/OAuth-related values |
Mail delivery type. SMTP is the common/default value. Token/OAuth usage stores token-related information in the authentication fields. |
Server |
mail server |
SMTP server name, such as smtp.office365.com, unless using the built-in Report Runner server option. |
MailAccount |
email address |
The default From address. The mail window places this in the From Address field unless Enterprise AD supplies the user address. |
MailName |
display name |
The friendly From name shown to recipients. Example: Report Runner Viewer or a user's name. |
AuthenticationID |
login ID or token path |
SMTP authentication user name, or a token/OAuth JSON file path depending on mail setup. Supports special string variables in the mail window. |
AuthenticationPassword |
password/token secret |
Mail password or token-related secret. This is encrypted by the app when saved through supported paths. |
CC |
email address list |
Default carbon-copy recipients for Viewer emails. Users can still edit the email before sending unless the interface is customized. |
BCC |
email address list |
Default blind-copy recipients for Viewer emails. Recipients do not see BCC addresses. |
UseFreeServer |
Y/N, 1/0 |
When checked/on, Viewer uses the Report Runner SMTP server settings instead of the custom SMTP fields. |
DefaultMailSubject |
text |
Default subject placed into the Viewer mail window. Users can edit it before sending. |
DefaultMailMessage |
text or file path |
Default message body. If the value points to an existing file, the file content is loaded as the message body. This is handy for standard signatures or instructions. |
IMAPServer |
server, blank |
IMAP server for mail-related features that need to read mail. Blank means not configured. |
IMAPPort |
number |
IMAP port. Code defaults to 993 when blank or invalid. |
IMAPBox |
mailbox/folder, blank |
IMAP folder/mailbox name. Blank means not configured. |
SMTPTimeOutRead |
seconds |
Source-supported mail timeout. Defaults to 60 if missing/invalid. Not in the live stock Viewer INI. |
SMTPTimeOutConnect |
seconds |
Source-supported SMTP connect timeout. Defaults to 60 if missing/invalid. Not in the live stock Viewer INI. |
SMTPErrorRetries |
count |
Source-supported retry count. Defaults to 5 if missing/invalid. Not in the live stock Viewer INI. |
Export Folders And Favorites
| Setting |
Values |
Notes |
DefaultExportDirectory1 through DefaultExportDirectory20 |
folder path, blank |
Quick-pick export folders shown in the Report Runner export window. Viewer adds new folders as users export files, unless temp-export-only mode is active. |
Favorite-1 through Favorite-100 |
report path, blank |
Stored favorite report paths. In multi-user mode, favorites are saved in the per-user [Settings] file instead of shared JNRRV.INI. |
App Data, Archive, And Shared Folders
| Setting |
Values |
Notes |
DefaultAppDataFolder |
folder path |
Overrides the application data folder. If missing for Viewer, startup sets it to the main Viewer folder. This controls subfolders such as Settings, Templates, and temp/cache paths. |
DefaultArchiveFolder |
folder path, blank |
Archive destination folder used by shared file maintenance/archive logic. Blank disables/avoids archive setup. |
ArchiveFolderDays |
number |
Days to keep files in archive maintenance logic. Live INI uses 36500, effectively a very long retention period. |
ArchiveFailureTriggersError |
Y/N |
Y treats archive failures as errors. |
DefaultOutputFolder |
folder path |
Source-supported shared output folder. Not present in the live Viewer INI, but startup reads it through common application setup. |
DefaultWorkFolder |
folder path |
Source-supported shared work folder. Not present in the live Viewer INI, but startup reads it through common application setup. |
[Standard Viewer]
These are the standard, non-Enterprise Viewer defaults.
| Setting |
Values |
Notes |
LastPath |
folder path |
Last folder opened in the Viewer. If no DefaultPath is set, Viewer tries this folder when starting. |
HighPath |
folder path, optional/commented |
Restricts Viewer to this folder and below. If the starting folder is outside HighPath, Viewer blocks startup and asks the user to contact the administrator. UNC paths are supported. |
DefaultPath |
folder path, optional/commented |
Preferred startup folder. If set, Viewer starts here instead of LastPath. |
NoSecurityChecked |
Y or N |
Controls the "no saved login/security" checkbox state. Use Y when reports should run without applying saved ID/password values. |
ID |
user ID |
Default database login ID for standard Viewer reports. Stored as plain text in the current main INI path; per-user mode encrypts user-specific ID. |
PW |
password |
Default database login password. Saved encrypted when written through the application. |
DSNChecked |
Y or N |
Whether Viewer should override the DSN saved in the report. |
DSN |
DSN/server value |
DSN override value used when DSNChecked=Y. |
DatabaseChecked |
Y or N |
Whether Viewer should override the database saved in the report. |
Database |
database name |
Database override value used when DatabaseChecked=Y. |
CommentsColumnOn |
1 or 0 |
1 shows an extra report information/comments column in the report list. |
CommentsColumnHeader |
text |
Column header for the optional comments/report information column. |
CommentsColumnContent |
Comments, Title |
Selects what appears in the optional comments column. Live comments say use Comments or Title. |
[Enterprise Viewer]
Enterprise Viewer can use XML files, SQL-backed Enterprise data, or Active Directory/LDAP-backed users depending on license and configuration.
| Setting |
Values |
Notes |
UserDataFile |
file path |
Enterprise users/groups data file. If this file and ReportsDataFile contain SQL, the app reads SQL settings from ev.ini beside those files. |
ReportsDataFile |
file path |
Enterprise reports data file. Required for Enterprise report assignments. |
CommentsColumnOn |
1 or 0 |
Same idea as Standard Viewer, but for Enterprise report lists. |
CommentsColumnHeader |
text |
Header for the Enterprise report information/comments column. |
CommentsColumnContent |
Comments, Title |
Selects Enterprise report list column content. |
ADPath |
domain/server/path |
Legacy Enterprise Active Directory path setting. If populated with valid Enterprise files, Viewer treats Enterprise as AD-enabled. |
ADFilter |
LDAP filter/base text |
Legacy AD filter/base setting. Blank or jnnothing is treated as blank. |
ADMethod |
number |
AD lookup method. Code defaults missing values to 3. |
ADAutoFillID |
1 or 0 |
Source-supported. When not 0, Enterprise AD can auto-fill the user ID. |
ADAutoFillPW |
1 or 0 |
Source-supported. When not 0, Enterprise AD can auto-fill the password. |
ADID |
user ID |
Legacy LDAP/AD bind ID for non-LDAPS mode. Blank or jnnothing means not set. |
ADPW |
password |
Legacy LDAP/AD bind password. If not encrypted, startup encrypts it. |
LMODE |
LDAP or LDAPS |
LDAP mode. LDAPS triggers the newer LDAPS settings below; anything else uses legacy LDAP settings. |
LSERVER |
server name |
LDAPS server name. |
LBASE_DN |
base DN |
LDAP base distinguished name, such as DC=example,DC=local. |
LPORT |
number |
LDAPS port. Live INI uses 636. |
LID |
user ID |
LDAPS bind/login ID. |
LPW |
password |
LDAPS password. If not encrypted, startup encrypts it. |
LUPN_DOMAIN |
domain |
UPN domain appended/used for Enterprise AD login handling. |
NoSecurityChecked |
Y or N |
Enterprise default login checkbox state when Enterprise does not provide a user-specific login. |
ID |
user ID |
Enterprise default database login ID. |
PW |
password |
Enterprise default database password. Saved encrypted when written through the application. |
DSNChecked |
Y or N |
Whether Enterprise Viewer should override the DSN. |
DSN |
DSN/server value |
Enterprise DSN override value. |
DatabaseChecked |
Y or N |
Whether Enterprise Viewer should override the database. |
Database |
database name |
Enterprise database override value. |
[Settings] Per-User INI Files
This section is in jnrrv-multiuser-template.ini and copied into per-user files. These values override the shared INI only when multi-user settings are enabled.
| Setting |
Values |
Notes |
NoSecurityChecked |
Y or N |
Per-user saved state for the no-login checkbox. |
ID |
encrypted user ID |
Per-user database login ID. The app encrypts it when saving. |
Password |
encrypted password |
Per-user database login password. The app encrypts it when saving. |
DSNChecked |
Y or N |
Per-user state for DSN override. |
DSN |
DSN/server value |
Per-user DSN override. |
DatabaseChecked |
Y or N |
Per-user state for database override. |
Database |
database name |
Per-user database override. |
LastPath |
folder path |
Per-user last folder. |
HighPath |
folder path |
Per-user folder restriction. |
DefaultPath |
folder path |
Per-user startup folder. |
TempExportsOnly |
1 or 0 |
1 forces exports to temporary files only. Users cannot choose the output file name/location, the file opens automatically, and temporary files are cleaned up when Viewer exits. Useful for data-security environments. |
MailDelivery |
SMTP, token/OAuth-related values |
Per-user mail delivery type. |
Server |
mail server |
Per-user SMTP/mail server. |
MailAccount |
email address |
Per-user From address. |
MailName |
display name |
Per-user From name. |
AuthenticationID |
login ID or token path |
Per-user SMTP login or token path. |
AuthenticationPassword |
encrypted password |
Per-user mail password/token secret. |
CC |
email address list |
Per-user default CC list. |
BCC |
email address list |
Per-user default BCC list. |
UseFreeServer |
Y/N, 1/0 |
Per-user use of the Report Runner SMTP server option. |
DefaultMailSubject |
text |
Per-user default email subject. |
DefaultMailMessage |
text or file path |
Per-user default email body or signature file. |
DefaultExportDirectory1 through DefaultExportDirectory20 |
folder path |
Created/saved dynamically for per-user export quick folders. These are not listed in the template but are supported by code. |
Favorite-1 through Favorite-100 |
report path |
Created/saved dynamically for per-user favorites when multi-user ID settings are enabled. |
[Application]
These are mostly UI appearance and saved column width settings. Users normally change these through the Viewer interface rather than hand-editing the INI.
| Setting |
Values |
Notes |
Style |
number |
Application style number selected by the style slider/control. |
ColorA |
0-255 |
Alpha/transparency portion of the saved application tint color. |
ColorR |
0-255 |
Red portion of the saved application tint color. |
ColorG |
0-255 |
Green portion of the saved application tint color. |
ColorB |
0-255 |
Blue portion of the saved application tint color. |
SyntaxColorScheme |
text/number |
Source-supported UI/editor color scheme setting. Not present in the live Viewer INI. |
[Groups and Users]
These are Enterprise Viewer admin/list column widths.
| Setting |
Values |
Notes |
ID |
number |
Saved width for the user/group ID column. |
First |
number |
Saved width for first name. |
Last |
number |
Saved width for last name. |
Group |
number |
Saved width for group name. |
Report Tags |
number |
Saved width for report tag assignments. |
[Reports]
These are Enterprise Viewer report list/admin column widths.
| Setting |
Values |
Notes |
Type |
number |
Saved width for report type. |
Name |
number |
Saved width for report display name. |
FileName |
number |
Saved width for report file path/name. |
Description |
number |
Saved width for report description. |
Report Tags |
number |
Saved width for report tag assignments. |
[Icons]
This section maps folder/category names to icon files in the Viewer settings/icons folder in the Enterprise edition.
| Setting |
Values |
Notes |
Default |
image file name |
Default folder/category icon. Live INI uses jnrr_folder_16.png. |
| any folder/category name |
image file name |
Commented examples include Docking, Help Desk, Sales, Shipping, Support, and Testing. Add a key matching the folder/category text to use a custom icon. |
[Sounds]
| Setting |
Values |
Notes |
SoundsOnOrOff |
ON or OFF |
Controls whether Viewer plays application sounds. Live/default value is ON. |
[HelpDesk]
| Setting |
Values |
Notes |
CompanyName |
text |
Company name used by help/support-related forms. |
UserName |
text |
User/contact name used by help/support-related forms. |
EmailAddress |
email address |
User/contact email used by help/support-related forms. |
[Developer]
These settings are mainly for branded/developer/custom builds.
| Setting |
Values |
Notes |
Company |
text |
Company/customer name used in developer/branding behavior. |
Logo187x64 |
image file path |
Custom logo path for Viewer/report viewer branding. If the file is missing, Viewer logs a warning and ignores it. |
URL |
URL, off, blank |
Custom URL opened from branded UI. off disables the custom click-through URL for developer-authorized builds. |
BackColor |
R,G,B |
Background color used by custom viewer branding. Live INI uses 0,0,64. |
ShowStatus |
YES or NO |
Controls whether custom/developer status text is shown. |
ErrorMessage |
text |
Message shown for command-line option problems or custom/developer error handling. |
[Crystal Engine] (and other undocumented [Groups])
These are advanced Crystal runtime cleanup/Support switches. Do NOT change (or "play" with) them unless Support recommends it.
[Auto-Backups]
Report Runner backups important settings locally in the main Report Runner (Jeff-Net) data directory in Public Documents. It stores them in the Viewer\Auto-Backups data folder. This is done automatically on a monthly basis. These backups, by default, are also uploaded to a unique and private Amazon S3 bucket. We do nothing with these backups unless a customer requests help in recovering from data loss. See our DPA regarding these backups.
| Setting |
Values |
Notes |
Backups |
ON or OFF |
Enables/disables application auto-backup behavior. |
UploadBackupToDropBox |
DISABLED |
This is a legacy settings as DropBox is no longer used. |
UploadBackupToAmazonS3 |
ON, OFF |
Controls Amazon S3 backup upload behavior. Present in the newer live INI. |
[Window Sizes And Locations]
This section is created/used only when SaveLastViewerWindowSizeAndLocation=1.
| Setting |
Values |
Notes |
| report file name |
maximized or Top,Left,Width,Height,Zoom |
Stores the last report viewer window position and zoom for a specific report. Maintained by the app. |
Common Locked-Down Viewer Examples
Note: The examples below are only PARTIAL displays of settings. Do NOT create an INI with only those settings.
One Shared Viewer For Everyone
Use this when every user should see the same folders, same login defaults, and same interface.
[Options]
SaveINISettingsOnExit=0
SaveMultipleIDs=0
SaveMultipleDSNDatabaseAndPaths=0
[Standard Viewer]
LastPath=C:\Reports
DefaultPath=C:\Reports
ID=
PW=
DSN=
Database=
User-Specific Viewer On Citrix/RDP
Use this when each user needs their own last folder, saved ID/password, DSN/database, email settings, favorites, or export folders.
[Options]
SaveINISettingsOnExit=1
SaveMultipleIDs=1
SaveMultipleDSNDatabaseAndPaths=1
SaveMultipleConfigFileInUsersMyDocuments=1
New users are initialized from jnrrv-multiuser-template.ini.
Simple Locked Folder And Data Connection
Use this when users should only work inside one folder and should not change the data connection.
[Options]
LockRightDataConnection=1
HideBottomRecordSelection=1
[Standard Viewer]
HighPath=K:\All Reports\Accounting
DefaultPath=K:\All Reports\Accounting
Data-Security Export Mode
Use this inside a per-user [Settings] file when users may export only to temporary files.
[Settings]
TempExportsOnly=1
With this on, Viewer chooses temporary export filenames, opens the exported file automatically, and cleans Viewer temp files on exit.
