Integrating Panorama Digital Accessibility into Blackboard Learn

This document provides instructions on integrating the YuJa Panorama Platform into your Blackboard 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 Customer Success Manager.

Overview

The below steps will allow you to make the Panorama Platform an accessibility tool for all courses in your Blackboard Learn instance.

Installing Panorama Web Services in Blackboard for the YuJa Panorama - LMS Connector

The guide below will provide System Admins instructions on how to install Panorama Web Services in order to use the YuJa Panorama - LMS Connector.

1. Log in to Blackboard as a System Admin. Click on the System Admin option on the top bar. Next, choose the Building Blocks option under Building Blocks.
   

   

2. Select the Installed Tools option then choose Upload Building Blocks.
   

   

3. Browse and select the panorama-blackboard.war file that was sent to you by your YuJa Customer Success Manager.
   

   

4. Click Submit to proceed with the installation.
5. On the next screen, click Approve.
   

   

6. Click Return once the installation finishes.
   

   

Installing the Blackboard REST Integration

1. Log in to Blackboard as a System Admin. Click on the System Admin option on the top bar. Next, choose the REST API Integrations option under Building Blocks.
   

   

2. Click on the Create Integration button.
   

   

3. Fill in the details as follows:
   • Application ID: Please reach out to your Customer Success Manager for the Application ID.
   • Learn User: Any user with administrative privileges (to get all the course information).
   • End User Access: Yes.
   • Authorized To Act As User: Service Default (No).
4. Click Submit to complete the installation. Ensure that the application is available.
   

   

Installing the YuJa Panorama - LMS Viewer

1. Log into Blackboard as a System Admin. Click on the System Admin option on the top bar.
2. Under Tooles & Utilities, select Panorama Settings.
   

   

3. Enter in the following information and click Save.
   

   

• Choose Environment: Production - (Your Region).
• Student Identifier Key: Student API Key that was sent over by your YuJa Customer Success Manager.
• Instructor Identifier Key: API Key that was sent over by your YuJa Customer Success Manager.
4. Once done, the YuJa Panorama - LMS Viewer will be available for all courses in your Blackboard Learn instance.
   

   

5. The YuJa Panorama - LMS Viewer may take up to an hour to process depending on the number of documents on the queue. Users may choose to select the option for the On-Demand Alternative Format process to have the file ready in between 5 to 10 minutes.
   

   

Configuring the Panorama User Role

These steps will allow the Administrator to set up a Panorama Role for users to configure the Panorama settings without giving them System Admins access.

1. Log into Blackboard Learn as an Administrator, then go to System Admin and select System Roles.
   

   

2. Click on the Create Role button.
   

   

3. Enter the following information below and click on Submit.
   

   

• Role Name: Panorama Role
• Role ID: Panorama Role
4. On the following page, search for all the privileges below and change their status to Permit Privileges.
   

   

• 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) > Advanced: Adaptive Release > View
• Course/Organization (Content Areas) > View Material Settings
• Course/Organization Control Panel (Evaluation) > Performance Dashboard
• Read-only access to the Content System filesystem
5. Once the role is configured, go back to System Admin and click on Users.
6. Search for the user you want to assign this role to, then click on Edit.
   

   

7. Scroll down to the System Roles section, then assign the Panorama Role to the user.
   

   

8. Click Submit to apply the change.

Installing the YuJa Panorama LTI for Reports and Metrics

The last step will be installing the YuJa Panorama LTI to generate reports and metrics for each course as well as the whole institution.

1. Log into Blackboard Learn as an Administrator, then go to System Admin and select Building Blocks.
   

   

2. Next, click on the LTI Tool Providers and select the Register Provider Domain option.
   

   

3. Under Provider Domain Status, put in panorama-api.yuja.com (US), panorama-api-cz.yuja.com (Canada), panorama-api-ez.yuja.com (Europe), and set the status to Approved.
   

   

4. Scroll down to Default Configuration and fill out the following information. Click Submit when done.
   

   

   • Default Configuration: Set globally.
   • Tool Provider Key: LTI Consumer Key received from your YuJa Customer Success Manager.
   • Tool Provider Secret: Secret LTI Key received from your YuJa Customer Success Manager.
   • Send User Data: Send user data only over SSL
   • Allow Member Ship Service Access: No
   • Show User Acknowledgement Message: No
5. Click on the newly installed Panorama LTI Tool, choose the option for Manage Placements, then Create Placement.
   

   

6. Fill in the information as shown below.
   

   

   • Label: Panorama
   • Handle: Panorama LTI
   • Availability: Yes
   • Type: Course Tool / Non-Student (For older Blackboard versions, use Student Tool).
   • Launch in New Window: Enable.
7. Next, scroll down to the Tool Provider Information and fill in the following information. Click Submit when done.
   

   

   • Tool Provider URL: 
     • US: https://panorama-api.yuja.com/lti/lti-app
     • CAN: https://panorama-api.yuja.com/lti/lti-app
     • EU: https://panorama-api-ez.yuja.com/lti/lti-app
   • Tool Provider Custom Parameters: Enter these three parameters without the quotation marks on three separate lines: "user_id=@X@user.pk_string@X@", "system_role=@X@user.role@X@" and "course_pk=@X@course.pk_string@X@"
8. The following two steps are only needed for older Blackboard versions where the Panorama LTI is added as a Student Tool.
9. Navigate to any courses, then click on the Plus sign to add a new Course Link.
   

   

10. Search and select the Panorama tool from the list, and uncheck the Available to Users option to hide it from the students’ view.
11. Administrators now will have the ability to access the Panorama LTI and choose which course to have Panorama enabled.