Describe jmix.reports.multilineStringsProcessingEnabled property for the Report add-on #981

Author: sukhova

content/modules/reports/pages/configuration.adoc

@@ -83,6 +83,13 @@ Activates the xref:exec-history.adoc[report execution history] mechanism.
 
 Default value: `false`.
 
+[[jmix.reports.multilineStringsProcessingEnabled]]
+=== jmix.reports.multilineStringsProcessingEnabled
+
+Enables processing of multi-line strings in parameter values for DOCX report templates. When enabled (`true`), line break characters (`\n`, `\r\n`) present in parameter values are rendered as actual line breaks in the generated DOCX document. This functionality is only applied when using a xref:creation/templates.adoc#template_doc[DOCX template].
+
+Default value: `false`.
+
 [[jmix.reports.office-path]]
 === jmix.reports.office-path
 

content/modules/reports/pages/creation/templates.adoc

@@ -141,6 +141,15 @@ select cast(e.year as varchar(4)) as "year"
 ----
 ====
 
+[TIP]
+====
+*Processing Multi-line Strings in DOCX Templates*
+
+By default, line breaks in parameter values are ignored when generating a report. To preserve line breaks (e.g., `\n` or `\r\n`) in the final DOCX output, you must enable the xref:configuration.adoc#jmix.reports.multilineStringsProcessingEnabled[jmix.reports.multilineStringsProcessingEnabled] application property.
+
+*This feature is exclusive to the DOCX report output format and has no effect on other formats like XLSX or PDF.*
+====
+
 [[template_html]]
 === HTML Template