Generating Reports

CourseMill reporting is divided into two primary categories: General and Parameter Driven. Both types of reports will be described further down in this document.

Progress Reports are also available to reporters. These can be set up to be automatically sent to them based on the selection that is chosen in the reporter’s user profile as shown below. A sample of a progress report that is emailed out is shown on the next page. We recommend not using this report as it is probably the first one ever developed in CourseMill and is not very “friendly”. The only reason to possibly use this is that, today, it drives two other notifications to the managers: Evaluations and Approvals. If you are not using either one, we suggest not using Progress Reports.

These reports are generated on an automatic schedule as your administrator defines in the Manage Scheduled Task option as shown at right.

Sample of a Progress Report:

General Reports

With CourseMill, there are approximately 47 standard reports providing a foundation for extracting system data. These general reports are not typically your daily operational reports. They are more static reports and used when setting up the system or diagnosing a problem. The SQL statements that make up these general reports can be copied and pasted as a starting point if you are trying to create a new Custom Report.. Many of these general reports have been re-created in our new Advanced Reports giving you many more options for creating and changing reports. If you have access to the Advanced Reporting module, we strongly suggest you use that tool for reporting.

The General categories are:

Administrator System configuration reporting.
Audit Administrator tool for auditing CourseMill activities.
Course

Course catalogs, notifications, session information and user interactions with courses.

Curriculum Curriculums, Curriculum Catalogs and Curriculum notifications.
ECommerce Course/Curriculum by price, discount codes/percentages.
General These are new custom reports that have been generated for the organization.
User Active/Inactive users, reporters and instructors with permissions.
Admins/Instructors/Reporters will see a listing of these reports as shown on the next page.

As you click View/Edit Details of any of the General Reports – you will see a screen similar to the following. This screen allows the administrator to select which group of users can have access to that particular report.

Most reports, once run, will display the following navigation bar:

Options Modify a set of options parameters set up for the report.
Download Generated Report

Download the report in Excel format.

Graph

Create a Graph of the report. This is only available in Summary mode. Check Manage Properties for Graph to set up display characteristics. Not all reports have graphs.

Print Report Print the report or create a PDF file.

Print Default: Be aware that there is a default of 10 columns to a report before you are not given the Print option any longer. This default can be changed by your administrator.

Save to Report Locker Save the report parameters and schedule the report to deliver updated information on a daily, weekly, monthly or quarterly basis.

Parameter Driven Reports

Currently there are several custom built reports allowing for selection of data from differing views of the database. Each report is parameter driven with a summary or detail mode. The results from each mode will be quite different. The Summary check box is always at the top of the parameters window and is checked by default. Uncheck Summary to run the report in Detail mode. Most reports, once run, will display a similar navigation bar as shown above.

If a reporter is also an instructor and the instructor is assigned to a session, reporting as a session level instructor takes precedence when running reports. In other words, the reporter can only run course level reports for sessions he/she is assigned to as an instructor.

Types of Reports

Using the Report Locker

The Report Locker is a storage area where you can save reports that are customized to your needs. You can run any report by selecting Save To Report Locker in the top navigation.

When you select Save to Report Locker, it will bring up your current report locker and add your selected report to the bottom of the list and will label it the same name as the report you ran. In this example above, we selected Save to Report Locker when we were running the Gradebook Report. Thus when it was saved to the report locker area, it was initially saved to the same name.

From here you can change several items by clicking the View/Edit Details, which will bring up the following screen. You can change the title to a more meaningful name.

Select a schedule for when the report is to automatically run:

If the report is to be limited to the selected schedule, then be sure to select the check box to the right.

If a report runs weekly, it only provides data activity for that particular week. You can also provide a copy of this report to any instructors or reporters.

Click Select to view what Instructors/Reporters are available to choose from and the following screen will allow you to choose and return selected items to then save:

This will ensure that reports will be automatically scheduled and delivered to your email inbox (and those that you copied) on a consistent basis.

Recently Run Reports

This selection is simply a list of recently run reports that were processed by an organization or a particular user. This feature is only available to administrators to audit the reporting performance of the system. For example, if a large report is running every day that is affecting performance, you might want to schedule it to run at night.

Custom Reporting

If you have the Advanced Reporting module, disregard this section and create your reports using that tool. Otherwise, custom reporting can be done this way using the following instructions..

You can create just the report you want with CourseMill's custom reports. Generate reports based on predefined database views, custom database queries, or external scripts. This section will most likely require the expertise of your IT department.

Custom reports can be downloaded or saved for quick retrieval or for automatic scheduling in the Report Locker. Many times you can copy and paste the SQL statements from one report and use that code in your newly created custom report. To see the code in any General report:

  1. Click View/Edit Details of any General Report to see the code used to create that report.

  2. Copy the SQL code and use it to paste into a new Custom Report you are creating.

To generate a custom report based on a predefined database view:

The Custom Report window opens.

Select the category in which this report will be classified.

Select the type of report:

If you select Database View:

The results are displayed in the window. Click a column heading to re-sort the table.

If you select Database Query:

The results are displayed in the window. Click a column heading to re-sort the table.

If you select Database Script:

The results are displayed in the window. Click a column heading to re-sort the table.

To generate a report based on an external database script, the script must return XML records based on the following passed parameters and in the following XML format:

Parameters

Description

orgID

Organization ID
currID

ID of the curriculum (configured in CourseMill)

courseID

ID of the course (configured in CourseMill)

sessionID

ID of the session (configured in CourseMill)

scoID

ID of the SCO (configured in CourseMill)
status

lesson_status or status (configured in CourseMill)

startDate

Beginning day of the report

endDate

Ending day of the report

suborg0-n

Suborgs

start

Starting record if pagination is available

Response in XML format:

<reportlist>
 <totalRecs>1</totalRecs>
 <numRecs>1</numRecs>
 <hdr0>StudentID<hdr0/>
 <hdr1>StudentName<hdr1/>
 <hdr2>LastLogin<hdr2/>
 <report>
  <col0>TestStudent</col0>
  <col1>Lastname, FirstName</col1>
  <col2></col2>
 <report>
</reportlist>
CourseMill provides a sample callable script SampleCustomReport.jsp located in the root in your CourseMill.jsp installation. See the contents of this file for details.

© Copyright Trivantis Corporation 2015