pearson custom integration admin...

©2015 Blackboard Inc. Proprietary and Confidential

Pearson Custom Integration B2 Administrator Guide

Blackboard Learn Pearson Direct LTI Administrator Guide


Publication Date: July 2015

WORLDWIDEHEADQUARTERS� INTERNATIONALHEADQUARTERS�

BLACKBOARDINC.� BLACKBOARDINTERNATIONALB.V.�

650 Massachusetts Avenue N.W.

Sixth Floor

Washington, DC 20001‐3796

Paleisstraat 1‐5

1012 RB Amsterdam

The Netherlands

800‐424‐9299 toll free US & Canada

+1‐202‐463‐4860 telephone +31 (0) 20 788 2450 (NL) telephone

+1‐202‐463‐4863 facsimile +31 (0) 20 788 2451 (NL) facsimile

www.blackboard.com www.blackboard.com

Blackboard, the Blackboard logo, Blackboard Academic Suite, Blackboard Learning System,

Blackboard Learning System ML, Blackboard Community System, Blackboard Transaction System,

Building Blocks, and Bringing Education Online are either registered trademarks or trademarks of

Blackboard Inc. in the United States and/or other countries. Microsoft and Windows are

registered trademarks of Microsoft Corporation in the United States and/or other countries. Java

is a registered trademark of Sun Microsystems, Inc. in the United States and/or other countries.

Macromedia, Authorware and Shockwave are either registered trademarks or trademarks of

Macromedia, Inc. in the United States and/or other countries. Real Player and Real Audio Movie

are trademarks of RealNetworks in the United States and/or other countries. Adobe and Acrobat

Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in the

United States and/or other countries. Macintosh and QuickTime are registered trademarks of

Apple Computer, Inc. in the United States and/or other countries. WebEQ is a trademark of Design

Science, Inc. in the United States and/or other countries. JSpell is a trademark of The Solution Café

in the United States and/or other countries. Other product and company names mentioned herein

may be the trademarks of their respective owners. U.S. Patent No. 6,988,138. Patents pending.

No part of the contents of this manual may be reproduced or transmitted in any form or by any

means without the written permission of the publisher, Blackboard Inc.



TableofContents

1.0 About Pearson Custom Integration B2 .......................................................................... 4

2.0 Configuring the Pearson Custom Integration Building Block ............................................... 4

2.1 Configuring and Registering Pearson Custom Integration B2 .................................................. 4

2.2 Configure Tool Providers ....................................................................................................... 6

2.3 Configure Pearson Custom Integration Settings ............................................................................ 7

3.0 LTI Tool Links .................................................................................................................... 12

3.1 CREATING LTI Tool Links ............................................................................................................. 12

3.2 Launching LTI Links .................................................................................................................... 14

Instructor and Student Access ................................................................................................ 16

1.0 AboutPearsonCustomIntegrationB2The Pearson Custom Integration Building Block gives instructors the ability to launch LTI links to

multiple tool launch endpoints within Pearson from within a standard Blackboard content item.

Administrators will have the ability to configure the different tool providers/tool launch end

points. Instructors will author links using the HTML functionality of the standard Blackboard

VTBE editor. By including a javascript <script> block in the VTBE editor, the instructor may

author links. These links can then be made available to instructors and students within the

course.

Instructors will also have the ability to manage Pearson Grades from a Blackboard Course Tool,

and to refresh grades into the Blackboard Grade Center.

2.0ConfiguringthePearsonCustomIntegrationBuildingBlockThe Pearson Custom Integration Building Block must be installed and enabled for use in courses.

Download and install the Building Block using the same process for other Building Blocks.

2.1 ConfiguringandRegisteringPearsonCustomIntegrationB2

Follow these steps to configure and register the Pearson Custom Integration Building Block.

Make the Building Block Available:

1. From the Administrator Panel, click Building Blocks under Building Blocks.

2. Click Installed Tools.



3. On the Installed Tools page, click Upload Building Blocks and click Submit.

