RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide

Transcription

1 INTEGRATION GUIDE Software 6.5 September Rev A RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide

2 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 Copyright 2013, Polycom, Inc. All rights reserved. No part of this document may be reproduced, translated into another language or format, or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Polycom, Inc America Center Drive San Jose, CA USA Trademarks Polycom, the Polycom logo and the names and marks associated with Polycom products are trademarks and/or service marks of Polycom, Inc. and are registered and/or common law marks in the United States and various other countries. All other trademarks are property of their respective owners. No portion hereof may be reproduced or transmitted in any form or by any means, for any purpose other than the recipient's personal use, without the express written permission of Polycom. End User License Agreement By installing, copying, or otherwise using this product, you acknowledge that you have read, understand and agree to be bound by the terms and conditions of the End User License Agreement for this product. Patent Information The accompanying product may be protected by one or more U.S. and foreign patents and/or pending patent applications held by Polycom, Inc. Open Source Software Used in this Product This product may contain open source software. You may receive the open source software from Polycom up to three (3) years after the distribution date of the applicable product or software at a charge not greater than the cost to Polycom of shipping or distributing the software to you. To receive software information, as well as the open source software code used in this product, contact Polycom by at OpenSourceVideo@polycom.com. Disclaimer While Polycom uses reasonable efforts to include accurate and up-to-date information in this document, Polycom makes no warranties or representations as to its accuracy. Polycom assumes no liability or responsibility for any typographical or other errors or omissions in the content of this document. Limitation of Liability Polycom and/or its respective suppliers make no representations about the suitability of the information contained in this document for any purpose. Information is provided as is without warranty of any kind and is subject to change without notice. The entire risk arising out of its use remains with the recipient. In no event shall Polycom and/or its respective suppliers be liable for any direct, consequential, incidental, special, punitive or other damages whatsoever (including without limitation, damages for loss of business profits, business interruption, or loss of business information), even if Polycom has been advised of the possibility of such damages. Customer Feedback We are striving to improve our documentation quality and we appreciate your feedback. your opinions and comments to DocumentationFeedback@polycom.com. Visit the Polycom Support Center for End User License Agreements, software downloads, product documents, product licenses, troubleshooting tips, service requests, and more.

3 Contents Conventions Used in this Guide... 1 Information Elements...1 Typographic Conventions...2 What s in This Guide?... 3 Before You Begin... 1 Required Software... 1 About the RealPresence Media Manager Software Integration with the Blackboard Learn 9.1 Platform... 2 Getting Help and Support Resources... 3 Enabling the Blackboard Learn Integration Module License in RealPresence Media Manager... 5 Enabling Single Sign-on (SSO) and Lightweight Directory Access Protocol (LDAP)... 6 Configuring RealPresence Media Manager Software for Upcoming Events on the Blackboard Learn Platform... 8 Configuring the Content Creation Profile...8 Assigning a De stination Category Configuring the Blackboard Learn Software for Upcoming Events Setting the Proxy Tool as Available in the Blackboard Learn Software Scheduling an Upcoming Event Using the RealPresence Media Manager Admin Tool Configuring RealPresence Media Manager Software for Uploading Content Using the Blackboard Learn Platform Configuring the Content Creation Profile

4 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 Enabling OAuth Validation for Blackboard Bypa ssing User Preferences: Locale, Time Zone and Language Creating Categories for Course s Configuring Blackboard Learn Software for Uploading Content to RealPresence Media Manager Portals Registering a Proxy Tool in Blackboard Learn Software Registering RealPresence Media Manager Software as a Tool Provider Creating Links to the Media Manager Upload Page Uploading Content Using the Blackboard Learn Platform Uploading a File Adding a Link to External Content Publishing Existing Content Enabling Distribution Transaction Coordinator in SQL Server Express Optional Configuration Files Polycom and Partner Resources The Polycom Community

5 About This Guide This integration guide uses a number of conventions that help you to understand information and perform tasks. Conventions Used in this Guide This user guide contains terms, graphical elements, and a few typographic conventions. Familiarizing yourself with these terms, elements, and conventions will help you perform administrative tasks. Information Elements The following icons are used to alert you to various types of important information in this guide: Icons Used in this Guide Name Icon Description Note Administrator Tip Caution Warning Web Info Timesaver Power Tip Troubleshooting The Note icon highlights information of interest or important information needed to be successful in accomplishing a procedure or to understand a concept. The Administrator Tip icon highlights techniques, shortcuts, or productivity related tips. The Caution icon highlights information you need to know to avoid a hazard that could potentially impact device performance, application functionality, or successful feature configuration. The Warning icon highlights an action you must perform (or avoid) to prevent issues that may cause you to lose information or your configuration setup, and/or affect network performance. The Web Info icon highlights supplementary information available online such as documents or downloads on support.polycom.com or other locations. The Timesaver icon highlights a faster or alternative method for accomplishing a method or operation. The Power Tip icon faster, alternative procedures for advanced administrators already familiar with the techniques being discussed. The Troubleshooting icon highlights information that may help you solve a relevant problem or to refer you to other relevant troubleshooting resources. 1

