Skip to content

Report execution

Report execution fills a published Jasper definition with parameters and returns binary output in the format you choose.

Running from the viewer

  1. Open the catalog and select a report (or go to /reports/{key}).
  2. Supply parameters.
  3. Choose an output format.
  4. Run and download or view the result.

Map Reports add an interactive map step before fill — see Map Reports.

What happens on the server

  1. Authenticate (session or API Token — same ACL).
  2. Authorize the report for your user/groups.
  3. Resolve parameters (including Map Report-derived values when applicable).
  4. JasperReports fills against the configured datasource / JNDI context.
  5. Output is streamed as PDF, HTML, Excel, and so on.

Formats

Common formats include pdf, html, xlsx, xls, csv, docx, and others. Full list: Output formats and Supported formats.

Troubleshooting execution

If output is empty or fails:

  • Confirm datasource name and connectivity
  • Confirm parameter names and types
  • Check fonts/images/resources referenced by the JRXML
  • Ask an administrator to review Jasper internal URL and timeout settings

See Troubleshooting.


For Developers

Integration path Go here
Execute gateway REST API · Binary responses
CLI reports run CLI reports · Running reports from the CLI
SDK Reports.Run SDK overview