4. Wait for the file to be uploaded.

5. On the subsequent Install Building blocks and Make Building Block available page, click

Approve.

The Track Progress of Building Block Installation page indicates when the install is complete and

the building block is available.



2.2 ConfigureToolProviders

1. In Blackboard Learn 9.1 Service Pack 8 and above, click the arrow to the right of the building block name and

click Settings.

2. On the Tool List page, click New Tool.

3. On the New Tool page, enter the Vendor Code, Product Code, Client Key, Shared Secret, Student first cross

over strategy provided by Pearson and click Next.



4. On the New Resource page, enter the Resource Type and Resource URL provided by Pearson. Also add any

parameters needed using the Add Parameter button. Click Submit to register the tool provider with the B2.

5. Repeat steps 1‐4 for any additional tool providers.

2.3ConfigurePearsonCustomIntegrationSettings

1. In Blackboard Learn 9.1 Service Pack 8 and above, select the Settings option available in the contextual

menu next to the Pearson Custom Integration Building Block Name.

2. On the Pearson Custom Integration Settings page, click Grade Synchronization Configuration. The Grade

Synchronization Configuration page displays.



3. Select Click here to obtain a consumer key and shared secret for this installation.

4. The Pearson Institution Setup Request page opens in a new browser window/tab.



5. Enter the requested information to obtain a consumer key and secret.

6. Return to the Grade Synchronization Configuration page.

7. Enter the Consumer key and Consumer Shared secret information.



8. Under Local System Information, enter values for your service as follows:

Installation Type: Identifies the type of installation for this instance of Blackboard Learn as Production,

Staging, or Test. The Installation Type defaults to Production. However, it is important that you select the

appropriate Installation Type so that your Blackboard support teams can accurately identify your Blackboard

instance and provide the correct level of support.

9. Under Grade Integration, select the frequency with which Pearson Direct LIT grades should be updated into

the Blackboard Grade Center.

Grade Integration Status: Displays a timestamp representing the last date/time the Pearson

Grade Service was checked. Click Run Test to ping the Pearson Grade Service to validate

connectivity. (The Grade Integration Status pertains to the results of the “ping” service which

tells us whether or not the grades URL/key/secret are correctly configured.)

Grade Update Frequency: Select the frequency (in minutes) for the Automated Grade

Synchronization task to run. The available frequency values are 60, 90, 120 and 240 minutes.

Select Never to disable the automated task. Please note that instructors will still be able to

update their grades via the Pearson’s Custom Integration Tools page.

Last Checked: Displays a timestamp representing the last date/time the grade synchronization

looked for updates from Pearson.

Last Updated: Displays a timestamp representing the last date/time the grade synchronization

successfully completed.

Grade Integration: Click the Run Now button to manually trigger the grade synchronization task.



NOTE: When grade sync is initiated at the institution level for the first time, all applicable courses

and users are updated. Subsequent grade sync requests at the institution level check for updates

since the last time the grades were synced and only transfers grades that have changed.

A user with a username of pearson_grade_synch is created when the building block is

installed or updated.

o This user has an Institution Role of Guest and System Role of None. The

password is an encrypted hash of the timestamp when the user is created.

o When the Building Block is uninstalled, the user is removed from the system. If

the administrator deletes this user, it will NOT be recreated on subsequent

installs. If the user is removed by the building block, it WILL be recreated on

subsequent installs.

o If the pearson_grade_synch user is not found, the institution‐level grade synch

will try to load an instructor for the course and that instructor’s name will then

show up in the Grade History. (See below for user details).

o If the pearson_grade_synch user is accidentally deleted, the admin may create

a new user in the SYSTEM DSK with username = "pearson_grade_synch", first

name = "Pearson" and last name = "Grade Synch". Institution Role should be

set to "Guest" and System Role to "None”. The Grades sync process will run

asynchronously from within the context of a course.

10. Select Submit

If you receive a Configuration saved successfully success message on the Building Blocks page, the

