Skip to main content

Blackboard Integration

Overview

Blackboard is a popular learning management system used by institutions to facilitate distance learning and other online instruction. Jenzabar SONIS provides utilities to export student and course data to Blackboard, as well as import specific data. Exports can be performed manually as-needed or set up to occur at timed intervals. Final grades can be imported to SONIS from Blackboard at the end of each semester.

Additionally, SONIS provides a student/instructor export file for Blackboard Student Services, a program that helps institutions manage student admissions and enrollment, financial aid, and student accounts and retention.

The following data fields are exported:

Blackboard_40.png

Blackboard Fields Defined:

<idtype> - Defines the identification type, always a 1 for SONIS.

<role roletype> - The user’s role in the Course. This value is mapped to a one-character database constant. For SONIS purposes, either 01 Student or 02 Instructor.

<status> - Sets the enrollment status of the course:

0 - Unavailable: Enrollment is inactive in the course.

1 - Available: Enrollment is active in the course.

For more, visit the Blackboard help page.

To download a sample Blackboard XML file, click here

Setup

Course Setup

Before setting up the Blackboard integration, schools should ensure that their courses are properly configured to pass data to LMS systems. Navigate to the Course Type table in Table Maintenance under the Systems menu and ensure that any course types that may use Blackboard or another LMS have a 1 in the LMS field.

Moodle_1.png

Additionally, each individual course section that will be available through Blackboard should have the On-Line box checked on the Course Section page. For most schools, a course must have a section type that’s LMS enabled and have the On-Line box checked or it will not be exported to Blackboard.

Moodle_2.png

The Course Section edit page also includes optional Blackboard Start Date and Blackboard End Date fields. Enter a date into each of these to change the dates that students have access to Blackboard. If the fields are left blank, the course start and end dates are used in the export file instead.

Blackboard_34.png
Blackboard_35.png

LMS Setup

To link Blackboard to SONIS and activate it, navigate to the Learning Management Systems Setup utility. Enter the institution-specific web location where the Blackboard software has been uploaded and check the Active button.

Blackboard_1.png

After activating Blackboard, scroll down to the For Blackboard Only section of the page. These controls allow schools to manage how their Blackboard integration will function. First, choose whether to use the Current School Year/Semester or the Registration School Year/Semester if different. Alternately, select a school year/semester that is neither of those. All school years and semesters that have been created in the SONIS system are listed in this menu.

Blackboard_2.png

Next, choose whether students and faculty should log in with their SONIS ID or their LDAP ID, if applicable.

Blackboard_3.png

If the Select Online Courses option is set to Yes, only course sections with the On-Line box checked will be included in the export to Blackboard. If No is selected, all courses with a valid course type will be exported.

Blackboard_4.png

Administrators can choose whether to include Continuing Education courses in Blackboard or not by selecting Yes or No.

Blackboard_5.png

The User Export File School Name field is used to designate a name for the Blackboard Student Services Student/Teacher Extract file. The filename will be XXXXX_upload_DDMMYY with the date appended.

Blackboard_6.png

Once this section has been completed, scroll down to the section labeled For Blackboard, WebCT, Moodle, Canvas, and Scholar360 Only. Choose whether each course in Blackboard will Use Lead Faculty or Use Lead Faculty and Additional Instructors. Additional instructors are added on the Section: List edit page.

Blackboard_7.png

Click Submit at the bottom of the page to save the changes and activate Blackboard.

Blackboard_8.png

LMS Holds

The Holds utility can be used to prevent students from accessing Blackboard and other Learning Management Systems. To place a hold on a student, navigate to that student's Holds page and click Add to create a new hold. Select LMS Hold from the Hold menu and check the Active box. Enter the start date and select a staff member to authorize the hold. An additional memo or notes for student viewing can be included as well but are optional. Click Submit to create the hold.

Moodle_9.png

When a student has an active LMS Hold in their records, the student’s data will still be sent to Blackboard, but they’ll be marked as inactive in the Blackboard system.

XML Export

Manual Export

SONIS course and student data can be uploaded to Blackboard through a fairly simple manual process. First, navigate to the SONIS Learning Management Systems Export utility in the Systems hub. Select the appropriate School Year and Semester for the data.

Blackboard_9.png
Blackboard_10.png

Next, select the Campus or campuses that should be included and click Submit to create the XML file.

Blackboard_11.png
Blackboard_12.png

The file will be saved in the batch folder designated under Web Options.

Timed Export

SONIS can also be configured to create the Blackboard XML export file at a regular interval. Navigate to the Timed Task Scheduler in the Systems hub and click Add to begin.