6 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 Name Icon Description Settings The Settings icon highlights settings you may need to choose for a specific behavior, to enable a specific feature, or to access customization options. Typographic Conventions A few typographic conventions, listed next, are used in this guide to distinguish types of in-text information. Typographic Conventions Convention Bold Italics Underlined Blue Blue Text Fixed-width-font Description Highlights interface items such as menus, soft keys, file names, and directories. Also used to represent menu selections and text entry to the phone. Used to emphasize text, to show example values or inputs, and to show titles of reference documents available from the Polycom Support Web site and other reference sites. Used for URL links to external Web pages or documents. If you click on text in this style, you will be linked to an external document or Web page. Used for cross references to other sections within this document. If you click on text in this style, you will be taken to another part of this document. Used for code fragments and parameter names. 2

7 What s in This Guide? This guide provides you with the administrator-level information and steps you need to integrate Polycom RealPresence Media Manager v6.5 software with the Blackboard Learn 9.1 Service Pack 10 learning management system. This guide will help you understand the integration s two key tasks: Configuring RealPresence Media Manager software to deliver content, either recorded or live, to Blackboard Learn course modules from RealPresence Media Manager software according to scheduled upcoming events Configuring RealPresence Media Manager software and the Blackboard Learn platform to enable Blackboard Learn system administrators, instructors, and students to upload content into RealPresence Media Manager software from within the Blackboard Learn platform and automatically publish the resulting RealPresence Media Manager software s embedded player or content links on the corresponding Blackboard Learn course pages In this document, each of these key tasks is broken down into several smaller tasks, with procedures to guide you, step by step, to a working integration. Getting Started This is your starting point for integrating RealPresence Media Manager software with the Blackboard Learn 9.1 platform. This section provides an overview of the integration tasks, and a list of hardware and software pre-requirements. Preconfiguring RealPresence Media Manager for Integration with Blackboard Learn Before configuring settings specific to the integration with the Blackboard Learn 9.1 platform, you must meet some pre-configuration requirements in the RealPresence Media Manager software. Read this chapter to check that you have properly preconfigured the RealPresence Media Manager software, or to learn how to pre-configure RealPresence Media Manager software. Configuring RealPresence Media Manager and Blackboard Learn for Upcoming Events Read this chapter to learn how to configure RealPresence Media Manager software to schedule content delivery to the Blackboard Learn 9.1 course pages. Configuring RealPresence Media Manager and Blackboard Learn for Uploading Content Read this chapter to learn how to configure RealPresence Media Manager software and the Blackboard Learn 9.1 platform so authorized users can upload content from their browsers into the RealPresence Media Manager software. The RealPresence Media Manager embedded player or content links will be automatically published on the corresponding Blackboard Learn course pages. Reference Information You can find additional configuration options, including a complete list of the RealPresence Media Manager API methods available, and more, in this chapter. Getting Help If you need help solving an issue, or simply want more information about this integration, visit the Getting Help chapter. Here you will find links to support sites and community forums. Consider joining the community forums to learn more, and share your experiences configuring RealPresence Media Manager 3

8 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 software with the Blackboard Learn 9.1 platform and working with the Learning Tool Interoperability (LTI) standards, with your peers. Known Issues This chapter contains any known issues and workarounds. 4

9 1: Getting Started Polycom RealPresence Media Manager is an industry-leading, enterprise-class platform for managing and delivering video and multimedia content. It is used by major universities and other education institutions worldwide. Blackboard Learn 9.1 platform is a learning management system used by education institutions worldwide. By integrating these two powerful solutions at the API-level, institutions can combine the video content management power and flexibility of RealPresence Media Manager software with the learning management environment of the Blackboard Learn 9.1 platform to create an integrated education solution for instructors and students. With this integration, institutions using the Blackboard Learn 9.1 platform can schedule delivery of video and multimedia content to their Blackboard Learn environments from their RealPresence Media Manager software and associated content servers. This integration also enables authorized users to upload multimedia content into the RealPresence Media Manager software solution directly from a Blackboard Learn browser session for use on a Blackboard Learn course page. Using either configuration, this integration streamlines the flow of content from source to RealPresence Media Manager software for comprehensive management and distribution, to the Blackboard Learn course catalogs for instructors and students to view. The integration of RealPresence Media Manager version 6.5 software and the Blackboard Learn 9.1 platform leverages the new RealPresence API in RealPresence Media Manager software version 6.5 and uses the IMS Global Learning Consortium s Learning Tool Interoperability (LTI) standards. This guide will show you how to integrate RealPresence Media Manager software and the Blackboard Learn 9.1 platform to work together for content delivery. Before You Begin This integration guide is for system administrators with administrative knowledge and administrative access to RealPresence Media Manager software, the Blackboard Learn 9.1 platform and associated content servers. Additionally, some knowledge of the RealPresence Media Manager API and the LTI specification is beneficial, but not required. To complete the steps in this guide, you need RealPresence Media Manager version (or later) software with the Blackboard Learn Integration Module license, and the Blackboard Learn 9.1 Service Pack 10 software installed and configured for normal use. You need administrator level access to RealPresence Media Manager software and the Blackboard Learn 9.1 platform. Required Software You need the following software installed to configure and use the RealPresence Media Manager software integration with the Blackboard Learn 9.1 platform: RealPresence Media Manager software v or v6.5 installed on a dedicated server or servers 1