Building Block was installed and configured successfully. The Registration Status will change to OK in the

Pearson’s Custom Integration Building Block Settings page.

If you receive an Invalid Configuration error, look at the Message field in the Registration Status section

for details. If the registration still fails after making the appropriate changes based on the error message,

open a ticket on Behind the Blackboard at https://blackboard.secure.force.com/login.



3.0LTIToolLinksLTI Links can be deployed by instructors within a Blackboard course using standard links from the Build

Content menu.

3.1CREATINGLTIToolLinksFollow these steps to create LTI Tool links in a Blackboard course.

1. Within any content area of a Blackboard course, click Build Content and then Item.

2. Enter the name of the LTI link into the Name field and any other relevant information about the

content item.

3. In the Text field, enable the HTML mode via the VTBE editor by clicking the icon.

4. In the VTBE editor, enter the javascript below:

<script type="text/javascript" defer> function lti_launch(data, target) { var form = document.createElement("form"); document.body.appendChild(form); form.action = "../../pso-lti-BBLEARN/app/launch#" + Math.random(); form.method = "post"; if (target) { form.target = target; } for (key in data) { var input = document.createElement("input"); input.type = "hidden"; input.name = key; input.value = data[key]; form.appendChild(input); } form.submit(); } </script> Instructor links: Access the <a href="javascript:lti_launch({'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'announcementmanager'},%20'_blank')">Announcement Manager</a> Access the <a href="javascript:lti_launch({'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'classgrades'},'_blank')">Gradebook</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'coursesettings'})">Settings and Group Admin</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'assignmentmanager'})">Homework and Test Manager</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'studyplanmanager'})">Study Plan Manager</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'coursesettings'})">Course Settings</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'homepagesettings'})">Home Page Settings</a> Student links: Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'mmlannouncements'})">MML Announcements</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'assignedhomework'})">Homework</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'assignedtests'})">Take a Test</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'doassignments'})">Homework and Tests</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'gradebook'})">Results</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'studyplan'})">Study Plan</a> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'exercises'})">Tracked Tutorials</a>

Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'calendar'})">Calendar</a> Change this text as desired to show <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':Kaplan201A','targetId':'gradebook'},%u2019mode%u2019:%u2019unitId%u2019:%u20191%u2019})">Results</a> 

5. In the VTBE editor, enter the scripted link using the anchor tag <a>. The href will need to call the

javascript function lti_launch with the following parameters:

handler_urn: the handler specified for the tool provider in the configuration. This value is in the

format <vendor code>/<product code>/<resource type>.

book: the book title in the Pearson system (provided by Pearson).

targetId: the target area of the Pearson system for the launch.

A sample scripted link is as follows:

<a href="javascript:lti_launch( {'handler_urn':'pearson/tpi/mml_xl', 'book':'Kaplan201A', 'targetId':'announcementmanager'}, _blank' )">

6. Click Submit to create the content item.

3.2LaunchingLTILinksFollow these steps to launch an LTI link in a Blackboard course.

1. As an instructor or student, log in to a Blackboard course and navigate to the course content area

where an LTI link has been deployed, as in step 3.1 Creating LTI Tool Links.

2. Click on the LTI link within the content item. This will launch users outside Blackboard to the

requested content.



NOTE: Users may be asked to accept Pearson’s End User License Agreement when crossing over to the

Pearson site.



InstructorandStudentAccessInstructors and students will have access to Pearson custom integration resources from within the Tools area of their courses. Instructors will now have the ability to automatically sync grades for their Pearson gradable content with the Blackboard grade center. Additional configuration options will be provided to specify if the gradable items should be included in the Blackboard grade center calculations etc. The grades will be refreshed periodically via an automated job, the frequency of which can be set via the Pearson custom integration building block’s settings page. Alternatively, instructors can also choose to refresh the grades on‐demand via the Pearson custom integration Tools area.

Students can view the Pearson grade information in Blackboard from the My Grades view in the tools page.

pearson custom integration admin...

Documents