Sub-topic 2.1: Multi-Level Grouping Engine & Group Lifecycle

ลำดับการประมวลผลเมื่อเกิด Group Break Event:

[Record N Ingestion] -> Evaluate Group Expression
   │
   ├─ If Changed (!Objects.equals(old, new)):
   │    1. Trigger  (Inner to Outer)
   │    2. Reset Variables (resetType="Group")
   │    3. Evaluate Pagination Constraints (minHeight)
   │    4. Trigger  (Outer to Inner)
   │    5. Render Detail Band
   └─ If Unchanged:
        1. Render Detail Band
        2. Accumulate Variables

กฎเหล็กระดับ Production (Key Production Attributes):

• minHeightToStartNewPage: สกัดกั้น Orphan Group Header หากพื้นที่ท้ายกระดาษเหลือน้อยกว่าค่าที่กำหนด จะตัดขึ้นหน้าใหม่ทันทีก่อนวาด Header
• reprintHeaderOnEachPage="true": พิมพ์ Group Header ซ้ำอัตโนมัติบนยอดหน้าถัดไปเมื่อเนื้อหาในกลุ่มไหลข้ามหน้า
• keepTogether="true": ล็อก Header + Detail ทั้งหมด + Footer ให้อยู่หน้าเดียวกันหากเป็นไปได้
• resetType="Group" + resetGroup="...": บังคับล้างผลรวม Subtotal กลับเป็น 0 เมื่อจบคอลเลกชันของกลุ่มนั้น

<!-- JRXML 7.0.x: Nested Group Architecture -->
<jasperReport xmlns="http://jasperreports.sourceforge.net/jasperreports"
              name="GroupedLedger" pageWidth="595" pageHeight="842"
              columnWidth="555" leftMargin="20" rightMargin="20"
              topMargin="20" bottomMargin="20"
              whenNoDataType="AllSectionsNoDetail">

    <field name="department" class="java.lang.String"/>
    <field name="category" class="java.lang.String"/>
    <field name="amount" class="java.math.BigDecimal"/>

    <!-- Variable: Isolated Category Subtotal -->
    <variable name="CAT_SUBTOTAL" calculation="Sum"
              resetType="Group" resetGroup="CategoryGroup"
              class="java.math.BigDecimal">
        <expression><![CDATA[$F{amount}]]></expression>
        <initialValueExpression><![CDATA[BigDecimal.ZERO]]></initialValueExpression>
    </variable>

    <!-- Outer Group: Department -->
    <group name="DeptGroup" isStartNewPage="true">
        <expression><![CDATA[$F{department}]]></expression>
        <groupHeader>
            <band height="30">
                <element kind="textField" x="0" y="5" width="555" height="20">
                    <expression><![CDATA["DEPT: " + $F{department}]]></expression>
                </element>
            </band>
        </groupHeader>
    </group>

    <!-- Inner Group: Category -->
    <group name="CategoryGroup" minHeightToStartNewPage="120" reprintHeaderOnEachPage="true">
        <expression><![CDATA[$F{category}]]></expression>
        <groupHeader>
            <band height="25">
                <element kind="textField" x="20" y="2" width="535" height="20">
                    <expression><![CDATA["> CATEGORY: " + $F{category}]]></expression>
                </element>
            </band>
        </groupHeader>
        <groupFooter>
            <band height="25">
                <element kind="textField" x="355" y="2" width="200" height="20" pattern="#,##0.00">
                    <expression><![CDATA[$V{CAT_SUBTOTAL}]]></expression>
                </element>
            </band>
        </groupFooter>
    </group>

    <detail>
        <band height="20" splitType="Prevent">
            <element kind="textField" x="40" y="0" width="315" height="18">
                <expression><![CDATA[$F{amount}]]></expression>
            </element>
        </band>
    </detail>
</jasperReport>