Connect Blackboard LMS to your OneCampus instance.

Using the Connector tool, OneCampus Administrators can seamlessly connect Blackboard to their OneCampus instance. Once the connection is authorized by the individual end users, their courses will display as tasks on the main OneCampus page.

Important: You must be on Blackboard Learn version 3200.7.0 or newer to be able to use this connector. Before you get started, you will need your Blackboard Application Key and Secret. A Blackboard admin should be able to help obtain this information.

Use the Blackboard Connector

1. Begin by clicking the Advanced menu, then click Connectors.
2. On the Connectors page, click the Configure button next to Blackboard Connector.
3. From the Configure Blackboard Connector page, you can determine the status of the Blackboard Connector by switching it on or off. For example, you may leave it off while you are finalizing your configurations and then turn it on when you are ready to go live with your end users. The default status is off.
   
   
4. Next, begin your configurations by entering your Blackboard URL. [Required]
   
5. Enter your Blackboard Application Key and Blackboard Secret. [Required]
   • The Blackboard Application Key and Secret come from your developer keys within Blackboard. Talk to your Blackboard admin to obtain these.
6. Indicate what you want the Oauth Redirect Modal Title to say.
   • This step controls the text that is displayed in the title of the modal window that informs the individual end users that they need to authorize the Blackboard connection.
   • The default oauth redirect modal title is “Authorize OneCampus to Access Blackboard”.
7. Indicate what you want the Oauth Message to say.
   • This step controls the text that is displayed within the modal window that informs the individual end users that they need to authorize the Blackboard connection.
   • The default oauth message is “Blackboard and OneCampus are now connected but you need to authorize the connection. Do you want to authorize the connection?”
     
8. Indicate what you want the Oauth Deauthorization Message to say.
   • This step controls the text that is displayed within the deauthorization modal window that informs the individual end users of what they are about to do should they click the deauthorize button located within their options button.
   • The default oauth deauthorization message is “Do you want deauthorize the connection? This will remove the section Blackboard Connector from the store page but you can re-authorize in the Preferences panel if you change your mind.”
     
9. Next, customize the OneCampus Front Page Fields. Start by choosing a Title.
   • The title will be the header for the section where the Blackboard courses appear on your OneCampus main page.
   • The default title is “Blackboard Connector Tasks” but you can change this to whatever is appropriate.
     
10. Choose an Image Set to represent the Blackboard tasks.
    • The image you choose will appear on the task tile for each Blackboard course within OneCampus.
11. Choose a Task to associate with this Connector for Announcements. [Optional]
    • You may or may not already have a Blackboard task set up in OneCampus. If you do, select it from the drop down. If you don't, you will need to create one and revisit this configurations page to associate it with this connector.
    • Please see additional instructions at the bottom of this guide for Adding announcements to the Blackboard section.
12. Choose the area within BlackBoard that you want the Task Tiles to Link to. [Optional]
    • You have the option of selecting “Course Page”, “Announcements” or “Blackboard Dashboard” from the drop down.
      • If "Blackboard Dashboard" is selected, end users will be directed to the Blackboard dashboard each time they click on a Blackboard task.
      • If "Announcements" is selected, end users will be directed to the announcements section within Blackboard.
      • If "Course Page" is selected, end users will land on the specific course details page within Blackboard.
    • The default value for this drop down is “Course Page”.
13. Configure an ACL Expression/s. [Optional]
    • Leaving the ACL section empty will allow everyone access to the connector.
    • Administrators can add ACL expressions to restrict this connector to specific users. Only those identified users will see the connector authorization modal windows as well as see their courses pull through onto the OneCampus main page.
      • Select Or from ACL Expression drop down
      • Click the green [+] sign
      • Select Condition from Expression Type
      • Select a unique identifier from the Value dropdown
      • In the Is Equal To box, enter the data that matches the Value selected
      • Click Add
14. Click Save. (Once the configurations have been saved, and if the status switch described in step three is turned on, your end users will be presented with the Blackboard Authorization modal window upon their next login)
    • You also have options to Cancel or Delete the configurations at this point.
      • Clicking cancel before clicking save will discard anything you entered, however, if an existing configuration had been saved previously, that saved configuration will NOT be changed OR discarded.
      • Clicking Delete will remove the configurations you have set up and disable the Blackboard Connection.

Notes:

• Once an end user confirms that they want to authorize the Blackboard Connection, they will be presented with a Blackboard login page and an authorization window.
  • Clicking Authorize in this window is the final step and will cause their Blackboard courses to appear as tasks on the main OneCampus page.
    
  • By default, Blackboard tasks will appear at the bottom of the main OneCampus page. Administrators can change this by visiting the Main Page Layout module within the Branding Section. From the Main Page Layout screen, drag and drop the Blackboard section to the desired location on the page.
• If an end user inadvertently dismisses the Blackboard Authorization modal window, they can authorize the Blackboard connection by clicking the “Authorize” button that is located within their Preferences section beneath the sign in drop down.
  
  
• If an end user clicks the gear icon next to the Blackboard Connector Tasks header they will be presented with options to “Deauthorize” their Blackboard connection or change the display size of their Blackboard task tiles.
  
  
• Please refer to the Quick Start Guide for the Connectors Error Log for additional information in regards to connector related errors that your end users might be receiving.
• Please refer to the Quick Start Guide for the Users Report for additional information in regards to how a OneCampus Administrator can deauthorize the Blackboard Connector for a specific user.

Adding an Announcement to the Blackboard tasks section

To add an Announcement to the Blackboard Tasks section, please follow these steps:

1. You will first need to make sure that an actual task for Blackboard (not a course task but an actual task for Blackboard) exists in your tenant. If there isn't a Blackboard task set up in your system currently you will need to make one.
2. Next, go to the Announcements module and create a task level announcement for that Blackboard task.
3. Click Save.

Once saved, you will see an announcement indicator next to the Blackboard Tasks section on the main OneCampus page. It will also be on the Blackboard task tile that links directly. If you click on any of your courses the announcement modal window will pop up.

• Blackboard Connector - Quick Start Guide.pdf300 KB

Updated July 29, 2024 14:41