10 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 Microsoft Distribution Transaction Coordinator (DTC) services enabled on the server where Microsoft SQL Server or SQL Server Express is installed. For more information about enabling DTC, see Enabling Distribution Transaction Coordinator in SQL Server Express. RealPresence Media Manager software must be fully operational before starting the integration. Blackboard Learn 9.1 Manager must be fully operational before starting the integration. The Blackboard Learn 9.1 software must be fully operational in stand-alone mode before proceeding with the integration. RealPresence Media Manager software must be licensed for the Blackboard Learn Integration and LTI feature option. In RealPresence Media Manager software, the Single Sign-on feature must be enabled and fully operational. Note: Interoperability Between Versions Polycom has tested the integration of RealPresence Media Manager software versions 6.1 and 6.5 with Blackboard Learn 9.1 SP10 software. Consult with Polycom and Blackboard before upgrading either system after implementation of the integration to avoid potential incompatibilities. Content sources compatible with RealPresence Media Manager software, include but are not limited to: Polycom RealPresence Capture Station 6.0 (or later), or Capture Station Pro 6.5 (or later) appliances Polycom RealPresence Media Editor version 6.0 (or later) software Polycom RSS 4000 version 8.5 or RealPresence Capture Server appliances Video files in RealPresence Media Manager software-compatible formats, including, but not limited to, Windows Media, and H.264/MPEG-4. Admin Tip: Supported Operating Systems and Browsers Administration of RealPresence Media Manager software requires installation of the Admin Tool on a computer running Microsoft Windows 7 or Windows 8. About the RealPresence Media Manager Software Integration with the Blackboard Learn 9.1 Platform The RealPresence Media Manager 6.5 software integration with the Blackboard Learn 9.1 platform enables instructors to complete two core tasks: 2

11 Authorized administrators can schedule publish content and schedule events from RealPresence Media Manager software to selected Blackboard Learn course catalogs. For example, a RealPresence Media Manager software administrator, or advanced user, can schedule an upcoming live event, such as a webcast, to appear on a Blackboard Learn course page. When the scheduled upcoming event becomes available, students can access the content by clicking a link in the associated course page in the Blackboard Learn 9.1 platform. Authorized users can upload content from a Blackboard Learn browser session into a RealPresence Media Manager software portal for use in selected Blackboard Learn course catalogs. For example, instructors, or students with permission, can log in to the Blackboard Learn 9.1 platform on their Windows PC or Mac using their Blackboard user name and password, and upload a video they recorded on their mobile device. In the background, the video is uploaded to the RealPresence Media Manager software from the Blackboard Learn 9.1 platform. The RealPresence Media Manager software ingests and transcodes the content, and then publishes a link to play the content from the selected Blackboard Learn course catalog. Settings: LDAP and Single Sign-on You must configure Single Sign-on in both the RealPresence Media Manager software and the Blackboard Learn software to enable instructors and students to log in using their Blackboard Learn user names and passwords. If you have configured LDAP in the Blackboard Learn software, you must configure the corresponding LDAP settings in the RealPresence Media Manager software to ensure that student and instructor logins are recognized. Getting Help and Support Resources This integration guide includes a Getting Help section where you can find links to Polycom product and support sites and partner sites. You can also find information about The Polycom Community, which provides access to discussion forums you can use to discuss hardware, software, and partner solution topics with your colleagues. To register with the Polycom Community, you will need to create a Polycom online account. The Polycom Community includes access to Polycom support personnel, as well as user-generated hardware, software, and partner solutions topics. You can view top blog posts and participate in threads on any number of recent topics. For help with the Blackboard Learn 9.1 platform, visit Support for Blackboard Learn. To learn more about LTI, visit IMS Global Learning Consortium s website. 3

12

