Skip to main content
Blackboard Help

Schedule and Run Reports

Running a report applies the appropriate data to a Report Definition at a moment in time and generates report. Report Definitions can be set to run immediately when a user clicks Run from within the application, or set to be part of a queue of reports that runs at a scheduled time when the user clicks Run.

Report data is automatically refreshed in the system every 20 minutes for all reports except activity reports. Activity data is refreshed once per day at midnight. For example, when you align content to a goal, that alignment does not appear in goals-related reports until the refresh occurs at a 20-minute interval. You can refresh the report data manually from the Administrator Panel > Tools and Utilities section > System Reporting > Refresh Report Data.

How to Run Reports

Reports are run from various places within the application. For example, from the Administrator Panel > Tools and Utilities section > System Reporting and various instructor, student, and institutional assessment workflows throughout the product.

  1. Navigate to the item you wish to report on, or locate the appropriate report.
  2. Access the item or report's contextual menu and click either Run Reports or Analyze Results. If there are multiple reports to choose from, a list of available reports appears.
  3. Navigate to the report you want to run and access the contextual menu.
  4. Click Run.

Some reports run as HTML and display within the context of the users work flow. Other reports allow the user to select the format of the output file. Upon submission, the report is run and displays in the selected format. Some reports are automatically stored in the Content Collection while others can be downloaded and saved on your computer.

Setting Report Schedules

If you click Run on a scheduled report, the report runs at the scheduled time. Schedules are defined by the Institution Administrator to ensure that large reports do not take up system resources at times of peak load.

Administrators set the report schedules from the Administrator Panel > Tools and Utilities section > System Reporting. The list of reports to schedule is provided on the Report Definitions page.

Administrators set the start time for the scheduled report queue and the length of time the queue will process reports on the Manage Report Schedule page. If the system does not complete all scheduled reports in the allotted time frame, the system begins where it left off during the next scheduled processing window.

Individual reports cannot be set to run at a specific time. All reports that are scheduled enter the queue. Automatic or recurring scheduling is not available. Users must run the scheduled report to have it added to the nightly queue.

Scheduled reports are stored in the Reports Archive, which is accessed by the system administrator. Archived reports can be stored in the content collection where permission to view the reports is managed by issuing passes or by system role and user account.

Scheduled Reports Queue

The list of reports that are scheduled to run is accessed in System Reporting > Scheduled Reports Queue. The Schedule Reports Queue lists pending and completed reports. Administrators can remove scheduled reports from the queue.

How to Set Time for Scheduled Reports to Run

The time that reports are scheduled to run is set in the bb-tasks.xml file. Setting this value requires access to Blackboard Learn application files and a text editor. Before making changes to the bb-tasks.xml file, make a backup copy of the original.

The bb-tasks.xml file is located in the following directory:





Follow these steps to change the scheduled time for running reports:

  1. Stop Blackboard services using the ServiceController command line tool.
  2. Open the bb-tasks.xml file and locate the following section:

    <task-entry key="" version="60">
        <task classname="blackboard.platform.reporting.service.ScheduledReportQueuingTask" >
        <property name="db.registered.delay" value="scheduled_report_queuing_start_time" />
        <property name="db.registered.period" value="scheduled_report_queuing_interval" />
        <property name="time_sync_pause" value="60000" />

  3. Replace the scheduled_report_queuing_start_time with a time of day expressed as hh:mm. This value uses a 24 hour clock. For example, 13:30 is equivalent to 1:30 P.M.
  4. Replace the scheduled_report_queuing_interval with duration expressed in hours. For example, a value of 48 will run the scheduled reports once every two days.
  5. The section should now resemble the example below:

    <task-entry key="" version="60">
        <task classname="blackboard.platform.reporting.service.ScheduledReportQueuingTask" >
            <property name="xml.registered.delay" value="13:30" />
            <property name="xml.registered.period" value="24" />
            <property name="time_sync_pause" value="60000"

  6. Save the changes to the bb-tasks.xml file and restart services.