Custom Reports
Custom Reports
Build personalized reports tailored to your institution’s specific needs.
Time Required: 15-30 minutes per report Module: Reports (Enterprise) User Role: Report Manager, Admin
Prerequisites
- Enterprise edition installed
- Report builder module enabled
- Understanding of data models
Overview
Custom reports allow you to:
- Select specific data fields
- Apply custom filters
- Define groupings and subtotals
- Create calculated fields
- Save as reusable templates
Create Custom Report
Step 1: Navigate to Report Builder
- Go to OpenEduCat > Reports > Custom Reports
- Click Create to start new report
Step 2: Select Data Model
Choose the primary data source:
| Model | Data Available |
|---|---|
| Students | Student records, enrollments |
| Attendance | Attendance sheets, status |
| Exams | Exam sessions, results |
| Fees | Fee structures, payments |
| Library | Books, issues, returns |
| Faculty | Staff records, workload |
Step 3: Choose Fields
Add fields to include in report:
- Click Add Field
- Select from available fields:
| Field Type | Examples |
|---|---|
| Text | Name, Code, Description |
| Number | Marks, Amount, Count |
| Date | Birth Date, Enrollment Date |
| Selection | Status, State |
| Relation | Course, Batch, Faculty |
- Set field order by dragging
- Configure display options
Step 4: Define Filters
Add filter conditions:
| Filter | Operator | Value |
|---|---|---|
| Course | equals | ”B.Sc Computer Science” |
| Status | in | Active, On Hold |
| Date | between | Start and End |
Step 5: Set Grouping
Group data for subtotals:
- Click Grouping tab
- Add group levels:
- Level 1: Course
- Level 2: Batch
- Level 3: Subject
- Configure subtotals
Step 6: Configure Layout
| Option | Description |
|---|---|
| Orientation | Portrait/Landscape |
| Page Size | A4, Letter, Legal |
| Headers | Column headers |
| Footers | Page numbers, totals |
| Styling | Colors, fonts |
Step 7: Save Report
- Enter report name
- Set category
- Define permissions
- Click Save
Report Elements
Calculated Fields
Create computed values:
| Calculation | Formula Example |
|---|---|
| Sum | sum(marks) |
| Average | avg(attendance_pct) |
| Count | count(student_id) |
| Percentage | (present/total)*100 |
| Concatenate | first_name + ' ' + last_name |
Conditional Formatting
Apply formatting rules:
| Condition | Format |
|---|---|
| Marks < 40 | Red, Bold |
| Attendance < 75 | Orange |
| Status = ‘Active’ | Green |
Charts and Graphs
Add visual elements:
| Chart Type | Use For |
|---|---|
| Bar | Comparisons |
| Line | Trends over time |
| Pie | Distribution |
| Table | Detailed data |
Save and Reuse
Save as Template
- Configure report
- Click Save as Template
- Enter template name
- Set sharing options
Run Saved Report
- Go to Custom Reports
- Find your report
- Click to run
- Modify filters if needed
- Generate output
Field Reference
Report Configuration
| Technical Field | UI Label | Type | Notes |
|---|---|---|---|
name | Name | Char | Report name |
model_id | Model | Many2one | Data source |
field_ids | Fields | Many2many | Selected fields |
filter_ids | Filters | One2many | Filter conditions |
group_by | Group By | Many2many | Grouping fields |
is_template | Template | Boolean | Saved template |
Example Reports
Student Fee Status
Fields: Student Name, Course, Total Due, Paid, Balance Filter: Balance > 0 Group By: Course, Batch Output: Outstanding dues list
Attendance Summary
Fields: Student, Subject, Present %, Absent Count Filter: Date Range, Course Group By: Subject Calculation: Attendance percentage
Faculty Workload
Fields: Faculty, Subject, Hours, Student Count Filter: Academic Year Group By: Department Total: Weekly teaching hours
Troubleshooting
Cannot select field
Problem: Desired field not in list.
Solutions:
- Check you selected correct model
- Field may be from related model
- Add relation first, then access field
- Some fields may be restricted
Report runs slowly
Problem: Large report takes long time.
Solutions:
- Add more specific filters
- Limit date range
- Reduce number of fields
- Remove complex calculations
- Export to Excel for local processing
Grouping not working
Problem: Subtotals not calculating.
Solutions:
- Verify aggregation function set
- Check field type supports grouping
- Ensure proper group order
- Test with simpler grouping first
Related
Last updated: January 2026