13 2: Preconfiguring RealPresence Media Manager for Integration with the Blackboard Learn Platform This chapter shows you how to preconfigure RealPresence Media Manager software to integrate with the Blackboard Learn 9.1 platform. After the RealPresence Media Manager software is running in stand-alone mode, verify that Single Sign-on (SSO) is enabled. You need the following software installed to configure and use the RealPresence Media Manager software integration with the Blackboard Learn 9.1 platform: RealPresence Media Manager version (or later) software installed on a dedicated server or servers Microsoft Distribution Transaction Coordinator (DTC) services enabled on the server where Microsoft SQL Server Express is installed. For more information about enabling DTC, see Enabling Distribution Transaction Coordinator in SQL Server Express. RealPresence Media Manager software fully operational in stand-alone mode before proceeding with the integration. Blackboard Learn Integration Module/LTI feature option enabled Single Sign-on feature option enabled Enabling the Blackboard Learn Integration Module License in RealPresence Media Manager You need to enable the Blackboard Learn Integration Module license. To enable the Blackboard Learn Integration Module license: 1 In the Portal Administration tab, right-click the Media Manager Root and select Properties. 2 In the Manage License tab, select the Blackboard/LTI checkbox. 5

14 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 Enabling Single Sign-on (SSO) and Lightweight Directory Access Protocol (LDAP) To allow students to access RealPresence Media Manager content from authenticated Blackboard Learn browser sessions, you need to enable Single Sign-on (SSO) for the RealPresence Media Manager portal. For more information about configuring SSO, see the Polycom RealPresence Media Manager Software Edition Administrators Guide. To enable Single Sign-on Authentication in RealPresence Media Manager software: 1 Launch the RealPresence Media Manager Admin Tool and log in. 2 In the Portal Administration panel, right-click the portal you are publishing content from and click Properties. 3 In the Authentication Profiles tab, in the Authentication Types section, select Forms. 4 In the Single Sign-on section, select the Use Single Sign-on check box. 5 Click the New button to create a new single sign-on field. 6 Enter UserId in the Field Name field. 7 In the Field Type menu, select Query String. 8 In the Action menu, select Populate Field. 9 In the Store Value field, select Username. This maps the UserId to the Username and enables users to access the RealPresence Media Manager portal content from Blackboard Learn course pages using SSO authentication. 6

15 10 Click the Save button. Admin Tip: Enabling Single Sign-on Before enabling SSO in the portal s Authentication Profiles, you must ensure that the SSO option is enabled in the Manage License panel of the Media Manager Root. To Enable LDAP Authentication in RealPresence Media Manager software: 1 In the Portal Administration panel, right-click the portal you are publishing content from and click Properties. 2 Click the Authentication Profiles tab, and then click Default Forms Authentication Profile. You can also create a new Authentication Profile by clicking the New Authentication Profile button. 3 In the Authentication Types section, select LDAP. 4 In the Type Details section, enable Integrated Windows Authentication or test your LDAP setup. Click the Save button. 7

16 3: Configuring RealPresence Media Manager Software and the Blackboard Learn 9.1 Platform for Upcoming Events This chapter shows you how to configure RealPresence Media Manager software and the Blackboard Learn 9.1 platform to publish content as scheduled upcoming events. This configuration enables instructors to publish content to Blackboard Learn course pages from within the RealPresence Media Manager software as scheduled upcoming events. Students can access the content from within the Blackboard Learn platform from the content start date until the expiration date. Configuring RealPresence Media Manager Software for Upcoming Events on the Blackboard Learn Platform To publish upcoming events to Blackboard Learn course pages from the RealPresence Media Manager Admin Tool in you must complete the following configuration steps in the RealPresence Media Manager software. Once configured, you will be able to schedule upcoming events in the RealPresence Media Manager Admin Tool and students will be able to view these events from within the Blackboard Learn platform. Admin Tip: Supported Operating Systems and Browsers Administration of RealPresence Media Manager software requires installation of the Admin Tool on a computer running Windows 7 or Windows 8. Configuring the Content Creation Profile The Content Creation Profile (CCP) you use links all of the profiles for servers, content locations, distribution points and content sources that the RealPresence Media Manager software uses to ingest, distribute and display content on RealPresence Media Manager portals and Blackboard Learn course pages. You need to configure the Blackboard Learn software settings in a RealPresence Media Manager Content Creation Profile. You can configure the settings for the default CCP, update an existing CCP, or create a new CCP. To configure the Content Creation Profile: 1 Launch the RealPresence Media Manager Admin Tool and log in. 8

