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

Integrating Panorama Digital Accessibility into Blackboard Ultra Using LTI 1.1

Avatar
YuJa Product Support
  • Updated

This document provides instructions on integrating the Panorama Platform into your 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 questions regarding any steps in this process, please contact your dedicated Client Success Manager.

Adding Panorama to Blackboard Ultra 

The Panorama configuration for Blackboard Ultra requires you to have received your Tool Provider Key and Tool Provider Secret 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 LTI Tool Providers.
  4. Click Register LTI 1.1 Provider.
  5. Enter the Provider Domain based on your zone.
    • US Zone: panorama-api.yuja.com
    • CAN Zone: panorama-api-cz.yuja.com
    • EU Zone: panorama-api-ez.yuja.com
    • AUS Zone: panorama-api-az.yuja.com
  6. Set Provider Domain Status to Approved.
     
  7. For Default Configuration, select Set globally. 
  8. Enter the Tool Provider Key and Tool Provider Secret provided by your Client Success Manager. 
  9. Set Send User Data to Send user data only over SSL.
  10. For User Fields to Send, check Role in Course and Name.
  11. Set Allow Membership Service Access and Show User Acknowledgment Message to No.
  12. Click Submit.
  13. You will be redirected to the LTI Tool Providers page. Click on the More options icon next to the newly created tool, and select Manage Placements. 
  14. Click Create Placement 
  15. Fill in the following information.
    • Label: Panorama 
    • Handle: Panorama 
    • Availability Yes
  16. For Type, select Course tool 
  17. Enter the Tool Provider URL based on your zone:
    • US Zone: https://panorama-api.yuja.com/lti/lti-app
    • CAN Zone: https://panorama-api-cz.yuja.com/lti/lti-app
    • EU Zone: https://panorama-api-ez.yuja.com/lti/lti-app
    • AUS Zone: https://panorama-api-az.yuja.com/lti/lti-app
  18. 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@

  19. Click Submit to complete the integration process. You may now add the Panorama LTI link to your desired courses.

Once you have added Panorama to Blackboard Ultra, you may add the Panorama LTI link to your desired courses. 

  1. Log in to Blackboard Ultra as an admin or instructor.
  2. In the side panel, click on Courses, and select the course you wish to add the Panorama LTI link to.
  3. In the top-right corner, ensure Edit Mode is: ON.
  4. Click the Plus (+) icon located in the side panel, and then select Course Link.
  5. Click Browse.
  6. Select the Panorama LTI link.
  7. Check Available to Users.
  8. Click Submit to add the Panorama LTI link to the course side panel.

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 to Panorama Role.
  6. Assign the Role ID to 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 user or an 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, select the Panorama Role, and insert it into the user's Selected Roles.
  6. Click Submit.

Installing the Blackboard REST Integration 

The REST integration allows Panorama to communicate with Blackboard Ultra. Before proceeding with the steps below, please ensure you have received your 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 provided to you by 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 move to the next section of this guide to integrate Panorama to your Blackboard Ultra instance. 

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 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