English Español Français
1-888-257-2278 Go to YuJa
  1. YuJa Help Center
  2. Panorama Accessibility Platform
  3. Blackboard Ultra Integration
  4. Administrators

Integrating YuJa Panorama for Accessibility Learning 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). If you have any questions regarding any steps in this process, please contact your dedicated Customer Success Manager.

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

  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 based on your zone.
    • US Zone: 8ef2a880-d78e-4fab-be15-cedce9891dac
    • CAN Zone: 3a786e8b-d25e-4b52-9ebe-5556472822d1
    • EU Zone: ab8952c5-d702-4b28-b748-536ea531678e
  6. Click Browse to search for the user that 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 configure Panorama to your Blackboard Ultra instance. 

Panorama Configuration for Blackboard Ultra LTI 1.1

The Panorama configuration for Blackboard Ultra LTI 1.1 requires you to have received your Tool Provider Key and Tool Provider Secret from your Customer 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
  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 Customer 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
  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 completed the Panorama integration process for Blackboard Ultra LTI 1.1 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.

Related articles