pearson custom integration admin...
Post on 26-Mar-2020
28 Views
Preview:
TRANSCRIPT
©2015 Blackboard Inc. Proprietary and Confidential
Pearson Custom Integration B2 Administrator Guide
Blackboard Learn Pearson Direct LTI Administrator Guide Page 2
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 3
©2015 Blackboard Inc. Proprietary and Confidential
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
Blackboard Learn Pearson Direct LTI Administrator Guide Page 4
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 5
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 6
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 7
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 8
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 9
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 10
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 11
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 12
©2015 Blackboard Inc. Proprietary and Confidential
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 13
©2015 Blackboard Inc. Proprietary and Confidential
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> <b>Instructor links:</b><br /> Access the <a href="javascript:lti_launch({'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'announcementmanager'},%20'_blank')">Announcement Manager</a><br /> Access the <a href="javascript:lti_launch({'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'classgrades'},'_blank')">Gradebook</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'coursesettings'})">Settings and Group Admin</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'assignmentmanager'})">Homework and Test Manager</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'studyplanmanager'})">Study Plan Manager</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'coursesettings'})">Course Settings</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'homepagesettings'})">Home Page Settings</a><br /> <br /> <b>Student links:</b><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'mmlannouncements'})">MML Announcements</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'assignedhomework'})">Homework</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'assignedtests'})">Take a Test</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'doassignments'})">Homework and Tests</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'gradebook'})">Results</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'studyplan'})">Study Plan</a><br /> Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'exercises'})">Tracked Tutorials</a><br />
Blackboard Learn Pearson Direct LTI Administrator Guide Page 14
©2015 Blackboard Inc. Proprietary and Confidential
Access the <a href="javascript:lti_launch({%20'handler_urn':'pearson/tpi/mml_xl','book':'Kaplan201A','targetId':'calendar'})">Calendar</a><br /> 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><br />
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.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 15
©2015 Blackboard Inc. Proprietary and Confidential
NOTE: Users may be asked to accept Pearson’s End User License Agreement when crossing over to the
Pearson site.
Blackboard Learn Pearson Direct LTI Administrator Guide Page 16
©2015 Blackboard Inc. Proprietary and Confidential
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.
top related