This guide is intended for Kaltura and Blackboard-Ultra administrators.
[/collapsed]
[collapsed title="Prerequisites"]
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
[/collapsed]
[collapsed title="Before Starting the Installation Process"]
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.
[/collapsed]
[collapsed title="Deployment Instructions"]
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.
To Create the REST API Integration
- Login to Blackboard Ultra as an admin.
- Go to “Administrator Tools” and select REST API Integrations.
- Click the “Create Integration” button:
- 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.
[/collapsed]
[collapsed title="Creating a Tool Provider"]
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.
To Create the Tool Provider
- Login to Blackboard Ultra as an admin.
- Go to “Administrator Tools” and select LTI Tool Providers.
- Navigate to the “Register Provider Domain” tab:
- 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.
Note: 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.
[/collapsed]
[collapsed title="Deploying the Kaltura Tools"]
Deploying the Kaltura Tools
This section describes how to add the following tools to your Blackboard environment:
Each tool is independent of the others, and you may select to use any one of them or all of them.
To deploy each Kaltura tool:
- Login to Blackboard Ultra as an admin.
- Go to “Administrator Tools” and click on LTI Tool Providers.
- Navigate to the “Register Provider Domain” tab and locate the Tool/Provider you created.
- Click Manage Placements.
- Create a placement with the following info:
- Label: My-Media
- Handle: KalturaMyMedia
- Availability: Yes
- Type: “System tool”
- Icon: The Kaltura icon can be downloaded from here.
- 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 - 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”.
- Create a placement with the following info
- Label: Media Gallery
- Handle: KalturaMediaGallery
- Availability: Yes
- Type: “Course tool” and/or “Course content tool” (*NOTE)
- Icon: The Kaltura icon can be downloaded from here.
- 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 - 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.
- Label: Kaltura Embed
- Handle: KalturaBSE
- Availability: Yes
- Type: “Course content tool”
Allow “Deep Linking content tool”. - Icon: The Kaltura icon can be downloaded from here.
- 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 - Click Submit.
- Create a placement with the following info:
- Label: In-Video Quiz
- Handle: KalturaIVQ
- Availability: Yes
- Type: “Course content tool”
Allow “Deep Linking content tool”. - Icon: The Kaltura icon can be downloaded from here.
- 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 - 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.
