education 报表系统教程:出勤统计、学费收缴与考试成绩 6 类报表完整配置清单
education 报表系统教程:出勤统计、学费收缴与考试成绩 6 类报表完整配置清单
education 报表系统是 Frappe Education 开源教育管理系统(基于 ERPNext)的统计中枢,内置 11 张标准报表,覆盖出勤统计、学费收缴、考试成绩三大场景,全部预置权限、开箱即用。本教程按“用途分类 + 文件路径 + 筛选条件”整理 6 类核心报表的完整配置清单,帮你快速定位每张报表的位置与用法。
报表在哪里:统一入口与目录结构
所有标准报表集中在 education/education/report/ 目录下,每张报表是一个独立子目录,包含四个文件:
| 文件 | 作用 |
|---|---|
*.json |
报表元数据(名称、类型、关联 DocType、可见角色) |
*.py |
取数与统计逻辑 |
*.js |
筛选器(Filter)定义 |
templates/(可选) |
自定义输出模板 |
在系统中,可通过 Reports → Education 菜单打开报表;只有 is_standard: Yes 的报表可被修改为“私有副本”而不会在更新时丢失。所有报表的权限都由 JSON 中的 roles 字段控制,例如出勤类报表默认仅 Academics User 可见。
6 类核心报表配置清单(总览)
| 类别 | 报表名称 | 报表类型 | 默认角色 | 源码目录 |
|---|---|---|---|---|
| 出勤 | Absent Student Report | Script Report | Academics User | absent_student_report/ |
| 出勤 | Student Batch-Wise Attendance | Script Report | Academics User | student_batch_wise_attendance/ |
| 出勤 | Student Monthly Attendance Sheet | Script Report | Academics User | student_monthly_attendance_sheet/ |
| 学费 | Program wise Fee Collection | Script Report | Accounts User 等 | program_wise_fee_collection/ |
| 学费 | Student Fee Collection | Query Report | Academics User | student_fee_collection/ |
| 成绩 | Final Assessment Grades / Assessment Statistics / Grade Book Statistics | Script Report | Education Manager 等 | final_assessment_grades/ 等 |
说明:第 6 类“考试成绩”实际由 4 张报表组成(Final Assessment Grades、Assessment Plan Status、Assessment Statistics、Grade Book Statistics),配合 Course-wise Assessment Report 共 5 张,下文逐一拆解。
出勤统计报表:3 张表管好学生考勤
1. Absent Student Report:按日查缺勤名单
- 文件:absent_student_report.py、absent_student_report.js
- 筛选器:仅需选择一个
date(必填)。 - 输出列:学生、姓名、批次、邮箱、手机号。
- 关键机制:自动读取 Education Settings 中的 Holiday List,若所选日期是节假日会直接提示“No attendance has been marked”;同时会剔除已批请假(mark_as_present)的学生,只列出真正未到校且无请假记录的学生,适合一键导出催到名单。
2. Student Batch-Wise Attendance:按批次看出勤率
- 文件:student_batch_wise_attendance.py
- 筛选器:单个
date。 - 输出列:Student Batch、Batch Strength(在籍人数,取自已提交的 Course Enrollment)、Present、Leave、Absent,并自动计算 Unmarked(未点名) 人数 = 在籍 − 已点名。
- 适用场景:每天快速核对哪些批次还没点完名。注意它只统计无 subject_schedule 的整体出勤记录,课程内点名不会计入,避免重复。
3. Student Monthly Attendance Sheet:月度出勤明细表
- 文件:student_monthly_attendance_sheet.py
- 筛选器(定义于 student_monthly_attendance_sheet.js):
month:默认当前月份,下拉可选 Jan–Dec;year:必填,加载时自动拉取历史年份列表;student_batch:必填。
- 输出:每位学生一行,按 1–31 号逐日打码——
P出勤、A缺勤、L请假、H节假日、-未入册,并汇总 Total Present / Total Leave / Total Absent。这是制作学生月出勤证明最常用的报表。
学费收缴报表:2 张表看清收费与欠费
4. Program wise Fee Collection:按项目(专业)汇总收费
- 文件:program_wise_fee_collection.py
- 筛选器:
from_date(默认 1 个月前)、to_date(默认今天),均必填。 - 输出列:Program、Fees Collected(已收)、Outstanding Amount(欠费)、Grand Total(总额),底部带合计行,并自动生成柱状图对比各专业的已收与欠费。
- 取数逻辑:同时汇总
Fees单据与带 student 字段的Sales Invoice,按grand_total - outstanding_amount计算已收款,按 program 分组、按已收款降序排列,财务口径完整。
5. Student Fee Collection:按学生查欠费
- 文件:student_fee_collection.json
- 类型:Query Report(SQL 查询报表),查询语句直接写在 JSON 的
query字段中。 - 输出列:Student、Student Name、Paid Amount、Outstanding Amount、Grand Total,底部合计行开启(
add_total_row: 1)。 - 适用场景:财务催收时按学生维度拉出欠费名单,无需额外配置。
💡 提示:学费类报表都只统计
docstatus = 1(已提交)的单据,草稿状态的缴费不会计入。
考试成绩报表:5 张表覆盖从录入到统计的全流程
6. Final Assessment Grades:期末成绩单(按课程透视)
- 文件:final_assessment_grades.py
- 筛选器(见 final_assessment_grades.js):
academic_year、student_batch、assessment_group,三者均必填。 - 输出:以班级为行、课程为列,每门课同时给出 Grade(等级)与 Score(分数) 两列,并绘制各课程分数对比柱状图。适合导出期末成绩单。
7. Assessment Plan Status:考核进度跟踪
- 文件:assessment_plan_status.py
- 筛选器:
assessment_group(可选)、schedule_date(计划日期截止,可选)。 - 用途:对照每个 Assessment Plan 的在籍人数与已提交分数人数,展示 saved / submitted / remaining,帮教务快速发现“还没录完分”的考核计划。
8. Assessment Statistics:单计划成绩统计
- 文件:assessment_statistics.py
- 筛选器:
assessment_plan必填,且该计划必须已提交。 - 亮点:报表自带 Report Summary 面板,自动计算 Graded Students、Mean(均值)、Median(中位数)、Highest、Lowest、Standard Deviation,若课程绑定了 Grading Scale 还会给出 Pass Rate;图表按等级分布(Grade Distribution)展示。
9. Course-wise Assessment Report:按课程透视成绩
- 文件:course_wise_assessment_report.py
- 筛选器:
academic_year必填,assessment_group必填(不能选“All Assessment Groups”,会提示错误),另可选 course、academic_term、student_batch。 - 输出列:Student ID、Student Name、Assessment Plan、Subject、Score、Maximum Score、Percentage、Grade,并附成绩柱状图。
10. Grade Book Statistics:记分册成绩与同侪对比
- 文件:grade_book_statistics.py
- 前提:对应 Grade Book 的 status 必须为
Computed,否则报“Grade Book has not been computed”。 - 输出列:Subject、Grade Template、Computed Percentage、Final Percentage、Grade、Cohort Average(同侪平均)、Difference(差值)、Overridden(是否人工改分)。
- 亮点:Summary 面板给出 Overall Percentage、Overall Grade、Cohort Average 及 Cohort Rank(班级排名,如 “5 of 40”);图表直观对比学生各科成绩与班级平均线。该报表对 Student 角色也开放,可支撑学生门户成绩查询。
新手常见问题:报表为空或看不到?
- 看不到报表:先确认当前账号拥有对应
roles中的角色(如 Academics User、Accounts User、Education Manager); - 出勤报表无数据:核对日期是否节假日、考勤记录是否已提交(docstatus=1)、是否漏点(看 Unmarked 列);
- 学费报表金额为 0:确认 Fees / Sales Invoice 已提交,且日期区间(from_date / to_date)覆盖开票日期;
- 成绩报表报错:Assessment Plan 或 Grade Book 未提交/未计算时,报表会明确提示,先完成上游单据再查看;
- 需要定制:基于
is_standard报表创建副本即可,自定义报表不会被系统升级覆盖。
小结:按角色选用报表
| 角色 | 高频报表 |
|---|---|
| 教务主任 | Student Batch-Wise Attendance、Assessment Plan Status |
| 班主任 | Absent Student Report、Student Monthly Attendance Sheet |
| 财务人员 | Program wise Fee Collection、Student Fee Collection |
| 教师 / 学生 | Final Assessment Grades、Grade Book Statistics |
以上就是 education 报表系统的完整配置清单。掌握“目录定位 → 筛选器 → 输出列 → 权限角色”四步法,你就能在 education/education/report/ 中快速找到并配置任何一张所需报表,让出勤、收费、成绩三大数据各归其位 📊。
登录后查看全文