ForNAV Report Service Configuration

The ForNAV Report Service is configured through a JSON file located at:

C:\ProgramData\ForNAV\Report Service\Configuration\Report Service.json

Changes to this file require a restart of the ForNAV Report Service Windows service to take effect.

Default configuration

{
  "Url": "http://localhost:9030/ForNavReportService/",
  "CertificateThumbprint": "",
  "MaxConcurrentRequests": 100,
  "MaxConcurrentTasks": 1,
  "DebugLevel": 0
}

Settings reference

Setting	Default	Description
Url	http://localhost:9030/ForNavReportService/	The base URL the service binds to and listens on
MaxConcurrentRequests	100	Maximum number of HTTP requests the service will handle simultaneously
MaxConcurrentTasks	1	Maximum number of report rendering tasks allowed to run in parallel
DebugLevel	0	Controls the verbosity of the service log output

Url

The endpoint the Report Service exposes. The Business Central service tier must be able to reach this URL. The service tier must run on the same machine as the Report Service.

MaxConcurrentRequests

Controls how many incoming HTTP requests the service processes at the same time. Requests that exceed this limit are not queued.

MaxConcurrentTasks

Controls how many report rendering operations run in parallel. Report rendering is CPU- and memory-intensive; running multiple renders simultaneously can exhaust resources on the host machine.

The default value of 1 serialises all rendering. Increase this value only if:

• The host machine has multiple physical CPU cores available for rendering, and
• Memory is sufficient to hold multiple report jobs in memory at once.

Setting MaxConcurrentTasks higher than the number of available CPU cores typically reduces overall throughput rather than improving it.

DebugLevel

Controls how much detail the service writes to its log. Higher values produce more output.

Value	Level
0	Off — no logging
1	Messages only
2	Request and response files

Use level 2 temporarily when diagnosing a problem. Revert to 0 afterwards to avoid excessive log growth in production.

Log files are written to this folder:

  C:\ProgramData\ForNAV\Report Service\Logs

Applying changes

1. Edit Report Service.json with a text editor
2. Save the file
3. Open Services (services.msc)
4. Locate ForNAV Report Service
5. Right-click and select Restart

The service reads the configuration file on startup. The new settings take effect immediately after the restart completes.