Kaltura Video Tool for Blackboard Ultra Deployment Guide

This guide is intended for Kaltura and Blackboard-Ultra administrators.

Prerequisites for the Kaltura Video Tool for Blackboard-Ultra

• Partner Id (“pid”), e.g., 12345678
• Admin secret, e.g., f79359d3227f45be73c181489888afc5
• A Kaltura Application Framework (KAF) instance URL of type ‘BlackboardUltra’, for example, 12345678.kaf.kaltura.com

The KAF instance should contain the following modules

• Hosted module
• Hostedrelated module
• LTIgrading module
• Browseandembed  module
• Blackboardultra module

Before Starting the Installation Process

You should receive the following:

• Launch point base URL that will be used further in the process.
• Administration application login page URL.

Contact your Kaltura representative to create a KAF instance for your Blackboard Ultra.

Deployment Instructions

Creating the REST API Integration

The REST API Integration allows you to use the BB REST API to publish content from My-Media to Media Galleries.

1. Login to Blackboard Ultra as an admin.
2. Go to “Administrator Tools” and select REST API Integrations.
   
3. Click the “Create Integration” button:
   
4. Set the following:

• “Application ID”: Use the Kaltura Application ID: 8d68a3e5-4643-4152-bded-6bca9eb39312
• Set the “Learn User” to a BB Admin user that will be used :
• Set the “End User Access” to YES.
• Set the “Learn User” to "Service Default (No)".
  
  
• Click Submit.

Creating a Tool Provider

This section describes how to create a Tool Provider so that you can deploy the Kaltura Video Extension for Blackboard Ultra. The Tool Provider allows you to enter the Kaltura key and secret one time for all the Kaltura tools.

1. Login to Blackboard Ultra as an admin.
2. Go to “Administrator Tools” and select LTI Tool Providers.
   
3. Navigate to the “Register Provider Domain” tab:
   
4. Set the following:

• “Provider Domain”: Use your KAF URL. (e.g.: https://123456.kaf.kaltura.com)
• Set the “Default Configuration” to “Set globally” and add the following fields:
  • Tool Provider Key: Use your Kaltura Partner ID
  • Tool Provider Secret: Use your Kaltura Admin Secret
    
• Set the Institution Policies.
  
  • Select how and whether to Send User Data.
  • Select the User Fields to Send.

  • Be certain to check the 'Role in Course' checkbox to enforce the Blackboard Ultra system to send the "Role" to Kaltura.

  • Select whether to Allow Membership Service Access.

Deploying the Kaltura Tools

 This section describes how to add the following tools to your Blackboard environment:

• Kaltura My Media
• Kaltura Media Gallery
• Browse Search and Embed
• Interactive Video Quizzes

Each tool is independent of the others, and you may select to use any one of them or all of them.

1. Login to Blackboard Ultra as an admin.
2. Go to “Administrator Tools” and click on LTI Tool Providers.
3. Navigate to the “Register Provider Domain” tab and locate the Tool/Provider you created.
   
4. Click Manage Placements.
   

My Media

• Create a placement with the following info:
  1.  Label: My-Media
  2. Handle: KalturaMyMedia
  3. Availability: Yes
  4. Type: “System tool”
  5. Icon: The Kaltura icon can be downloaded from here.
  6. Tool Provider URL: Fill in your KAF URL concatenated with the following URL:
     “/bbultra/index/launch/target/my-media”
     For example: https://123456.kaf.kaltura.com/bbultra/index/launch/target/my-media
  7. Click Submit.

 To use My-Media on a system level, you must set the ‘KMSRole’ in the KAF’s Hosted module for the None LTI role to “privateOnlyRole”. If you do not want to make this change, the My-Media tool may be reached from within the Blackboard ”Content Market”.

Media Gallery

• Create a placement with the following info
  1. Label: Media Gallery
  2. Handle: KalturaMediaGallery
  3. Availability: Yes
  4. Type: “Course tool” and/or “Course content tool” (*NOTE)
  5. Icon: The Kaltura icon can be downloaded from here.
  6. Tool Provider URL: Fill in your KAF URL concatenated with the following URL:
     “/hosted/index/course-gallery”
     For example: https://123456.kaf.kaltura.com/hosted/index/course-gallery
  7. Click Submit.

Note: There are 2 ways of creating the Media Gallery, that effect the location of the tool in the course. To make both locations available - create 2 different placements and select a different type in step #4.

Browse Search and Embed (BSE)

• Label: Kaltura Embed
  1. Handle: KalturaBSE
  2. Availability: Yes
  3. Type: “Course content tool”
     Allow “Deep Linking content tool”.
  4. Icon: The Kaltura icon can be downloaded from here.
  5. Tool Provider URL: Fill in your KAF URL concatenated with the following URL:
     “/browseandembed/index/browseandembed”
     For example: https://123456.kaf.kaltura.com/browseandembed/index/browseandembed
  6. Click Submit.

Kaltura Video Quizzes

• Create a placement with the following info:

1. Label: In-Video Quiz
2. Handle: KalturaIVQ
3. Availability: Yes
4. Type: “Course content tool”
   Allow “Deep Linking content tool”.
5. Icon: The Kaltura icon can be downloaded from here.
6. Tool Provider URL: Fill in your KAF URL concatenated with the following URL:
   “/browseandembed/index/browseandembed?type=quiz”
   For example: https://123456.kaf.kaltura.com/browseandembed/index/browseandembed?type=quiz
7. Click Submit. 

In order for the quiz grade to be sent to the gradebook, make sure that in the KAF admin page, under the Browseandembed module, the 'sendCimLineItem' field is set to "When Filtering for Quiz".

If set to "For Any Quiz" - entries of type quiz results will be sent to the gradebook when using the BSE placement as well, thus removing the need for another placement (however it means that you cannot stop specific quiz's grades from entering the gradebook). More information about Kaltura Video Quizzes may be found here.