跳转到内容

Java 导出「售后服务工单台账」Excel 报表(合并与分组报表)

JQuick-Excel合并与分组报表

合并与分组报表场景 0047

按服务工程师归集售后工单,逐行算「服务费 = 服务时长 × 上门费单价」,每位工程师后跟一行服务费小计,末尾一行给出全部工单合计;工程师列纵向合并成一个区块。 Java 侧仅做分组与预处理,统计与版式全部由 XML 声明。

下载 Excel 文件查看 XML 配置原始文件返回全部示例

售后服务工单台账 — 合并与分组报表
导出产物完整截图

关于这个示例

本示例导出「售后服务工单台账」工作簿:1 个数据 sheet;以 服务工程师、工单号、客户、服务时长(h)、上门费单价、服务费、满意度 共 7 列字段建立 MAPPING 映射、8 条公式、5 处样式规则。Java 侧只负责构造数据并调用一次 exportAfterSalesOrder(),其余全部由配置驱动。

这个示例属于「合并与分组报表」分组:演示 MERGE 分组区块与 SUBTOTAL / TOTAL 小计合计行:同一分组列纵向合并成一个区块,每个分组后跟一行小计,末尾给出合计。

可以直接抄走的内容

  • 完整 Java 测试类(97 行,可直接运行)
  • 完整 XML 配置(38 行,映射、公式、样式、图表等全部规则)
  • 导出产物 xlsx(真实运行结果,可与上方预览图对照)

相关搜索:Java 导出 Excel 合并单元格、Java Excel 分组小计与合计行、POI 合并单元格 导出示例、Java 导出分组报表、Java 导出 售后服务工单台账 Excel

输出规格

场景编号
0047
技术分组
合并与分组报表
配置行数
38
源码行数
97

Java 源码 · Merge0047AfterSalesOrderDemo.java

以下代码即生成上方 Excel 的完整测试类,可直接复制运行;Java 只负责构造数据,统计与样式逻辑全部在 XML 配置里。

package com.github.paohaijiao.biz.merge;

import com.github.paohaijiao.statement.JQuickRow;
import com.github.paohaijiao.xml.ex.JQuickExcelExportXmlParseFactory;
import com.github.paohaijiao.xml.factory.JQuickFactory;
import com.github.paohaijiao.xml.factory.JQuickXmlFactory;
import com.github.paohaijiao.xml.handler.JQuickParseHandler;
import org.junit.Test;

import java.io.File;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.ArrayList;
import java.util.List;

public class Merge0047AfterSalesOrderDemo {

    private static final String XML = "jquick/biz/merge/0047_merge_after-sales-order.xml";

    /** 导出:Java 分组 + 插小计行,工程师列纵向合并,服务费由 XML FORMULAS 完成。 */
    @Test
    public void exportAfterSalesOrder() throws Exception {
        // 1. 构造扁平工单明细(Java 不做任何金额计算)
        List<JQuickRow> flat = new ArrayList<>();
        flat.add(line("刘工", "SV260301", "恒信商贸", 2.0, 150, 5));
        flat.add(line("刘工", "SV260302", "华越集团", 3.5, 150, 4));
        flat.add(line("陈工", "SV260303", "广发物流", 1.5, 180, 5));
        flat.add(line("陈工", "SV260304", "中远建材", 2.5, 180, 5));
        flat.add(line("陈工", "SV260305", "蓝天科技", 4.0, 180, 3));

        // 2. Java 分组并插入小计 / 合计占位行(服务费留给 FORMULAS)
        List<JQuickRow> rows = groupWithSubtotal(flat);

        File out = new File("D:/test/excel/biz/merge/0047_merge_after-sales-order.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("periwinkle", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Merge0047AfterSalesOrderService service = factory.createApi(Merge0047AfterSalesOrderService.class);
            service.exportAfterSalesOrder("field", "value");
        }

    }