Blackboard_13.png

On the following page, select Notifier: Blackboard LMS Export from the Task Name menu.

Blackboard_58.png

Select how often the task should occur with the Frequency dropdown. Schools may wish to run the export more frequently during each semester's drop/add period and edit the task to run only daily once this period has ended.

Blackboard_59.png

The Start Date and Start Time will automatically be set to the current date and time but can be changed to suit individual preferences. The End Date and End Time are optional.

Blackboard_60.png
Blackboard_61.png

Click the Submit button to create the scheduled task.

Blackboard_62.png

Notification Assignment

SONIS also offers a notifier that pairs with the Timed Task to inform select staff/faculty members that the export task has been run. Navigate to the Notification Assignments page in the Systems hub and click the Add button to create a new assignment.

Blackboard_19.png

On the following page, select Blackboard LMS Export from the Notification Type dropdown menu and click the Submit button.

Blackboard_63.png
Blackboard_64.png

Next, create a Notification Name, a descriptor of the notifier's purpose with a 50 character limit, and a Notification Code, a shorter version of this name with a 20 character limit that the SONIS system will use internally to identify the notifier.

Blackboard_65.png
Blackboard_66.png

Select a group of staff/faculty to receive the notification from the Group Name dropdown menu. Groups can be added and edited through the Table Maintenance utility.

Blackboard_67.png

Enter the ID of the staff or faculty member who will be managing this notification in the Notification Owner SonisID field.

Blackboard_68.png

Create a Group Notification Message that will be sent to the group members when the task takes place.

Blackboard_69.png

The Group Notification Method dropdown menu designates whether the group and individual users will receive an in-system reminder, an email, or neither when the notification is triggered. The Reminder Type dropdown can change how the in-system reminder displays. This list can be created and edited via the Table Maintenance utility.

Blackboard_70.png
Blackboard_71.png

Click Submit to activate the notification assignment.

Blackboard_72.png

Student/Teacher Extract

Manual Export

In addition to the standard XML export file, SONIS offers an extract for Blackboard Student Services. Navigate to Blackboard: Student/Teacher Extractin the Systems hub to create the file. Select a School Year and a Semester.

Blackboard_30.png
Blackboard_31.png

Click Submit to create the file.

Blackboard_32.png

The file is a simple, pipe-delineated text file that lists the first and last name of all active students and teachers for the selected school year and semester along with their SONIS ID, their Blackboard ID, their email address, their phone number, and their user type, either STU for student or STA for staff.

Blackboard_33.png

Timed Extract

SONIS can also be configured to create the Blackboard Student Services Student/Teacher Extract file at a regular interval. Navigate to the Timed Task Scheduler in the Systems hub and click Add to begin.

Blackboard_13.png

On the following page, select Notifier: BB User Extract from the Task Name menu.

Blackboard_14.png

Select how often the task should occur with the Frequency dropdown. Schools may wish to run the export more frequently during each semester's drop/add period and edit the task to run only daily once this period has ended.

Blackboard_15.png

The Start Date and Start Time will automatically be set to the current date and time but can be changed to suit individual preferences. The End Date and End Time are optional.

Blackboard_16.png
Blackboard_17.png

Click the Submit button to create the scheduled task.

Blackboard_18.png

Notification Assignment

SONIS also offers a notifier that pairs with the Timed Task to inform select staff/faculty members that the extract task has been run. Navigate to the Notification Assignments page in the Systems hub and click the Add button to create a new assignment.

Blackboard_19.png

On the following page, select BB User Extract from the Notification Type dropdown menu and click the Submit button.

Blackboard_20.png
Blackboard_21.png

Next, create a Notification Name, a descriptor of the notifier's purpose with a 50 character limit, and a Notification Code, a shorter version of this name with a 20 character limit that the SONIS system will use internally to identify the notifier.

Blackboard_22.png
Blackboard_29.png

Select a group of staff/faculty to receive the notification from the Group Name dropdown menu. Groups can be added and edited through the Table Maintenance utility.

Blackboard_23.png

Enter the ID of the staff or faculty member who will be managing this notification in the Notification Owner SonisID field.

Blackboard_24.png

Create a Group Notification Message that will be sent to the group members when the task takes place.

Blackboard_25.png

The Group Notification Method dropdown menu designates whether the group and individual users will receive an in-system reminder, an email, or neither when the notification is triggered. The Reminder Type dropdown can change how the in-system reminder displays. This list can be created and edited via the Table Maintenance utility.

Blackboard_26.png
Blackboard_27.png

Click Submit to activate the notification assignment.

Blackboard_28.png