This is an automated email from the ASF dual-hosted git repository.
lukaszlenart pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/main by this push:
new 096e475d6 WW-5732 docs: the JasperReports 7 format is matched
case-insensitively from 7.4.0 (#341)
096e475d6 is described below
commit 096e475d6d040ac2458625336563966ae23b6571
Author: Lukasz Lenart <[email protected]>
AuthorDate: Thu Sep 24 18:06:01 2026 +0200
WW-5732 docs: the JasperReports 7 format is matched case-insensitively from
7.4.0 (#341)
Matches apache/struts#1922: JasperReport7Result retries the exporter lookup
with the lower-cased format when there is no exact match, so upper-case
values carried over from the 6.x plugin (CSV, PDF) resolve again. Lower-case
stays the canonical spelling; keeps a note on the 7.3.0 case-sensitive
behavior for readers on that release.
Co-authored-by: Claude Opus 5.5 (1M context) <[email protected]>
---
source/plugins/jasperreports7/index.md | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/source/plugins/jasperreports7/index.md
b/source/plugins/jasperreports7/index.md
index df1c99619..0f6879db3 100644
--- a/source/plugins/jasperreports7/index.md
+++ b/source/plugins/jasperreports7/index.md
@@ -40,7 +40,8 @@ The result takes the following parameters:
- parse - `true` by default, if set to false, the location param will not be
parsed for EL expressions
- format - the format in which the report should be generated. Valid values
are the lower-case constants from
`JasperReport7Constants`: `pdf`, `xml`, `html`, `xlsx`, `csv` and `rtf`.
The value selects the exporter bean by
- name, so it is case-sensitive. If no format is specified, `pdf` will be used
+ name; since 7.4.0 a name with no exact match is retried in lower case, so
`CSV` selects the `csv` exporter
+ (7.3.0 and earlier match case-sensitively). If no format is specified,
`pdf` will be used
- contentDisposition - disposition (defaults to "inline", values are
typically `filename="document.pdf"`)
- documentName - name of the document (will generate the http header
`Content-disposition = X; filename=X.[format]`)
- reportParameters - OGNL expression used to retrieve a map of report
parameters from the value stack.
@@ -216,7 +217,9 @@ Use the same `JASPERREPORTS_VERSION` as the `jasperreports`
artifact pulled in b
The result parameters shared with the [JasperReports Plugin](../jasperreports)
behave the same way. What changed:
- the package is `jasperreports7-default` and the result type is
`jasperReport7`
- - `format` values are lower-case (`pdf` instead of `PDF`); `xls` is gone, use
`xlsx`
+ - `format` values are lower-case (`pdf` instead of `PDF`); since 7.4.0 the
upper-case 6.x values still resolve
+ ([WW-5732](https://issues.apache.org/jira/browse/WW-5732)), but 7.3.0 and
earlier reject them; `xls` is gone,
+ use `xlsx`
- the `delimiter` and `imageServletUrl` result parameters are gone; use the
constants from [Settings](#settings)
or `JasperReport7Aware.getCsvDelimiter` instead
- the `exportParameters` result parameter is gone; exporter configuration is
done in code by a
