Illuminate BI Tool Guide
  • Introduction
  • Example BI Reports
  • What is BI Reporting in Illuminate?
  • Getting Started Using BI with Custom Reports
    • Setup Jaspersoft Studio
    • Prepare Your Data Set
    • Create a Basic Jasper Report
    • Publish My Report to Illuminate
    • Edit Report After Publishing
    • Display Selected Filters on Your Report
  • Get Started Using BI with SQL
    • Access Data Via ODBC Connection
    • Learn the Schema
    • Setup Jaspersoft Studio for SQL
    • Create a Basic Report with SQL
    • Publish My Report (SQL Method)
    • Adding Input Controls
  • Tutorials
    • Tutorials for Free Version ("Community Edition")
      • Tutorial 1: Categorize and Aggregate Your Data
      • Tutorial 2: Using Jasper Report Bands
      • Tutorial 3: Student Roster Report
      • Tutorial 4: Student Roster with SQL
      • Tutorial 5: Summary of Performance
      • Tutorial 6: CELDT Longitudinal Summary
    • Tutorials for Pro Version ("Professional Edition")
      • Tutorial 1: Aggregate and Visualize Your Data
        • Step 1 - Create a Custom Report
        • Step 2 - Download Your Data
        • Step 3 - Create a Data Adapter
        • Step 4 - Duplicate Template. Link Data Adapter
        • Step 5 - Set Class for Numeric Fields
        • Step 6 - Add & Configure Chart
        • Step 7 - Resize Chart. Preview Report.
        • Step 8 - Change Chart Labels
        • Step 9 - Set Chart Colors
        • Step 10 - Repeat for Other Data Points
        • Step 11- Install Your Report
      • Tutorial 2: Using Report Bands
        • Step 1 - Duplicate Report from Tutorial 1
        • Step 2: Create Your Group
        • Step 3: Create a Sort Field
        • Step 4 - Copy & Paste Your Chart
        • Step 5 - Set Reset Type and Evaluation Time
        • Step 6 - Change the Category Level
        • Step 7 - Add Site Name Field
        • Step 8 - Grade Level Sorting
    • CrossTabs Tutorial - Create, Format, and Style a CrossTab
      • Step 1 - Create Your CrossTab
      • Step 2 - Size and Position Your CrossTab
      • Step 3 - Format and Style Your CrossTab
  • Homework 1 - BI Workshop Follow Up
  • BI Tool Cheat Sheet
  • JasperSoft Studio Tips, Tricks, & FAQs
    • Basics of Writing Expressions in JSS
    • Rounding Decimals
    • Working with Dates in JSS
    • Conditional Styling in JasperSoft
    • Custom "No Data" Message
    • Create Multiple Summary Bands
    • Create Hyperlinks or "Tabs" to Connect Sets of Reports
    • JSS Community Edition
      • Adding Data Labels to Your Chart
      • Customizing Colors in Your Charts
    • JSS Professional Edition Only
      • HTML5 Charts
        • Data Labels: Enable, Customize, & Round Data Labels
        • Tooltip: Customizing the Tooltip
        • Keeping Colors Consistent in HTML5 Charts
        • Adding Drill Down to a Chart
        • Prevent Tooltip from Being Cut Off
        • Sort the Bars in Your Stack - Ordering the Series in Your Chart
        • Passing Parameters/Data Between Datasets with HTML5 Charts
        • Add Plot Lines to your Chart
        • Add Colored Zones or Plot Bands to Your Chart
        • Change Bar Colors Based on Bar Value
    • Rolling Over Your BI Tool Reports
    • "Current" Columns in Custom Reporting - To Use or Not to Use?
  • Report Design Best Practices
  • Installing the Illuminate Font Set
  • Report Templates
    • Blank Templates - Report Starters
    • Using the Report Templates
    • Multiple Measures Site Comparison Report (Tutorial 5)
    • EL Reclassification Report
    • EL Reclassification Report v2
    • RFEP Monitoring Report
    • Student Rubric Template
    • Michigan Report Templates
      • PSAT and SAT College Readiness Report
  • BI Tool User Community
Powered by GitBook
On this page