17 2 In the Network Resources panel, right-click the Default Content Creation Profile and select Properties. Power Tip: Working with Content Creation Profiles You can also select an Existing Content Creation Profile, or create a New Content Creation Profile. For more information about working with Content Creation Profiles, see the Polycom RealPresence Media Manager Software Edition Administrators Guide. 3 On the Content Creation Profile tab, click the Blackboard tab and select the Enable Blackboard check box. Admin Tip: Enabling the Blackboard Tab in the Content Creation Profile You must have a Blackboard Learn Integration Module license key activated in the RealPresence Media Manager software for the Blackboard tab and Enable Blackboard check box to be available. 4 Enter the information in the following fields: Blackboard Host Url Proxy Vendor For example, enter Polycom. For example, enter Proxy Program Id For example, enter polycom_realpresence_media_manager. Proxy password Enter the password used in when the RealPresence Media Manager software was registered as a proxy tool in the Blackboard Learn software. Expected Life The default value is 0. 5 Clear the Use Service Account checkbox. 9

18 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide Click the Register Proxy Tool button. 7 Click the Test Connection button to run a test once the proxy tool has been registered. You will receive one of two responses: If the connection test confirms the RealPresence Media Manager software and Blackboard Learn software can communicate, the message Successful displays at the top of the page. If the connection test fails, an error message, such as Invalid URL or Invalid user name, displays at the top of the page. 8 Click the Save button. Click to continue configuring the RealPresence Media Manager software for Uploading Content. Assigning a Destination Category Next you must assign a destination category in the Content Creation Profile. To assign a destination category: 1 On the Content Creation Profile tab, click the Destination Categories tab. 2 Select the destination category you wish to publish upcoming events in, or create a new destination category. 3 Select the Set Content Online checkbox and add details in the Scan Rules section as needed. Web Info: Assigning Destination Categories For more information about assigning destination categories, see the Polycom RealPresence Media Manager Software Edition Administrators Guide. 10

19 Configuring the Blackboard Learn Software for Upcoming Events Log in to the Blackboard Learn platform as an administrator to configure it to work with the RealPresence Media Manager software. Follow these steps to configure the Blackboard Learn platform to display content that has been scheduled as upcoming events from the RealPresence Media Manager software portal or portals. Setting the Proxy Tool as Available in the Blackboard Learn Software For the Blackboard Learn platform to communicate with the RealPresence Media Manager software, you need to set the proxy tool, RealPresence Media Manager software, as available in the Blackboard Learn software. To register the RealPresence Media Manager software as a proxy tool: 1 Log in to the Blackboard Learn server as an administrator. 2 Click the System Admin tab. 3 In the Administrator Panel, in the Building Blocks section, click Building Blocks. 4 In the Building Blocks Panel, click Proxy Tools to open the Proxy Tools page. 11

20 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide Click the MediaManager expand button and click Edit. 6 On the Edit Proxy Tool page, in the Availability section, select Yes. 7 Click Submit. Click to continue configuring the Blackboard Learn platform for uploading content. 12

21 Scheduling an Upcoming Event Using the RealPresence Media Manager Admin Tool You can use the RealPresence Media Manager Admin Tool to schedule events to deliver content to the Blackboard Learn platform starting on a specific date and time, and ending on an expiration date. You can create upcoming events manually in the RealPresence Media Manager software Admin Tool, or using a RealPresence Capture Station or Capture Station Pro appliance. To schedule an event: 1 Launch the RealPresence Media Manager Admin Tool and log in. 2 In the Scheduling panel, select a date for the event on the calendar. 3 Double-click the desired time of day. 4 Select a Content Creation Profile with the Blackboard tab enabled. 5 Enter event notes in the Notes field. 6 In the Event Type field, select either Manual Upcoming Event or RealPresence Capture Station. Note: Supported Event Types The Blackboard Learn Integration module currently supports Manual Upcoming events and RealPresence Capture Station events only. 7 Enter the event details in the Title, Speaker(s) and Description fields. 13

22 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide Select a duration time for the event in the Duration section. 14

23 9 In the Blackboard tab, select the course you want to publish the content into, and select the checkbox beside the folder you want to publish the event link in. 10 Click the Save button. The RealPresence Media Manager software publishes a link to the Upcoming Event on the Blackboard Learn course page, in the folder you selected in step 8. When a student logs in to the Blackboard Learn platform, their Blackboard user name is passed into the RealPresence Media Manager software portal using SSO. When the student clicks the upcoming event link, the RealPresence Media Manager software s presentation window launches to display the upcoming event content. As a Blackboard Learn system administrator, you can manage the appearance and location of the RealPresence Media Manager software s upcoming event links displayed in the Blackboard Learn platform, by accessing the selected course folder on the course page. 15

