Adjusting Partition-Limit in RML Runtime Configuration from Ambience/Repertoire 2024.0.8 onwards

Ambience 2020+
, ,
1

Overview

Instructions for modifying the partition-limit setting in the RML runtime configuration to address tree depth limitations in report generation when the following error is encountered:

ERROR c.e.r.l.StreamedSectionRenderer - Render failure: java.lang.RuntimeException: Body Partition depth limit 10 exceeded

Cause

The default partition limit has been set to 10 to prevent stack overflow errors caused by rendering rml templates to paginated PDF/XLSX outputs with the following design layout (potential deep recursion errors):

  • Over 10 levels of nested sub report elements
  • Over 10 group headers/footers
  • A combination of both

Steps to Adjust Partition-Limit

Add the following configuration in the application.conf file, located in the /etc folder of Ambience 202x directory:

elixir.rml.partition-limit = 100

Please restart the Ambience/Repertoire server to apply the changes.

Note:

  • The default partition-limit value is 10 , sufficient for most cases.
  • Increase the value (e.g., 20 , 50 , or higher) based on report size and complexity.