Was this helpful?

  1. Tutorials
  2. Tutorials for Free Version ("Community Edition")

Tutorial 4: Student Roster with SQL

PreviousTutorial 3: Student Roster ReportNextTutorial 5: Summary of Performance

Last updated 5 years ago

Was this helpful?

We will create prebuilt report using Jaspersoft Studio that lists all students for a single teacher alphabetically by last/first name. We will create a summary at the end of list by student gender. We will use an ODBC connection (SQL) Data Adapter as the data source for this report.

Here is a sample of what your final report should look like:

  1. Open pgAdmin and open the SQL editor.

  2. Test the query with a sample academic year (2015), site_id, and user_id to see how the query works. Keep note of the sample site_id and user_id for testing the report later.

  3. Open Jaspersoft Studio and setup a Data Adapter using ODBC connection (reference BI Tool Guide for instructions)

  4. Connect to Jasper Server (reference BI Tool Guide for Instructions)

  5. Create a new Jaspersoft Studio file (File > New > Blank Letter)

  6. Create three parameters of type “integer: academic_year, active_sites, active_users

  7. Open the query editor, and link your ODBC connection Data Adapter.

  8. Paste the query from step 2 into the query editor and click “Read Fields"

  9. Click OK.

  10. Save your report and begin report design as follows.

  11. Create the following groups in this order: user_info, period, course

  12. Collapse all group bands and the title band.

  13. Add the title to the report in the Page Header band (Student Roster)

  14. In the Page Header, add the teacher's name, Section, Academic Year, and the Room Number. Drag the elements from the report "Outline" into the Page Header band.

  15. From the Pallete, drag a Text Field into the Page Header, and make the expression read new java.util.Date() and in the Pattern type MM/dd/yyyy

  16. Click "Preview" to see what your report looks like so far. Note you will be prompted for testing purposes to enter the academic_year (2015), active_sites (your sample site_id from step 3) and active_users (your sample user_id from step 3). You should now see a header with the sample teacher's class(es).

  17. Add the following fields to the Detail Band: Local Student ID, Student Name (stu_info), current grade level, birthdate, and gender.

  18. Relabel the headers to read something other than the actual field names (For example "stu_info" should be renamed to Student Name and aligned in the Page Header.)

  19. Right clikc on the category "Variables" in the report Outline. Create a variable named CountMales. Date Type is integer, No calculation, expression should read "$F{gender}.equals("M") ? $V{CountMales} + 1 : $V{CountMales} with an Initial Value of 0, Reset of "Group Period".

  20. Expand the Period band group footer to a height of 15 pixels.

  21. Drag the Variable you just created (CountMales) into the Period Footer band. Label the variable displayed with "Number of Males " +

  22. Repeat steps 20-22 to count the number of Females.

  23. Preview your report.

  24. SAVE your report in Jaspersoft Studio (JSS)

  25. Login to Illuminate, click Reports > Create a Jasper Prebuilt Report

  26. Name your Report “Student Roster Jasper Tutorial 2”, upload the jrxml file you just created (should be in your My Reports folder), type in the name of the custom report you created)

  27. In the reports list, search for the word “Tutorial 2” and you should see the Custom and Prebuilt you created.

  28. Go back to Jaspersoft Studio, and open the Jasper repository.

  29. Navigate to your report on the Jasper repository: Reports > DistrictCreated > StudentRosterJasperTutorial2

  30. Right click on the name of the report, select "New" and "Link" then click "Next."

  31. In the "Name" field type academic_year and click "Next."

  32. Where it says "Linked Object" click on the down arrow and click Search. Locate the Academic Year input control. Click OK.

  33. Repeat steps 31-33 for active_sites (Select Site) and active_users (Select User).

  34. Test running your report.

  35. Make edits to your report in Jaspersoft Studio

  36. Save report in JSS and re-upload into Illuminate

  37. Test again.

  38. Share out report as desired.

Sample files for this tutorial are available here:

Did you know Illuminate can build your BI Tool for you?

Roster SQL Query
Tutorial 2 Student Roster Report
Click here to learn about Illuminate's Report Building Service.
Roster SQL Query