24 4: Configuring RealPresence Media Manager Software and Blackboard Learn Software for Uploading Content This chapter shows you how to configure Blackboard Learn software for uploading and publishing content from the RealPresence Media Manager software s Admin Tool back to the Blackboard Learn platform. Timesaver: You Can Skip Some Configuration Steps If you are using the previously configured the Content Creation Profile (CCP), you can skip some of these steps. For example, if you have configured the Default CCP for Upcoming Events, and you want to continue configuring for Uploading Content, you don t need to configure the CCP again. Configuring RealPresence Media Manager Software for Uploading Content Using the Blackboard Learn Platform Before you can upload content to RealPresence Media Manager software from Blackboard Learn software, you need to complete the following RealPresence Media Manager software configuration steps. Configuring the Content Creation Profile You need to configure the Blackboard Learn software settings in the Content Creation Profile (CCP). You can configure the settings for the default CCP, an existing CCP, or create a new CCP. Click to learn how to configure the Content Creation Profile. Enabling OAuth Validation for Blackboard This integration uses Learning Tool Interoperability (LTI) standards for communication between RealPresence Media Manager software and the Blackboard Learn platform. The LTI specifications require Tool Providers to validate Tool Consumers using OAuth validation. In this case, the RealPresence Media Manager software is the Tool Provider and the Blackboard Learn software is the Tool Consumer. You need to enable OAuth Validation in the RealPresence Media Manager software to enable users to access the portal s upload page within the Blackboard Learn platform. 16

25 To enable OAuth validation: 1 In the Portal Administration panel, right-click the portal you want to upload content to and click Properties. 2 Click the Authentication Profiles tab. 3 Click the profile you are using. For example, click Default Authentication Profile. 4 In the Single Sign-on section, select the Use OAuth Validation check box. 5 Enter a Consumer Key and Consumer Secret. Admin Tip: Consumer Key and Consumer Secret Make a note of the Consumer Key and Consumer Secret. These will be used in the Blackboard Learn software as the Tool Provider Key and Shared Secret. 6 Click the Save button. 17

26 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 Bypassing User Preferences: Locale, Time Zone and Language RealPresence Media Manager portals automatically display the User Preferences page and ask users to configure Locale, Language and Time Zone each time they log in. When a user accesses the uploaded content on a Blackboard Learn course page, the RealPresence Media Manager portal will expect the same configuration each time. You can configure the RealPresence Media Manager software to bypass the portal user preferences and avoid prompting users to configure their preferences each time they log in. To bypass portal user preferences: 1 In the Portal Administration panel, right-click the portal you will be uploading content to and click Properties. 2 Click the Details tab. 3 In the User Preferences section, select the Bypass User Preferences in Portal check box. Creating Categories for Courses In order to upload content to a course on the upload page in the Blackboard Learn platform, you need to map the Blackboard Learn course name to a RealPresence Media Manager software category. It helps to create a new category for each course using the name of the course. For example, create a new category called Chemistry 101 for the Chemistry 101 course. To create a new category: 1 In the Media Manager Root, right-click the portal you want to upload content into and select New Category. 2 Name the new category to match the course in the Blackboard Learn software. 3 In the Details tab, in the User Upload Settings section, select the Enable User Upload checkbox. If the Enable User Upload checkbox is not visible, clear the Inherit From Parent checkbox to display it. 4 In the Content Creation Profile menu, select Default Content Creation Profile, or the content creation profile you are using. 18

27 5 Click the Save button. Configuring Blackboard Learn Software for Uploading Content to RealPresence Media Manager Portals After configuring the RealPresence Media Manager software, log in to the Blackboard Learn platform as an administrator to configure it to enable uploading content from Blackboard Learn software to RealPresence Media Manager portals. Follow these steps to configure Blackboard Learn for uploading content. Registering a Proxy Tool in Blackboard Learn Software For Blackboard Learn to communicate with RealPresence Media Manager software, you need to register the RealPresence Media Manager software as a proxy tool in the Blackboard Learn software. Click to learn how to register Media Manager as a proxy tool. Registering RealPresence Media Manager Software as a Tool Provider You need to register the RealPresence Media Manager software as a Tool Provider by configuring this setting in the Administrator Panel in the Blackboard Learn software. In the Learning Tools Interoperability (LTI) specification, a Tool Provider is a term used to describe an application such as RealPresence Media Manager software that provides content to another platform. A Tool Consumer is the term used to categorize a learning platform, such as the Blackboard Learn platform, that consumes content provided by another application. 19

28 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 To register the RealPresence Media Manager software as a Tool Provider, download and install a Blackboard Building Block element called Basic LTI. You can find the Basic LTI Building Block in the RealPresence Media Manager software install package. You need to install it in the Blackboard Learn platform. To download and install the Basic LTI Building Block: 1 Using Windows Explorer, browse to the compressed file bb-basiclti in the RealPresence Media Manager software install package and extract the BasicLTI war file. 2 Open the Blackboard Learn software and log in as an administrator. 3 In the Administrator panel, in the Building Blocks section, click Building Blocks. 4 Click Installed Tools. 5 On the Installed Tools page, click Upload Building Blocks. 20

