3.7 The LTI Page - Maple T.A. 2016 Help
Maple T.A. Online Help

System Administrator
Select your version: Maple T.A. 2017 | Maple T.A. 2016 | Maple T.A. 10

3.7 The LTI Page

Learning Tools Interoperability (LTI)® establishes connection between learning applications that are provided through third-party services and are often remotely hosted, with Learning Management Systems (LMS) and course management systems (CMS), such as Moodle©, Blackboard®, Canvas©, Sakai©, and Brightspace™ by D2L. The learning application, in this case, Maple T.A., is called the Tool Provider and the LMS/CMS is called the Tool Consumer. Maple T.A. supports the 1.x series and version 2.0 of LTI. For LMS/CMS that support the 1.x series LTI, a Key/Secret pair has to be generated using Maple T.A. before a connection can be established between the two. For LTI 2.0, you do not need to get a Key/Secret pair by logging in to Maple T.A. This is done automatically for you by LTI. Both versions of LTI allow class mapping, assignment mapping with grade return, and system mapping. The LTI connector provided by Maple T.A. has been officially tested with Moodle, Blackboard, Canvas, Sakai, and Brightspace by D2L. While no issues regarding the connection between Maple T.A. and other LMS/CMS have been foreseen, the performance of the connection cannot be guaranteed.

Creating a Key/Secret Pair for Version 1.x

1. In Maple T.A., log in as administrator. From the System Admin menu, select Edit LTI Shared Secret.

2. Click Add Pair to create a separate Key for use with the LMS that you will be testing. Note that you can instead use one of the existing Key/Secret pairs as well.

Configuring an LTI Link

After you setup your LTI Consumer with the Maple T.A. LTI information, you will need to set up the LTI link. Setting up the LTI link is different for every consumer. However, once it is setup, the initial launch of the link will require you to choose what the launch request does.

Class Mapping

Class Mapping allows you to create an LTI link that takes a user straight to a class homepage in Maple T.A.

1. If you have any existing classes in Maple T.A., they will appear in the list of classes. Select the class you want to link to and click Link to Class Home.

Note: If no classes exist or you want to create a new one, click New Class and fill out the information requested by Maple T.A.

2. The class homepage will now appear and the link is configured. You can now exit this window.

Assignment Mapping

Assignment Mapping allows you to create an LTI link that takes a user directly into a Maple T.A. Assignment. Grades will be returned upon completion of this assignment.

1. Select the class that contains the assignment you want to link to.

Note: If no classes exist or you want to create a new one, click New Class and fill out the information requested by Maple T.A.

2. Once the class is selected, a list of available assignments will appear. Select the assignment you want to link to and click Link to Assignment.

Note: If no assignments exist or you want to create a new one or import a course module that contains your content, click New Assignment or Import Content and complete that task in Maple T.A.

3. The assignment will now open and the link is configured. You can now exit this window.

System Mapping

System Mapping allows you to create an LTI link that takes a user straight to the system homepage in Maple T.A.

1. Click Link to System Home.

2. The system homepage will now appear and the link is configured. You can now exit this window.

LTI Field Mapping

If you have already been using Maple T.A., it is possible that some user records exist in Maple T.A. already. To avoid the creation of duplicate records, use the LTI Field Mapping feature to map existing users from your LMS to the corresponding users in Maple T.A.

Once the field mapping has been set up between your LMS and Maple T.A., a user record update in the LMS will trigger an update to the corresponding record in Maple T.A. as well.

If there is no existing Maple T.A. user record then LTI retrieves the information from the LMS, according to the rules defined by the LTI field mapping and creates a user record with matching values in Maple T.A. The user's first name, last name, and role are retrieved by default.

Setting Up the LTI Field Mapping

To set up LTI Field Mapping, do the following:

1. From the home page, click the System Admin menu.

2. Select LTI Field Mappings.

3. In the Field Mappings table, click Add Mapping.

4. Enter the LTI Parameter.

5. Select the appropriate User Profile Field from the drop-down list.

6. Assign a priority number to the mapping. The priority number must be a nonnegative integer. The higher the number, the higher the priority.

LTI Role Mapping

You can use the LTI Connector to map a role in your LMS to a role in Maple T.A. For more information on editing roles in Maple T.A., see Role Manager.

