Integrating the YuJa Enterprise Video Platform into Blackboard SaaS/Ultra Using LTI 1.1

This document provides instructions on integrating the YuJa Enterprise Video Platform into your Blackboard Learning Management System (LMS). If you have any questions regarding any steps in this process, please contact your dedicated Customer Success Manager. To perform the integration, you will need a YuJa Key, Shared Secret, and Zone URL. 

Configuring the Video Platform LTI

Adding the Video Platform as a Global Tool Provider

Adding the Video Platform as a Global Tool Provider allows instructors to conveniently link to the Video Platform from their course site. Follow these steps to manage the default settings for LTI Tool Providers. You can override these settings on an individual basis as needed.

1. Log in to Blackboard as an Admin and access the Admin area.
   

   

2. Navigate to Integrations → LTI Tool Providers.
   

   

3. Select Register LTI 1.1 Provider.
   

   

4. Under Provider Domain Status, enter the information as followed.
   

   

   • Provide Domain: Your YuJa Zone URL provided in your Zone Provisioning document - an example would be evergreen.yuja.com.
   • Provider Domain Status: Approved.
5. Under Default Configuration, enter the information as followed.
   

   

   • Default Configuration: Set Globally.
   • Tool Provider Key: YuJa Key provided in your Zone Provisioning document.
   • Tool Provider Secret: Shared Secret provided in your Zone Provisioning document.
6. Under Institution Policies, enter the information as followed.
   

   

   • Send User Data: Send user data over any connection.
   • User Fields to Send: Role in Course, Name, and Email Address.
   • Allow Membership Service Access: Select No.
   • Show User Acknowledgment Message: Select Yes or No. If selected Yes, enter the desired user acknowledgement message in the Message Text field.
7. Select Submit to save your LTI.
8. Select Manage Global Properties.
   

   

9. Under Feature Availability, enter the information as followed.
   

   

   • • Creation of Tool Provider Links: Allow links to any tool provider, but require approval for each new provider.
     • Allow configured tool providers to post grades: Yes.
10. Under Default Configuration, enter the information as followed.
    

    

    • Send User Data: Send user data over only SSL.
    • User Fields to Send: Role in Course, Name, and Email Address.
    • Allow Membership Service Access: No
    • Show User Acknowledgement Message: select Yes or No to choose whether a user acknowledgment message displays when the user clicks a Learning Tool link.
      • If you selected Yes to Show User Acknowledgment Message, enter the desired user acknowledgment message in the Message Text field.

    

11. Click Submit.

Adding an LTI Placement for the Video Platform

LTI placement, including a name and link, makes it easy for end-users to find and use the Video Platform. Although it is not required, managing the placement of the tool is strongly recommended. 

1. Log in to Blackboard as an Admin and access the Admin area.
   

   

2. Navigate to Integrations→ LTI Tool Providers.
   

   

3. Click the down arrow to the right of your YuJa tool to access a drop-down menu of available actions.
   

   

4. Select Manage Placements.
   

   

5. Select Create Placement.
   

   

6. Under Placement Information, enter the information as followed.
   

   

   • Label: YuJa.
   • Description: enter an optional description that will be visible to Students in their Tools menu and invisible to Instructors.
   • Handle: enter a single word unique identifier to use as the database entry.
   • Availability: Yes.
   • Type: Course Tool and Allow student access
   • Icon: click Browse to add an icon for the YuJa tool which can be downloaded from https://<YOUR_YUJA_DOMAIN>/P/LTI/Blackboard/yuja_basic.png
7. In the Tool Provider URL, enter https://<YOUR_YUJA_DOMAIN>/LMSEntry.jsp
   

   

8. Click Submit.

Installing the Video Platform in All Courses or Select Courses

After completing the section labeled Configuring the Video Platform LTI, there are two LMS installation options that you can choose from:

1. Enable YuJa in Future Courses - This enables the Video Platform by-default in all future Blackboard Ultra courses. This does not apply to already existing courses in Blackboard. To perform this, see the section labeled Installing the Video Platform for Future Courses.
2. Enable YuJa in Select Courses – This enables instructors and administrators to add the Video Platform to specific courses including existing courses in Blackboard. To perform this, see the section labeled Installing Video Platform for Select Courses.