    /** 按服务工程师分组,工程师切换处插入小计行,末尾追加合计行(不做金额计算)。 */
    private static List<JQuickRow> groupWithSubtotal(List<JQuickRow> flat) {
        List<JQuickRow> out = new ArrayList<>();
        String current = null;
        for (JQuickRow r : flat) {
            String engineer = String.valueOf(r.get("a"));
            if (current != null && !current.equals(engineer)) {
                out.add(subtotalRow(current));
            }
            out.add(r);
            current = engineer;
        }
        if (current != null) {
            out.add(subtotalRow(current));
        }
        JQuickRow total = new JQuickRow();
        total.put("a", "合计");
        total.put("b", null);
        total.put("c", null);
        total.put("d", null);
        total.put("e", null);
        total.put("f", null);
        total.put("g", null);
        out.add(total);
        return out;
    }

    /** 小计占位行:只写工程师与小计文字,服务费留空由 FORMULAS 计算。 */
    private static JQuickRow subtotalRow(String engineer) {
        JQuickRow row = new JQuickRow();
        row.put("a", engineer);
        row.put("b", "小计");
        row.put("c", null);
        row.put("d", null);
        row.put("e", null);
        row.put("f", null);
        row.put("g", null);
        return row;
    }

    /** 构造一条工单明细(a=工程师,b=工单号,c=客户,d=时长,e=单价,g=满意度,f 留空)。 */
    private static JQuickRow line(String engineer, String orderNo, String customer, double workHours, double serviceRate, double satisfaction) {
        JQuickRow row = new JQuickRow();
        row.put("a", engineer);
        row.put("b", orderNo);
        row.put("c", customer);
        row.put("d", workHours);
        row.put("e", serviceRate);
        row.put("f", null);
        row.put("g", satisfaction);
        return row;
    }
}

最小调用(4 行)

核心就这四行:数据行交给解析器,解析器交给工厂,工厂生成 Service 接口,调用即产出 Excel。可直接复制到你的项目里。

// rows 由业务代码构造(List<JQuickRow>),os 为输出流,见下方完整源码
JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("periwinkle", rows, os);
JQuickFactory factory = new JQuickXmlFactory(parser, XML);
Merge0047AfterSalesOrderService service = factory.createApi(Merge0047AfterSalesOrderService.class);

XML 配置 · 0047_merge_after-sales-order.xml

格式(FORMAT)、公式(FORMULAS)、样式(STYLE)等统计逻辑全部声明在这份 XML 里,与 Java 代码解耦。下方为完整配置,可直接复制。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE excels PUBLIC "-//PAOHAIJIAO//DTD API EXCEL 1.0//EN"
        "classpath:paohaijiao/dtd/Jquick-excel.dtd">
<excels namespace="com.github.paohaijiao.biz.merge.Merge0047AfterSalesOrderService">

    <!-- 导出:售后服务工单台账 -->
    <excel name="exportAfterSalesOrder" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="售后服务工单台账", HEADER=true,
                MAPPING={"a":"服务工程师","b":"工单号","c":"客户","d":"服务时长(h)","e":"上门费单价","f":"服务费","g":"满意度"},
                FORMAT={"d":"#,##0.0","e":"#,##0.00","f":"#,##0.00","g":"0"},
                FORMULAS={
                    F2:'D2*E2',F3:'D3*E3',F4:'SUM(F2:F3)',
                    F5:'D5*E5',F6:'D6*E6',F7:'D7*E7',F8:'SUM(F5:F7)',
                    F9:'F4+F8'
                },
                STYLE={
                    ROW 4:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
                    ROW 8:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
                    ROW 9:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}
                },
                MERGE:{
                    RANGE A2:A3 WITH MERGE_WITH_FIRST,
                    RANGE A5:A7 WITH MERGE_WITH_FIRST
                }
        ]]>
    </excel>

    <!-- 导入解析:读取导出的售后服务工单台账 -->
    <excel name="importAfterSalesOrder" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="售后服务工单台账", HEADER=true,
                MAPPING={"服务工程师":"engineer","工单号":"orderNo","客户":"customer","服务时长(h)":"workHours","上门费单价":"serviceRate","服务费":"serviceFee","满意度":"satisfaction"}
        ]]>
    </excel>

</excels>

同分组示例

本页 Excel 产物、预览图、XML 配置与源码均由 JQuick-Excel 真实运行产出,可自由复制到你的项目中使用。