29 6 In the Install Building Block section, click the Browse button, browse to the BasicLTI war file that you downloaded and extracted, and then click the Submit button. 7 If successful, you will see the message, Success: Basic LTI tools installed. The Building Block is currently inactive. at the top of the page, and Basic LTI tools will appear in the available Building Blocks list. 8 Select the Basic LTI tool check box and then select Set Available from the list in the options menu. 21

30 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide On the Make Building Block Available page, review the Privileges and click the Approve button. To register the RealPresence Media Manager software as a Tool Provider: 1 On the Installed Tools page, select the Basic LTI tool check box, select Settings from the list in the options menu. 22

31 2 Click the System Settings tab. 3 On the System Settings page, enter a name for the institution in the Name field and a description of the institution in the Description field. Click the Submit button. 4 On the Basic LTI tools page, click the Register New Tool button. 5 On the Registration Settings page, in the Name section, enter a name for the tool provider in the Name field. For example, enter RealPresence Media Manager. 23

32 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide In the Connection Details section, enter a Launch URL in the Consumer key and the Shared secret fields. The shared secret is used in the RealPresence Media Manager software to authenticate requests from the Blackboard Learn platform. Click the Submit button. The URL format for the Launch URL for upload page links is: Manager Portal Domain]/account/loginoauth?IsSingleSignOn =true&returnurl= Manager Portal Domain]/home/sharepoint/0 7 On the Installed Tools page, select the Basic LTI tools check box and then select Settings in the options menu. 8 In the Default Settings menu, select Data Settings. 9 On the Default Data Settings page, complete the following fields: 24

33 a In the Context Data section, select the Context ID checkbox. In the Value to use for context ID field, select Database Key. Select the Context Source ID and Context Title checkboxes. b In the Personal Data section, in the User ID field, select Required by tool. In the Value to use for User ID field, select Username. Select the Sourcedid checkbox. In the User name field, select Required by tool and in the in the field, select Required by tool. Select the User Roles checkbox. Do not select No check for User Avatar or Role Mappings. Click the Submit button. Admin Tip: Sharing the Consumer Key and Shared Secret The Consumer key and Shared secret are shared with the RealPresence Media Manager software. If the RealPresence Media Manager software is configured before the Blackboard Learn software, you need to acquire them from the RealPresence Media Manager software administrator. 25

34 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 Creating Links to the Media Manager Upload Page After registering the RealPresence Media Manager software as a Tool Provider, create a link to the RealPresence Media Manager upload page. You can use these upload pages to upload content into the RealPresence Media Manager software and make these links to content available to students. To create a link to the RealPresence Media Manager upload page: 1 On the Courses tab, select the course page you want to create an upload link for. 2 In the course panel, click Content. 3 On the Content page, in the Tools menu, click Basic LTI Tool. 4 On the Add link to Basic LTI Tool page, in the Select Tool section, click the By Name tab. 5 In the Name of existing tool field, select Polycom. 6 Click Submit. 26

35 7 On the Configure Tool page, in the Options section, select No for Permit users to view this content. Click the Submit button. The Blackboard Learn software creates the upload link that you can use to upload and publish content in the folder you specified on the Blackboard Learn course page. For example, the Blackboard Learn software creates the link in the Content folder on the Chemistry 101 course page. Uploading Content Using the Blackboard Learn Platform After configuration, you can publish the RealPresence Media Manager software content to Blackboard Learn course pages using a browser by: Uploading a file to the RealPresence Media Manager software from the Blackboard Learn Platform Adding a link to content hosted on an external site Publishing existing, uncategorized content in the Blackboard Learn Platform 27

36 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 Uploading a File You can upload content from the Blackboard Learn platform to the RealPresence Media Manager software s portals and publish a link to this content on the course page in the Blackboard Learn platform. When students click the links on the course pages in the Blackboard platform, the content, which is now managed by the RealPresence Media Manager software, launches. To upload a file: 1 On the Courses tab, select the course you want to upload content for. 2 In the course panel, click Content. 3 On the Content page, click the upload link you created in Creating Links to the RealPresence Media Manager Upload Page. For example, click Polycom. 4 Click the Upload a file button. 5 Browse to the file and click Open. 6 On the Upload page, complete the applicable fields, including: Category Title Speaker Date Start Time and Duration Sets the date and time when the uploaded content will become available to students in the Blackboard Learn platform. Expiration Date Sets the date the content will expire and cease to be visible to students in the Blackboard Learn platform. 28

37 Additional options, such as Blackboard Expiration Date and Open new window in Blackboard, can be configured in the RealPresence Media Manager software web.config file. For more information about these options see Optional Configuration Files. 7 Click the Save Changes button. Once the content is uploaded, the RealPresence Media Manager software will publish a direct link URL for the uploaded content on the associated Blackboard Learn course page. Caution: Setting Content to Open in a New Window When setting uploaded content or externally linked content to open in a new window in the Blackboard Learn platform, not all content types will adhere to the setting. Content types that are not permitted by the Blackboard Learn software to open in a new window will open in the same window. 29

