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.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). If you have any questions regarding the 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 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 Customer 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 Customer Success Manager.
  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.

Panorama Configuration for Blackboard Ultra LTI 1.3

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 Customer 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 Customer Success Manager. 
  6. Click Submit.
  7. Important: On the next page, your Deployment ID will be located under Tool Status. Provide your Customer Success Manager with the Deployment ID.  
  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.
  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 Customer 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. 

Related articles