Skip to main content

Search

Perusall Support

Blackboard LTI 1.3

  • Updated

Administrator Setup (Production)

Administrator Setup (Staging)

Instructor Setup

Upgrading from LTI 1.1 to LTI 1.3

There are several benefits to upgrading to LTI 1.3. First, creating individual assignment links in your LMS is no longer necessary to sync individual assignment scores to your LMS. Students can use a generic Perusall link and individual assignment scores will still be sent to the LMS. You can still create individual assignment links, called “deep links” in LTI 1.3, which point to particular Perusall assignments even when the link and assignment do not have matching names. (Note: deep links are automatically created in Blackboard as you create Perusall assignments.) Second, your LMS course roster automatically syncs to your Perusall course; instructors will be able to view the full roster in Perusall even before students ever launch into Perusall. That way, instructors can set up groups in advance of the start of the semester.

A few important notes about migrating an LTI 1.1 integration to an LTI 1.3 integration:

  • Users who initially created their Perusall account through an LTI 1.1 integration will receive a one time confirmation email the first time they launch Perusall through an LTI 1.3 integration.
  • Existing Perusall courses cannot be upgraded from LTI 1.1 to LTI 1.3; LTI 1.3 will only apply to newly-created courses. Since some LMSs do not allow for both a LTI 1.1 integration and a LTI 1.3 integration to be active simultaneously, we recommend switching over to LTI 1.3 between semesters. Previously created LTI 1.1 courses will not be deleted; instructors will still be able to access them from within their Perusall account even if they can no longer launch them from the LMS. 

Administrator Setup (Production)

  1. Navigate to System Admin > Integrations > LTI Tool Providers, and select Register LTI 1.3/Advantage Tool.
  2. For Client ID, enter fb7bbf2e-b041-4d35-bf2d-2e5f1f7168a6 and click Submit. 
  3. Take note of the Deployment ID that is shown in the next screen, and send this to Perusall Support.
  4. Under Institution Policies, ensure Role in Course, Name, and Email Address are all checked, and that both grade access service and Membership Service Access are set to Yes. Then click Submit.
  5. Select Manage placements, and ensure that the deep link placement is set to open in a new window.
  6. Navigate to System Admin > System Roles > Create a Role.
    • Name: Perusall API
    • Role ID: perusallapi
    • Description: This is the user that Perusall will act as when accessing group information for your courses.
    • Assign the following privileges:
      • Course/Organization > Groups > View All Groups
      • Course/Organization Control Panel (Users and Groups) > Groups
  7. Navigate to System Admin > Users > Create User.
    • First Name: Perusall
    • Last Name: API
    • Username perusallapi
    • Password should be unique.  It's not an account that's ever going to be used to log in.
    • Primary Institution Role: Student
    • Primary System Role: Perusall API
  8. Navigate to System Admin > Integrations > REST API Integrations, and select Create integration.
  9. Enter the following values, and then click Submit.
    • Application ID: fb7bbf2e-b041-4d35-bf2d-2e5f1f7168a6
    • Learn User: Perusall API
    • End User Access: Yes
    • Authorized To Act As User: No

Once Perusall Support has received your Deployment ID and activated in the integration, your instructors can use Perusall in their courses. 

Administrator Setup (Staging)

Staging is only for testing and should not contain any real course or student data. 

Disclaimer: Data on staging may be removed at any time. 

  1. Navigate to System Admin > Integrations > LTI Tool Providers, and select Register LTI 1.3/Advantage Tool.
  2. For Client ID, enter 2639a1cf-9230-4441-aae8-701c7414e145 and click Submit. 
  3. Take note of the Deployment ID that is shown in the next screen, and send this to Perusall Support.
  4. Under Institution Policies, ensure Role in Course, Name, and Email Address are all checked, and that both grade access service and Membership Service Access are set to Yes. Then click Submit.
  5. Select Manage placements, and ensure that the deep link placement is set to open in a new window.
  6. Navigate to System Admin > System Roles > Create a Role.
    • Name: Perusall API
    • Role ID: perusallapi
    • Description: This is the user that Perusall will act as when accessing group information for your courses.
    • Assign the following privileges:
      • Course/Organization > Groups > View All Groups
      • Course/Organization Control Panel (Users and Groups) > Groups
  7. Navigate to System Admin > Users > Create User.
    • First Name: Perusall
    • Last Name: API
    • Username perusallapi
    • Password should be unique.  It's not an account that's ever going to be used to log in.
    • Primary Institution Role: Student
    • Primary System Role: Perusall API
  8. Navigate to System Admin > Integrations > REST API Integrations, and select Create integration.
  9. Enter the following values, and then click Submit.
    • Application ID: fb7bbf2e-b041-4d35-bf2d-2e5f1f7168a6
    • Learn User: Perusall API
    • End User Access: Yes
    • Authorized To Act As User: No

Once Perusall Support has received your Deployment ID and activated in the integration, your instructors can use Perusall in their courses.  For secure delivery, we recommend sending this information using https://privnote.com. 

Instructor Setup

  1. To set up your Perusall course, in your Blackboard course click Tools in the left navigation bar and select Perusall. From your Perusall course, you can select/upload content and create assignments. *If you don't see Perusall in Tools, it's possible that your IT admin has removed access there. You can Launch Perusall by going to Build Content > Perusall, and you'll be prompted to build your course, there.
  2. Optionally, you can create "deep links" to specific Perusall assignments. (See Assignment-Specific (Deep links) Creation below)
    To do this, navigate to a content area, select Build Content > Perusall Deep Link, and then you will be presented with a list of your Perusall assignments. Click on one of them to add it to that content area of your Blackboard course.

Grade sync

Perusall will automatically create gradebook columns for syncing grades. There is no need to create individual assignment links in Blackboard in order for grades to sync automatically.

Assignment-Specific (Deep links) Creation

In either case, there is no need to create individual links to each Perusall assignment; however, if you would like to do so, you can create "deep links" into the corresponding Perusall assignment. To do this,

  1. You must first create the assignment in Perusall
  2. Navigate to Settings > Scoring > Grade Sync to LMS > LMS gradebook column management, set to Instructor creates deep links in LMS; no Perusall gradebook columns will appear in LMS until deep links have been created > Click Save Changes.
  3. Go to Build Content > Perusall Deep Link(created by your IT admin).
  4. A window will pop up that will allow you to select a Perusall assignment to link.