38 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide You can also click the My Uploads button to view a list of your uploaded content, make changes such as updating the title, or delete the content. Adding a Link to External Content If the content is hosted on an external site, you can add a link to it from the Upload page and the link will be published on the associated course page in the Blackboard Learn platform. To add a link to content: 1 On the Courses tab, select the course you want to upload content for. 2 In the course panel, click Content. 3 On the Content page, click the upload link you created in Creating Links to the RealPresence Media Manager Upload Page. For example, click 4 Click the Add a Link button. Polycom. 5 Enter the Title, URL and Description in the applicable fields. 6 Select the Open in New Window checkbox if desired. 7 Click the Save Changes button. 30

39 Caution: Setting Content to Open in a New Window When setting uploaded content or externally linked content to open in a new window in the Blackboard Learn platform, not all content types will adhere to the setting. Content types that are not permitted by the Blackboard Learn software to open in a new window will open in the same window. Publishing Existing Content You can publish existing, uncategorized content by associating it with course categories in the Blackboard Learn platform. To publish existing Content: 1 On the Courses tab, select the course you want to publish existing content to. 2 In the course panel, click Content. 3 On the Content page, click the upload link you created in Creating Links to the RealPresence Media Manager Upload Page. For example, click Polycom. 4 Click the Add existing content button. 5 Click the settings icon next to the content you want to create a link to. 6 Enter a category in the Category field. 7 Click the Save Changes button. The link to content will appear on the associated Blackboard course upload page. 31

40 5: Reference Information This chapter contains reference information such as the Microsoft SQL Server pre-configuration requirement for the RealPresence Media Manager software, and a list of advanced configuration options. Enabling Distribution Transaction Coordinator in SQL Server Express Before configuring either RealPresence Media Manager software or Blackboard Learn software, you must enable the Microsoft Distributed Transaction Coordinator (DTC) services on the server running SQL Server, used by the RealPresence Media Manager software. To enable DTC on the SQL Server: 1 In the Start menu, select Administrative Tools, and click Component Services. 2 In the Component Services dialog box, double-click the Computers folder and double-click My Computer. 3 Double-click the Distributed Transaction Coordinator folder and select Local DTC. 32

41 4 Right-click Local DTC and select Properties. 5 In the Local DTC property sheet, click the Security tab, and select the Network DTC Access checkbox. 6 Click Apply. Optional Configuration Files RealPresence Media Manager 6.5 software contains three additional configuration options to expand the functionality of the Blackboard Upload page. These are available in the RealPresence Media Manager software s Web.config file and are set to false by default. To enable these options, you need administrator permissions and remote desktop access to the Windows Server. Change the setting to true for each option you want to enable. 33

42 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 These options include: DisplayLibraryContentsOnUploadPage This option enables you to associate uncategorized content in RealPresence Media Manager software to a Blackboard Learn course page and publish it to that course page. ExternalAppExpiryDateOnUploadPage This option enables you to set the date when the uploaded content will cease to be available to students logged in to the Blackboard Learn platform. ExternalAppOpenInNewWindowOnUploadPage This option enables students to view content in a new window in the Blackboard Learn platform instead of the default which embeds the RealPresence Media Manager s player in the Blackboard Learn course page. For more information about the web.config files, see Configuring Settings Using the Portal Web.config Files in the Polycom RealPresence Media Manager Software Edition Administrators Guide. 34

43 6: Getting Help Polycom and Partner Resources For more information about configuring RealPresence Media Manager software, see the Polycom RealPresence Media Manager Administrators Guide. For more information about installing, configuring, and administering Polycom products, refer to Documents and Downloads at Polycom Support. To find all Polycom partner solutions, see Polycom Global Strategic Partner Solutions. For help with the Blackboard Learn platform, visit Support for Blackboard Learn. To learn more about Learning Tools Interoperability (LTI) specifications, visit IMS Global Learning Consortium s website. For more information about using the LTI specification for integrating with other platforms, visit the IMS Global developers website or visit IMS GLC Public Forums and Resources. The Polycom Community The Polycom Community gives you access to the latest developer and support information. Participate in discussion forums to share ideas and solve problems with your colleagues. To register with the Polycom Community, simply create a Polycom online account. When logged in, you can access Polycom support personnel and participate in developer and support forums to find the latest information on hardware, software, and partner solutions topics. Go directly to the Developer Community 35

44 RealPresence Media Manager Blackboard Learn 9.1 Learning Management System Integration Guide 6.5 7: Known Issues 1 At the time of publication of this guide, Blackboard does not support creating upload links from the Administrator panel. Create an upload link on each course page and provide each link to instructors. 36