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
  • The Easy Way
  • The Manual Way

Was this helpful?

  1. Getting Started Using BI with Custom Reports

Display Selected Filters on Your Report

PreviousEdit Report After PublishingNextGet Started Using BI with SQL

Last updated 5 years ago

Was this helpful?

The BI Tool allows you to display the filters selected by a user on your report. We highly recommend doing this for every report. Otherwise, if printed, the report could be misinterpreted and misused since there would be no way of knowing which filters had been selected.

Similarly, it is crucial to display the name of the user who generated the report, and the date/time the report was generated. Since BI Tool reports automatically respect student visibility, who generates the report dramatically affects what data will be displayed. Since these reports are dynamic, the date/time the report is generated can also affect the data displayed.

The Easy Way

The easy way to do this is to use the jrxml files below as your template. Whenever you start a new report, create a copy of this report. Then, all those parameters and the text fields will already be there for you.

Please right click on the links and select "Download file".

Please be sure to so the templates will display correctly.

You can either start your reports using these templates, OR you can simply copy and paste the parameters (you'll find the parameters in the outline of the report) and the text fields from our template into your own report.

Of course, when you preview the report in JSS, those parameters will always be blank, but when you run the report in Illuminate, it will display the filters the user has selected.

These templates also include page footers that display the name of the user who generated the report, and the date/time the report was generated. You can also copy and paste these into your own report if necessary.

The Manual Way

To do this manually, you need to create a specific paramater for each filter that is available to users when they run the report -- and there are a lot of them! Those parameters, then, need to be displayed on your report.

Here are all the parameters you need to create (the ones that are greyed out; those are default parameters):

Then you need to add a text field in your report to actually display the parameters. I typically use two separate text fields so they can be in two columns, and (as always) you have to be careful of potential null values. You'll see that in my expressions below. (The expressions are also using simple html for formatting.)

Generic Template with Parameters for Filters Landscape
Generic Template with Parameters for Filters Portrait
install the Illuminate Font Set