1-888-257-2278 Go to YuJa
  1. YuJa Help Center
  2. Panorama Accessibility Platform
  3. Blackboard Ultra Integration
  4. Administrators

Integrating Panorama Digital Accessibility into Blackboard Ultra Using LTI 1.3

Avatar
YuJa Product Support
  • Updated

This document provides institution admins with instructions on integrating the Panorama Platform into their Blackboard Ultra Learning Management System (LMS). Before proceeding with the steps below, please ensure that you have full access to your Blackboard instance as an admin. If you have any questions regarding the steps in this process, please contact your dedicated Client Success Manager.

Adding Panorama to Blackboard

The following steps are only for institutions that have access to Blackboard Ultra LTI 1.3. Before proceeding with the steps below, please ensure you have received a Client ID from your Client Success Manager.

  1. Log in to Blackboard Ultra as an Admin.
  2. In the side panel, click on Admin.
  3. Under Integrations, select LTI Tool Providers.
     
  4. Click Register LTI 1.3/Advantage Tool.
     
  5. Enter the Client ID you received from your Client Success Manager. 
  6. Click Submit.
  7. Important: On the next page, your Deployment ID will be located under Tool Status. Please send the Deployment ID to your Client Success Manager. 
  8. Scroll down and set Tool Status to Approved.
  9. For User Fields to Send, select Role in course, Name, and Email Address.
  10. Ensure that Allow grade service access, Allow Membership Service Access, and Show User Acknowledgment Message are set to No.
  11. Click Submit.
  12. Once you are redirected to the following page, click the More Options icon, and select Manage Placements.
  13. Click Create Placement.
  14. Fill in the following information.
    • Label: Panorama 
    • Handle: Panorama 
    • Availability:Yes
  15. For Type, select Course tool and Allow student access.
  16. Enter the Target Link URL based on your zone.
    • US Zone: https://panorama-api.yuja.com/lti/lti-app-1.3-entry
    • CAN Zone: https://panorama-api-cz.yuja.com/lti/lti-app-1.3-entry
    • EU Zone: https://panorama-api-ez.yuja.com/lti/lti-app-1.3-entry
    • AUS Zone: https://panorama-api-az.yuja.com/lti/lti-app-1.3-entry
  17. Next, enter the following Tool Provider Custom Parameters:

    • user_id=@X@user.pk_string@X@

    • system_role=@X@user.role@X@

    • course_pk=@X@course.pk_string@X@

  18. Click Submit. 
  19. Once your Client Success Manager has entered your Deployment ID, sent earlier, the Panorama configuration process for Blackboard Ultra LTI 1.3 will be complete. 

Once you have completed the Panorama integration process for Blackboard Ultra LTI 1.3, you may add the Panorama LTI link to your desired courses. 

  1. Log in to Blackboard Ultra as an Admin or Instructor and navigate to the desired course.
  2. Under the Details and Actions section, click Book & Tools.
  3. From the right-hand menu, locate Panorama and click the Plus icon to add Panorama to the Course Content page. 
Please note: If you cannot locate the Panorama tool, the institution admin needs to change the tool availability to ensure Panorama is available. 

Creating a System Role 

In order for Panorama to access your institution's data, a new System Role for Panorama needs to be created.

  1. Log in to Blackboard Ultra as an admin.
  2. In the side panel, click on Admin.
  3. Under Users, click System Roles. 
  4. Click Create Role.
  5. Assign the Role Name as Panorama Role.
  6. Assign the Role ID as PanoramaRole
  7. Click Submit.

  8. You will be redirected to the following page. Assign the following privileges by searching them within the Search field and selecting the checkbox. 

    • Administrator Panel (Courses) > Courses

    • Administrator Panel (Courses) > Courses > Edit > Enrollments

    • Administrator Panel (Courses) > Courses > Edit > Course Properties

    • Administrator Panel (Courses) > Terms

    • Administrator Panel (Users) > Users

    • Administrator Panel (Users) > Users > Edit > View Course Enrollments

    • Administrator Panel (Organizations) > Organizations > Edit > Enrollments

    • Course/Organization (Content Areas) > Adaptive Release > View

    • Course/Organization (Content Areas) > View Material Settings

    • Read-only access to the Content System filesystem

  9. After selecting the privileges, click Privileges, and select Permit Privileges. 

Assigning the System Role to a User

Once the Privileges have been permitted, the Panorama Role must be assigned to a user who you plan to create a REST integration with. 

  1. Log in to Blackboard Ultra as an Admin.
  2. In the side panel, click on Admin.
  3. Click Users.
  4. Assign the Panorama Role to a new or existing user. 
    • To assign the role to a new user, click Create User.
    • To assign the role to an existing user, use the Search field to locate the user. Then, click the Options Menu icon next to their username, and select Edit.  
  5. Scroll down to System Roles and select the Panorama Role to insert it into the Selected Roles for the user.
  6. Click Submit.

Installing the Blackboard REST Integration 

The REST integration allows Panorama to access files and folders within Blackboard Ultra. Before following the steps below, please ensure you have received an Application ID from your Client Success Manager.

  1. Log in to Blackboard Ultra as an Admin.
  2. In the side panel, click on Admin.
  3. Under Integrations, click REST API Integrations.
     
  4. Click Create Integration.
  5. Enter the Application ID you've received from your Client Success Manager.
  6. Click Browse to search for the user who was assigned the Panorama Role.
  7. Set End User Access to Yes.
  8. Set Authorized To Act As User to Service Default (No).
  9. Click Submit and continue to the next section of this guide.

Integrating Blackboard With Panorama

The final process is to establish a connection between your Blackboard instance and Panorama so that Panorama can retrieve data. Before proceeding with the steps below, please ensure you have received your access token from your Client Success Manager. 

  1. Access the Panorama Platform, click Configurations, and then select Integration Settings. 
  2. Under the Select Integration drop-down menu, select LMS API.
  3. Click Add Access Key.
  4. Under Access Token, paste the access token received from your Client Success Manager. 
  5. Click Add Access Key.
  6. Click Save Changes. Panorama will now be able to retrieve information from your Blackboard instance. 

Related articles