LTI (formerly called Basic LTI or BLTI) is a communication protocol defined by IMS Global Learning Consortium that allows remote tools and content from Tool Providers (TP) to be securely integrated into a Tool Consumer (TC) like BrainHoney. With the Dec 2010 (2010.3) release of BrainHoney, BrainHoney and Agilix Learning Services were officially Basic LTI v1.0 compliant, and the May 2012 release is officially LTI 1.1 compliant. This means that if you create a Custom Activity item in your course that links to content hosted on some other LTI v1.1-compliant server, then that server can update scores in the BrainHoney gradebook for that content item using the industry-standard LTI protocol. See http://www.imsglobal.org/cc/statuschart.html
For more details about LTI, visit http://www.imsglobal.org/lti/.
This document describes how you configure BrainHoney to use LTI links in your course content.
System Administrators store key-and-secret combinations in the domain customization XML for the domain that contains a course with LTI links. Beneath the securehash XML element, you create two secretkey elements: one for the key and one for the secret. You store the key in the clear, and you store the secret as encrypted text. Always create the key first, immediately followed by the secret so that for maintainability, you can later tell which secret goes with which key (the node order is preserved), especially if you store multiple key-and-secret combinations. Follow these steps to store a key and secret:
If you ever need to edit it, its order is preserved amongst its sibling nodes, so to edit an existing secret, you delete the EncryptedData element beneath the secretkey element and re-add the secretkey for the updated secret.
Follow these steps to create an LTI Link in the BrainHoney Syllabus editor:
When any end-user views an activity configured for LTI signing, BrainHoney launches the activity with standard LTI parameters. Many are obvious from their names. This table lists the values for parameters that are not obvious and it also lists the extension parameters that BrainHoney includes:
|Name||Corresponding BrainHoney Data|
|context_id||The course's ID.|
|context_title||The course's title.|
|context_label||The course's External ID, if any. This parameter is omitted if the course does not have an External ID.|
|ext_user_external_id||The External ID of the user launching the link. This parameter is omitted if the user does not have an External ID.|
|lis_person_sourcedid||The username of the user launching the link.|
|resource_link_id||A concatenation of the course's GUID and the item's ID.|
|resource_link_title||The item's title.|
|tool_consumer_info_product_family_code||The value BrainHoney.|
|tool_consumer_info_version||The BrainHoney version numbers in the format major.minor.build. For example, 2013.3.15554.|
|tool_consumer_instance_guid||The hostname from the BrainHoney URL, such as myschool.brainhoney.com.|
|tool_consumer_instance_name||The title of the user's domain, such as Mountain View High School.|
|user_id||The user's BrainHoney-assigned ID.|
A Tool Provider can update the BrainHoney gradebook with the learner's activity results using one of these mechanisms:
When BrainHoney launches an LTI link that needs grading, it launches it using the teacher's credentials (user_id, etc.). However, BrainHoney also includes additional extension parameters so that the Tool can optionally retrieve the student's submission and display it to the teacher. The additional parameters are:
The Tool can optionally display the student's work without requiring the teacher to click any other links. The teacher can then enter a score directly in BrainHoney; or if the tool provides UI to assign a score, the Tool can submit a score for the student using the lis_outcome_service_url that BrainHoney sent when the student launched the activity. (This assumes that the Tool saves that student's URL so that the tool can launch it.) Note: scores set by the Tool through the lis_outcome_service_url appear in the teacher's gradebook after the teacher refreshes the page.
Content publishers that would like to make their content available through LTI or BLTI must implement their web site as an LTI or BLTI Tool Provider. Here are some useful links that can assist in the creation of a provider: