Faculty Support

Blackboard: LTI Integration

Last Updated: Jul 11, 2018 03:45PM EDT

Blackboard Integration with Acrobatiq

This guide describes how to configure Blackboard for use with the Acrobatiq platform.  The Blackboard integration uses LTI to authenticate students to the Acrobatiq platform and a custom-building block to report student scores from Acrobatiq to the Blackboard gradebook.  The setup process requires administrator access to Blackboard will take approximately 45 minutes to complete.

Part 1: Add Acrobatiq as an LTI Tool Provider


Acrobatiq uses the LTI standard for one-click access from Blackboard.  LTI enables users to securely access Acrobatiq courseware without creating an account, signing in or registering for a course.  The Acrobatiq platform is role aware.  Users’ roles in Acrobatiq will match their roles in Blackboard.  Instructor-only features (such as course settings and gradebook) are only available to users enrolled in Blackboard with the instructor role. 


Additional setup is required to use some of the available features described below.

  • Single sign on and automatic course registration

  • Display your institution’s logo, navigation bar, and links

  • “Deep linking” to specific locations within the courseware

  • Role differentiation for students, instructors, assistants

  • Route customer service inquires to your internal help desk



Creating the LTI Tool Provider


1. Navigate to System Admin > Building Blocks > LTI Tool Providers.  Click the button “Register Provider Domain”



2. Complete Provider Domain Settings

  • Provider Domain: courses.acrobatiq.com

  • ​Provider Domain Status: Approved



3. Complete the Default Configuration


  • Default Configuration: Set globally

  • Tool Provider Key: Provided by Acrobatiq Support

  • Tool Provider Secret: Provided by Acrobatiq Support



4. Set Institution Policies


  • Send User Data: Send user data only over SSL

  • User Fields to Send: Role in Course, Name and Email Address

  • Show User Acknowledgment: No



Part 2: Install the Gradebook Building Block

The Acrobatiq platform offers a variety of learning activity and assessment types that are scored.  These scores are captured in a gradebook on the Acrobatiq platform, which can optionally sync to Blackboard’s grade center using a building block. 
The building block is required to synchronize student grades from the Acrobatiq platform to the Blackboard grade center.  It is a plugin developed by Acrobatiq and installed on the Blackboard server.  It uses Blackboard and Acrobatiq APIs to update scores in grade center.



Additional setup is required to use some of the available features described below.

  • Grades update automatically within Blackboard at set intervals

  • Select which activity and assessment types to send to Blackboard

  • Set preferred column titles and point values for Acrobatiq assignments

  • Zero maintenance; one-time installation and setup in Blackboard

  • Compatible with Blackboard’s course copy and archive functions

  • Upgrade, disable, remove building block without affecting grades


Add the Acrobatiq Building Block


Download the building block. Two builds are available, one for development/testing and one for production. The production build is recommended.  It updates scores approximately every 10 to 15 minutes.


The current and recommended version is: acr-gradebook-sync-0.9.10.war


1. Install and approve the building block by navigating to the building block section in your system admin area and click on “Installed Tools”.


 2.  Click on “Upload Building Blocks” and follow the prompts.


3.  Update security permissions.
The building block needs to be able to the following. All communications with Acrobatiq are encrypted and authenticated with OAuth (with signature, nonce and timestamp validation.)


  • Lookup users, courses, and memberships (enrollments).

  • Create and modify line items and outcome descriptions (grade center entries).

  • Create and modify scores.

  • Make outbound HTTPS connections to connect back to Acrobatiq.

  • Write a configuration file to its plugin directory.  No values are stored in the database.

  • Use certain Java APIs required by the OAuth and REST libraries it requires.

​4. From the Installed Tools menu, locate Acrobatiq Gradebook.  



5. Click Settings from the drop-down menu.  

6. Enter the values provided by Acrobatiq, (see addendum).

  • URL: https://platform-api.acr

  • Key/Secret: Provided by Acrobatiq

  • Security Settings: Use tool provider security settings



Step 2: Course Set Up

1. Add the URL provided by Acrobatiq to the course


2.  Enter the URL provided by Acrobatiq. Alternatively, you can deep link to a specific page of the course. Check the box indicating the link is to a Tool Provider.

3. Enroll in the Blackboard course and verify that you can access the link

Integration Testing

Test the integration by completing assignments as a student in the Acrobatiq platform (via LTI launch in Blackboard)
NOTE: When testing this link, a Blackboard account with the role of "instructor" should be used, because Acrobatiq is expecting an instructor to use the link to attach an Acrobatiq course to the Blackboard class environment. An "admin" role may receive an error.



Contact Support

seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found