To map a role, do the following:

1. From the home page, select the System Admin menu.

2. Select Edit LTI Role Mappings.

3. Default role mappings are displayed in the Role Mappings table. To change any one of these mappings, click the corresponding Edit button, then in the Role Mapping table, select the role that you want to map to from the list.

4. If you want to create a role mapping for an LMS role that does not appear in the table, click Add Mapping.

5. In the Role Mapping table, enter the name of the LMS role, then select the corresponding Maple T.A. role from the list.

6. Click Submit.

Moodle

Log in as site administrator in Moodle.

LTI 1.x

1. Navigate to Site administrator > Plugins > Activity modules > LTI > Manage external tool types.

2. Click the Add external tool configuration link.

3. Fill out the External tool configuration form in the following manner:

4. Click Save changes.

Now to create a link between a Moodle resource and a Maple T.A. assignment, proceed to Assignment Mapping.

LTI 2.0

For LTI 2.0 you do not need to get a Key/Secret pair using Maple T.A. The LTI does this for you automatically.

To create a link to register Maple T.A. using the LTI 2.0 standard:

1. First navigate to Site administrator > Plugins > Activity modules > LTI > Manage external tool registration.

2. Next, click the Configure a new external tool registration link.

3. For External tool which is pushing grades, fill out the External tool registration form in the following manner, making sure that you select all of the Capabilities and Services:

External Tool Registration for Grade Pushing

Figure 3.1: External Tool Registration for Grade Pushing


4. Click Save changes.

5. For External tool which is not pushing grades, fill out the External tool registration form in the following manner, ensuring the Capabilities and Services are selected as shown.

External Tool Registration Without Grade Pushing

Figure 3.2: External Tool Registration Without Grade Pushing


6. You can now see a list of the external tool registrations from the Configured tab.

7. Click the check mark next to the newly created Maple TA LTI 2.0 registration. If the registration process was carried out accurately, this entry will be transferred to the Accepted tab.

8. At this point you will be required to log in to Maple T.A. as an administrator if you are not already logged in.

To make Maple T.A. available as a tool type:

1. Navigate to Site administrator > Plugins > Activity modules > LTI > Manage external tool types.

2. Click the Pending tab.

3. Change the default launch container to New window.

4. For the purpose of testing, change Tool name to "Maple TA LTI 2.0". To do this click the cog symbol under Action, make changes shown as follows, and click Save changes.

5. Now, from the Pending tab, click the check mark to complete the procedure.

To create a link between a Moodle resource and a Maple T.A. assignment, proceed to Assignment Mapping.

Blackboard

1. Log in to Blackboard as administrator.

2. Navigate to System Admin > Building Blocks pane > Building Blocks link > LTI Tool Providers.

3. From the Manage Global Properties tab, ensure the selection of the following options:

Manage Global Properties Tab

Figure 3.3: Manage Global Properties Tab


4. Next, go to the Register Provider Domain tab and confirm the information as shown:

Register Provider Domain tab

Figure 3.4: Register Provider Domain tab


Organizational Policies

Figure 3.5: Organizational Policies


 

Where 10.10.3.79 is the IP address of machine with Maple T.A. installation.

5. Return to the LTI Tool Providers menu.

6. Right-click the LTI Tool created, that is, the link to Maple T.A.

7. From the context menu, select Manage Placements.

8. Click Create Placement and confirm the following:

For Student Tool type:

  • If the tool Type is selected as Student Tool, no evaluation results will be recorded in Blackboard's Gradebook.
  • To get to the placement link for accessing Maple T.A., click Courses and open a course link.
  • On the left-hand pane, click Tools, then click the tool created (in this case LTI TA10 Test 1).
  • Now you can access the Maple T.A. Admin Class page.
Placement Information Type: Student Tool

Figure 3.6: Placement Information Type: Student Tool


 

For Content Tool type:

  • From the Tools menu, select Assessments, followed by Build Content (Mashups) or Build Content (Create).
  • Select the check box for Placement allows evaluation to record evaluation results in Blackboard's Gradebook.
  • To get to the placement link for accessing Maple T.A., click Courses and open a course link.
  • On the left-hand pane, click Content, then click the tool created (in this case LTI TA10 Test 2).
  • On the next page, enter a name for the link.
  • Select Yes for the Enable Evaluation option.
  • Click Submit.
  • Return to the Content page, and click the link you just created. This should open the Maple T.A. Admin Class page.
