跳转到内容
JQuickJQuick

Java 导出「项目进度计划排期表」Excel 报表（合并与分组报表）

JQuick-Excel合并与分组报表

合并与分组报表场景 0018

项目按阶段排期，逐行算「工期 = 结束日期 - 开始日期」天，每阶段后跟一行工期小计，末尾一行给出总工期与整体平均完成率；阶段名称列纵向合并成一个区块。 Java 侧仅做分组与预处理，统计与版式全部由 XML 声明。

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

项目进度计划排期表 — 合并与分组报表
导出产物完整截图

关于这个示例

本示例导出「项目进度计划排期表」工作簿：1 个数据 sheet；以 阶段、任务名称、负责人、开始日期、结束日期、工期(天)、完成率 共 7 列字段建立 MAPPING 映射、13 条公式、7 处样式规则。Java 侧只负责构造数据并调用一次 exportProjectSchedule()，其余全部由配置驱动。

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

可以直接抄走的内容

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

相关搜索：Java 导出 Excel 合并单元格、Java Excel 分组小计与合计行、POI 合并单元格 导出示例、Java 导出分组报表、Java 导出 项目进度计划排期表 Excel

输出规格

场景编号
0018
技术分组
合并与分组报表
配置行数
41
源码行数
109

Java 源码 · Merge0018ProjectScheduleDemo.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.Calendar;
import java.util.Date;
import java.util.List;

public class Merge0018ProjectScheduleDemo {

    private static final String XML = "jquick/biz/merge/0018_merge_project-schedule.xml";

    /** 导出：Java 分组 + 插小计行，阶段列纵向合并，工期 / 完成率由 XML FORMULAS 完成。 */
    @Test
    public void exportProjectSchedule() throws Exception {
        // 1. 构造扁平任务明细（Java 不做任何工期计算）
        List<JQuickRow> flat = new ArrayList<>();
        flat.add(task("需求分析", "需求调研", "张伟", date(2026, 3, 1), date(2026, 3, 5), 1.0));
        flat.add(task("需求分析", "需求评审", "李娜", date(2026, 3, 6), date(2026, 3, 8), 1.0));
        flat.add(task("系统设计", "概要设计", "王强", date(2026, 3, 9), date(2026, 3, 13), 1.0));
        flat.add(task("系统设计", "详细设计", "赵敏", date(2026, 3, 14), date(2026, 3, 18), 0.8));
        flat.add(task("开发实现", "后端开发", "陈刚", date(2026, 3, 19), date(2026, 3, 28), 0.5));
        flat.add(task("开发实现", "前端开发", "孙丽", date(2026, 3, 19), date(2026, 3, 26), 0.4));
        flat.add(task("开发实现", "联调测试", "周杰", date(2026, 3, 29), date(2026, 4, 2), 0.1));

        // 2. Java 分组并插入小计 / 合计占位行（工期、完成率留给 FORMULAS）
        List<JQuickRow> rows = groupWithSubtotal(flat);

        File out = new File("D:/test/excel/biz/merge/0018_merge_project-schedule.xlsx");
        try (OutputStream os = new FileOutputStream(out)) {
            JQuickParseHandler parser = new JQuickExcelExportXmlParseFactory("terracotta", rows, os);
            JQuickFactory factory = new JQuickXmlFactory(parser, XML);
            Merge0018ProjectScheduleService service = factory.createApi(Merge0018ProjectScheduleService.class);
            service.exportProjectSchedule("field", "value");
        }

    }

    /** 按阶段分组，阶段切换处插入小计行，末尾追加合计行（不做工期计算）。 */
    private static List<JQuickRow> groupWithSubtotal(List<JQuickRow> flat) {
        List<JQuickRow> out = new ArrayList<>();
        String current = null;
        for (JQuickRow r : flat) {
            String phase = String.valueOf(r.get("a"));
            if (current != null && !current.equals(phase)) {
                out.add(subtotalRow(current));
            }
            out.add(r);
            current = phase;
        }
        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 phase) {
        JQuickRow row = new JQuickRow();
        row.put("a", phase);
        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=完成率）。 */
    private static JQuickRow task(String phase, String name, String owner, Date start, Date end, double progress) {
        JQuickRow row = new JQuickRow();
        row.put("a", phase);
        row.put("b", name);
        row.put("c", owner);
        row.put("d", start);
        row.put("e", end);
        row.put("f", null);
        row.put("g", progress);
        return row;
    }

    /** 构造一个「年-月-日」日期（月份从 1 开始）。 */
    private static Date date(int year, int month, int day) {
        Calendar c = Calendar.getInstance();
        c.clear();
        c.set(year, month - 1, day);
        return c.getTime();
    }
}

最小调用（4 行）

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

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

XML 配置 · 0018_merge_project-schedule.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.Merge0018ProjectScheduleService">

    <!-- 导出：项目进度计划排期表 -->
    <excel name="exportProjectSchedule" returnClass="void">
        <![CDATA[
            EXPORT WITH SHEET="项目进度计划排期表", HEADER=true,
                MAPPING={"a":"阶段","b":"任务名称","c":"负责人","d":"开始日期","e":"结束日期","f":"工期(天)","g":"完成率"},
                FORMAT={"d":"yyyy-MM-dd","e":"yyyy-MM-dd","f":"0","g":"0%"},
                FORMULAS={
                    F2:'E2-D2',F3:'E3-D3',F4:'SUM(F2:F3)',
                    F5:'E5-D5',F6:'E6-D6',F7:'SUM(F5:F6)',
                    F8:'E8-D8',F9:'E9-D9',F10:'E10-D10',F11:'SUM(F8:F10)',
                    F12:'F4+F7+F11',G12:'AVERAGE(G2:G10)'
                },
                STYLE={
                    ROW 4:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
                    ROW 7:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
                    ROW 11:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center},
                    ROW 12:{bold:true,fillPattern:solid_foreground,fillForegroundColor:lightYellow,alignment:right,verticalAlignment:center}
                },
                MERGE:{
                    RANGE A2:A3 WITH MERGE_WITH_FIRST,
                    RANGE A5:A6 WITH MERGE_WITH_FIRST,
                    RANGE A8:A10 WITH MERGE_WITH_FIRST
                }
        ]]>
    </excel>

    <!-- 导入解析：读取导出的项目进度计划排期表 -->
    <excel name="importProjectSchedule" returnClass="java.util.List">
        <![CDATA[
            IMPORT WITH SHEET="项目进度计划排期表", HEADER=true,
                MAPPING={"阶段":"phase","任务名称":"task","负责人":"owner","开始日期":"startDate","结束日期":"endDate","工期(天)":"duration","完成率":"progress"}
        ]]>
    </excel>

</excels>

同分组示例

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