Installing the Video Platform for Future Courses

1. Log in to Blackboard as an Admin and access the Admin area.
   

   

2. Navigate to Courses → Course Settings.
   

   

3. Select Course Menu and Structures.
   

   

4. Hover over the + icon to open a drop-down menu and select Tool Link.
   

   

5. Enter the information as followed.
   

   

   • Name: YuJa
   • Type: select your YuJa LTI.
   • Available to Users: check the box off.
6. Select Submit.

Installing the Video Platform for Select Courses

1. Log in to Blackboard as an Instructor and select the course you wish to extend the Video Platform to.
2. Under Books & Tools, select View course & institution tools.
   

   

3. From the list of available tools, select YuJa.

Accessing the Video Platform from Blackboard Ultra

The Video Platform will provision the group space with the information provided by the LTI, including course name, user name, user roles, and permissions within the course. 

1. Log in to Blackboard as an Instructor or Student and select the course that the Video Platform has been extended to.
2. Under Course Content, select the YuJa link.
3. Confirm you can access the Video Platform from Blackboard.
   

   

Configuring the Deep Linking-Based YuJa Media Chooser

This section assumes you have completed the section labeled Configuring the Video Platform LTI.

1. Log in to Blackboard as an Admin and access the Admin area.
   

   

    

2. Navigate to Integrations→ LTI Tool Providers.
   

   

3. Click the down arrow to the right of your YuJa LTI to access a drop-down menu of available actions.
   

   

4. Select Manage Placements.
   

   

5. Select Create Placement.
   

   

6. Under Placement Information, enter the information as followed.
   

   

   • Label: YuJa Media Chooser.
   • Handle: YuJa Media Chooser.
   • Availability: Yes.
   • Type: Deep Linking content tool. Select "Allow student access" to enable the ability for students to embed media. 

In some instances of Blackboard, this placement type will be labeled Supports Deep Linking. Do not select Placement allows grading.

Creating the Video Quiz in the Video Platform

The Video Platform enables Content Creators to link Video Quizzes within the Blackboard Ultra experience to properly sync grade results between the two systems. In order to achieve this, a unique Blackboard Content Item needs to be linked to a unique Video Quiz created within the Video Platform. The workflow below summarizes how to complete the sync process. The first step of the sync process is to create a Video Quiz on the Video Platform. You can find the steps to complete this here.

Inserting the Video Quiz

The second step of the sync is to create a new Video Quiz within Blackboard under the Course Content page. 

Taking the Video Quiz

Now that the Video Quiz has been inserted in the Course Content area, grades will automatically sync once the student completes the Video Quiz submission. Below is the workflow for students to complete to ensure grades are properly synced. The steps below are directed toward the student.

Reviewing Grades

Once the student completes the Video Quiz, their results will automatically synced to the course Gradebook. 

Optional - Advanced Configuration for Adding the YuJa Media Library Module

This section assumes you have completed the section labeled Configuring the Video Platform LTI and Installing the YuJa Media Chooser for Blackboard Ultra.

1. Log in to Blackboard as an Admin and access the Admin area.
   

   

2. Navigate to Integrations → LTI Tool Providers.

   

    

3. Click the down arrow to the right of your YuJa LTI to access a drop-down menu of available actions.
   

   

4. Select Manage Placements.
   

   

5. Click the down arrow to the right of your YuJa placement to access a drop-down menu of available actions.
   

   

6. Select Edit.
   

   

7. In the Tool Provide Customer Parameters field, enter override_lti_landing_page=media Library then select Submit.
   

   

8. Navigate to the Admin area.
   

   

9. Navigate to Communities → Tabs and Modules.
   

   

10. Select Modules.
    

    

11. Click the down arrow to the right of your YuJa Module module to access a drop-down menu of available actions
    

    

12. Select Edit Properties.
    

    

13. Under General Properties, enter the information as followed.
    

    

    • Title: enter the most accurate title for YuJa used based on your organization's branding.
    • Description: enter a description for the module.
14. Select Submit.
15. Optional - Click the down arrow to the right of your YuJa Module module to access a drop-down menu of available actions and select Edit Contents to change the text that is displayed in the module.