Placement Information Type: Content Type

Figure 3.7: Placement Information Type: Content Type


Canvas

Adding the External Tool to an Account/Sub Account

Canvas's organization structure is a tree system of accounts. A tool can be added at any level within the tree structure, which is then accessible by anyone below that node.

1. To add the Maple LTI tool (Maple T.A.) at the account level, first log in as an administrator.

2. Click Settings from the left-hand menu bar.

3. Open the Apps tab and click View App Configurations.

4. Then click Add App

5. In the Add App dialog, select Manual Entry as the Configuration Type. Enter "Maple TA LTI 1.1" as the Name. Insert the Key/Secret pair from the Maple T.A. System Admin page, along with the Launch URL. Set the Privacy as Public, and enter a Description for the tool.

6. Click Submit to make the app available to everyone within the course or group.

Sakai

LTI Tool Configuration

Before instructors can use Maple T.A., it must be configured globally for your Sakai instance by an administrator.

1. From the Administration Workspace tab, click External Tools.

2. Click Tools Available in System.

3. Click the Add LTI 1.1 Tool and fill out the External Tool form.

4. Enter a Tool Title (for example: “Maple TA”).

5. Enter a Button Text (for example: “Maple TA”).

6. Enter the Launch URL (provided by Maple TA).

7. Enter the Launch Key and Launch Secret as provided by Maple T.A.

8. Check the following options:

  • Send User Names to External Tool
  • Send Email Addresses to External Tool
  • Allow External Tool to return grades
  • Allow popup to be changed
  • Never launch in debug mode

9. Click Save.

External Tool Form in Sakai

Figure 3.8: External Tool Form in Sakai


Grading Configuration

Grades for externally linked Maple T.A. assignments are not pushed into the Sakai grade book without configuring Sakai.

1. From the Sakai installation folder in your server, go to the sub-folder named Sakai, and open the file named sakai.properties with a text editor.

2. Locate the following line in the text file: # serverUrl=http://localhost:8080

3. Uncomment it and edit it so that it uses the IP address instead of localhost. For example, when you have completed editing, it will look something like this: serverUrl=http://10.10.3.6:8080

4. Save the changes to this file and restart Sakai. The grades should get recorded in the grade book once available.

Brightspace

LTI Tool Provider Configuration

The LTI connection can either be configured globally by an administrator of Brightspace or at the class level by an instructor.

To configure globally at the administrator level:

1. Navigate to Admin Tools > External Learning Tools > Manage Tool Providers.

2. Click New Tool Provider.

3. Enter the Launch Point as provided by Maple T.A.: https://yourdomain.com/mapleta/lti/ .

4. Select Use custom tool consumer information instead of default and enter the Key/Secret combination as provided by Maple T.A.

5. Enter a Name, Description and Contact Email for the configuration.

6. Under Security Settings, make sure all the boxes are checked.

7. To choose which courses can access the provider, click Add Org Units.

8. Search for the courses you want to give access to, select them, and click Insert..

9. Click Save.

To configure at the class level using an instructor account:

1. Navigate to the class.

2. Navigate to Course Admin > External Learning Tools.

3. Click New Tool Provider.

4. Enter the Launch Point as provided by Maple T.A.: https://yourdomain.com/mapleta/lti/ .

5. Select Use custom tool consumer information instead of default and enter the Key/Secret combination as provided by Maple T.A.

6. Enter a Name, Description and Contact Email for the configuration.

7. Under Security Settings, make sure all the boxes are checked.

8. Click Save.

How to use a Tool Provider in BrightSpace

Instructors use a Tool Provider as follows:

1. Navigate to the class.

2. Click Content.

3. Go to a Module and then click Add Existing Activities > External Learning Tools.

4. Click Create New LTI Link.

5. Provide a Title and paste the Launch Point your BrightSpace administrator used when setting up the Tool Provider into the Url field.

6. The link will now be created.

Note: A configuration is required before you configure the LTI link. Go to Course Admin > External Learning Tools. You will see your new link under Manage External Learning Tool Links. Using the drop-down menu, select Edit Link. Under Security Settings, select Use tool provider security settings and then click Save and Close.