WAMAP Help

LTI Integration

WAMAP can be used as a LTI tool using a course-level configuration or a global college-wide configuration.

Key Types

For a course-level configuration, your LTI key will take the form LTKkey_###_#. The first number, ###, is your course ID. The last number determines how authentication is handled. If that last digit is 0, then when the student accesses the LTI placement, the first time they will be asked to sign into their WAMAP account or create one, and that account will be linked with the account at the host LMS. From then on, when the same student accesses any LTI placement, they will not need to sign in again. They will be able to sign in directly to WAMAP as well.

If the last digit of your LTI key is 1, then a student account will automatically be created the first time a student accesses the LTI placement, and that account will be linked with the host LMS account. The student will not be provided an WAMAP username or password, so they will only be able to access WAMAP resources through the LMS LTI placements.

Note that grade return ONLY works reliably with the _1 type keys, so that type of key is recommended.

LTI Connection Options

WAMAP supports several types of LTI integration, including whole course single-signon, and new links created from the LMS.

The recommended integration technique is to setup individual LTI links for each assessment. This is necessary if you want the grade to be returned from WAMAP to your LMS. The easiest way to set up LTI links in the LMS is to use the Export feature in WAMAP to create links and import those into your LMS. To do this, go to Course Items -> Export, select the items you want to export, your LMS, and Download the CC Export. Then follow the appropriate instructions below.

Alternatively, you can manually create individual links to assignments, or you can create a single link that launches your entire WAMAP course. Be aware that in many LMSs, manually created links to assignments will lose their association with WAMAP assessments when the course is copied in the LMS, so using the Import process is recommened when supported by the LMS.

WAMAP can also be an LTI consumer, using the External Tool option for Link items.

Canvas Integration - Using Import

Go to Course Items → Export, select the items you want to export, select your LMS, and Download the Export Cartridge

To import the cartridge in Canvas:

Go to Settings, then Import Course Content
For Content Type, select Canvas Course Export Package. Select the export file from your computer, and select All Content. Click Import.
If you have a global college-wide key and secret, you do not need to set up a course-level configuration. If you need to set up a course level configuration, in your Canvas course:
- Go to Settings, then Apps, then View App Configurations
- Locate for the WAMAP App. Use the gear icon dropdown to select Edit
- For the Consumer Key, enter: LTIkey_####_1, where #### is your Course ID
- For Shared Secret enter the secret you set up in your Course Settings
- Click Submit

Next you will need to establish the connection between your WAMAP course and Canvas course

In Canvas, click one of the assessment links in your course.
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
Follow the prompts to associate the LMS course with your existing WAMAP course or create a copy.
Once complete, all the LTI links in your LMS should work.
Be aware:
- Links, files, forums, and and text items were imported into your LMS. Changing them in WAMAP will not change them in your LMS
- If you change assessment settings or the questions in an assessment in WAMAP, those changes will show up when the assessment is launched from the LMS
- If you change due dates in WAMAP, they will be enforced by WAMAP, but the due dates in the LMS will not automatically be updated. However, there is a course setting to allow Canvas to set the due dates in WAMAP.
- Any new items added in WAMAP, including new assessments, will not automatically show up in the LMS; you would need to repeat the export/import process.
- If configured, grades will be sent from WAMAP to the LMS immediately every time the student completes a question, but the LMS may delay updating the grade.

Note: When configuring a course-level configuration, the use of a key in the form LTIkey_###_1 is recommended. With this type of key, students will not have or need a username for WAMAP, and they must access assignments via the LMS. This is usually desired when doing integration, and is necessary to ensure grades are passed from WAMAP back to the LMS. If, however, you are not interested in grade return, and simply want to provide single-signon from your LMS into WAMAP while allowing direct login to WAMAP as well, then you can use a key of the form LTIkey_###_0 instead. This will require students to have or create an account on WAMAP, which they'll have to log into once to establish the connection.

Canvas Integration - Manual Process

If you have a global college-wide key and secret, you do not need to set up a course-level configuration. If you need to set up a course level configuration, in your Canvas course:

Go to Settings, then click the Apps tab
Click on View App Configurations, then the +App button
For Configuration type, select "By URL"
For Name, enter WAMAP, or whatever you'd like
For Consumer Key, enter: LTIkey_####_1, where #### is your Course ID
For Shared Secret enter the secret shown in your WAMAP Course Settings
For the Config URL, enter https://www.wamap.org/canvas.php
Click Submit

To create a link to an individual assessment, in Canvas:

Go to the Assignments page, and click +Assignment
Under Submission Type, select "External Tool"
Click on the "Find" button, then on the WAMAP tool (or whatever name you used when you created the tool)
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
If this is your first link from this course, WAMAP will ask you to select the WAMAP course you want to connect your LMS course with.
Select the assignment you want to link to, and click Make Placement.
Click the Select button
Finish setting up the assignment in Canvas
Assignments set up this way will receive grade return from WAMAP

To create a single link to your entire WAMAP course, in Canvas:

On the Modules page, click on the + button inside a module
In the "Add" dropdown, select "External Tool"
Click on the WAMAP tool (or whatever name you used when you created the tool)
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
If this is your first link from this course, WAMAP will ask you to select the WAMAP course you want to connect your LMS course with.
Select "Whole Course Placement" and click Make Placement.
Click Add Item
Note that there is no grade return from WAMAP from a whole course placement.

Blackboard Integration - older Common Cartridge Instructions

Go to Course Items → Export, select the items you want to export, select your LMS, and Download the Export Cartridge

To import the cartridge in BlackBoard:

Go to Packages and Utilities, then Import Package
Click Import Package
Select the export file from your computer, click Select All to select all course materials, then click Submit.
If your school has a global key and secret setup, skip ahead. If you need to set up a course-level configuration, follow these steps.
- To to Packages and Utilities, then Manage LTI Links
- If the links are listed as Working, then you have an existing configuration, and do not need to continue.
- For one of the links with status listed as Broken, use the drop-down menu that shows when hovering over the link name and select Edit Credentials.
- For the Tool Provider Key, enter: LTIkey_####_1, where #### is your Course ID
- For the Tool Provider Secret enter the secret you set up in your Course Settings
- Check the box "Apply these credentials to all links"
- Click Submit
To enable grade return, Blackboard requires some additional steps:
- Return to the main course page in Blackboard.
- For each assessment link that was imported, use the drop-down menu and select Edit
- Set the Enable Evaluation option to Yes, specify the points possible (it does not need to match the points possible in WAMAP), and set a Due Date if desired.

Next you will need to establish the connection between your WAMAP course and BlackBoard course

In BlackBoard, click one of the assessment links in your course.
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
Follow the prompts to associate the LMS course with your existing WAMAP course or create a copy.
Once complete, all the LTI links in your LMS should work.
Be aware:
- Links, files, forums, and and text items were imported into your LMS. Changing them in WAMAP will not change them in your LMS
- If you change assessment settings or the questions in an assessment in WAMAP, those changes will show up when the assessment is launched from the LMS
- If you change due dates in WAMAP, they will be enforced by WAMAP, but the due dates in the LMS will not automatically be updated.
- Any new items added in WAMAP, including new assessments, will not automatically show up in the LMS; you would need to repeat the export/import process.
- If configured, grades will be sent from WAMAP to the LMS immediately every time the student completes a question, but the LMS may delay updating the grade.

Blackboard Integration - Using Import

Go to Course Items → Export, select the items you want to export, select your LMS, and Download the Export Cartridge

To import the cartridge in BlackBoard:

Go to Packages and Utilities, then Import Package
Click Import Package
Select the export file from your computer, click Select All to select all course materials, then click Submit.
If your school has a global key and secret setup, skip ahead. If you need to set up a course-level configuration, follow these steps.
- To to Packages and Utilities, then Manage LTI Links
- If the links are listed as Working, then you have an existing configuration, and do not need to continue.
- For one of the links with status listed as Broken, use the drop-down menu that shows when hovering over the link name and select Edit Credentials.
- For the Tool Provider Key, enter: LTIkey_####_1, where #### is your Course ID
- For the Tool Provider Secret enter the secret you set up in your Course Settings
- Check the box "Apply these credentials to all links"
- Click Submit
If importing a Common Cartridge, to enable grade return Blackboard requires some additional steps:
- Return to the main course page in Blackboard.
- For each assessment link that was imported, use the drop-down menu and select Edit
- Set the Enable Evaluation option to Yes, specify the points possible (it does not need to match the points possible in WAMAP), and set a Due Date if desired.

Next you will need to establish the connection between your WAMAP course and BlackBoard course

In BlackBoard, click one of the assessment links in your course.
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
Follow the prompts to associate the LMS course with your existing WAMAP course or create a copy.
Once complete, all the LTI links in your LMS should work.
Be aware:
- Links, files, forums, and and text items were imported into your LMS. Changing them in WAMAP will not change them in your LMS
- If you change assessment settings or the questions in an assessment in WAMAP, those changes will show up when the assessment is launched from the LMS
- If you change due dates in WAMAP, they will be enforced by WAMAP, but the due dates in the LMS will not automatically be updated.
- Any new items added in WAMAP, including new assessments, will not automatically show up in the LMS; you would need to repeat the export/import process.
- If configured, grades will be sent from WAMAP to the LMS immediately every time the student completes a question, but the LMS may delay updating the grade.

Blackboard Integration - Manual Process

To manually create a link to WAMAP, in Blackboard:

Under the Build Content dropdown, select Web Link
Give the link a Name
For URL, enter https://www.wamap.org/bltilaunch.php
Click the checkbox for "This link is to a Tool Provider"
If you have a global college-wide key and secret, you will not see or need to fill out the following two entries.
- For Key, enter LTIkey_####_1, where #### is your Course ID
- For Secret, enter the secret shown in your WAMAP Course Settings
If you are setting up a link to an individual assessment, set "Enabled Evaluation" to Yes, and enter the points possible. Whole course links to not return grades, so there is no need to enabled evaluation for those.
Click Submit
If the link you just created shows "(invalid link)" next to the name, they you'll need to ask your BlackBoard administrator to approve LTI connections to WAMAP.
Click on the link you just created.
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
If this is your first link from this course, WAMAP will ask you to select the WAMAP course you want to connect your LMS course with.
Select the assignment you want to link with, or select "Whole Course Placement" if you want a single link to your entire WAMAP course, then click Make Placement.

Be aware assessment links created manually in this way will lose their association with WAMAP assessments when the course is copied in BlackBoard, so using the Export/Import process is recommened if you are creating individual assessment links.

D2L Brightspace Integration

Go to Course Items → Export, select the items you want to export, select your LMS, and Download the Export Cartridge

To import the cartridge in Brightspace:

Go to Course Admin, and select Import/Export/Copy Components.
Select Import Components, and "from a course package"
Choose the export file and click Import All Components.
If you have a global key and secret, you can skip ahead. If you need to set up a course-level configuration, follow these steps.
- Go to Course Admin, and click External Learning Tools
- Click on Manage Tool Providers. If you do not see this link, then your LMS administrators have blocked your ability to self-configure the connection. You will need to ask for them to set up a global tool provider.
- Click New Tool Provider
- For the Launch Point enter the address shown on the Export page
- For the Secret enter the secret you set up in your Course Settings
- Click the "Use custom tool information" box if needed
- For the Key, enter: LTIkey_####_1, where #### is your Course ID
- For the name name, enter: WAMAP
- Click the "Allow users to use this tool provider" if that option is available.
- Under Security Settings, make sure the following options are checked (it is OK to check other ones as well):
  - Send tool consumer information to tool provider
  - Send context information to tool provider
  - Send course information to tool provider
  - Send LTI user ID and LTI role to tool provider
  - Send user name to tool provider
  - Send user email to tool provider (optional, but recommended)
- Save

Next you will need to establish the connection between your WAMAP course and Brightspace course

In Brightspace, click one of the assessment links in your course.
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
Follow the prompts to associate the LMS course with your existing WAMAP course or create a copy.
Once complete, all the LTI links in your LMS should work.
Be aware:
- LTI assessments may not show in the gradebook columns until a student started working on an assignment.
- Links, files, forums, and and text items were imported into your LMS. Changing them in WAMAP will not change them in your LMS
- If you change assessment settings or the questions in an assessment in WAMAP, those changes will show up when the assessment is launched from the LMS
- If you change due dates in WAMAP, they will be enforced by WAMAP, but the due dates in the LMS will not automatically be updated.
- Any new items added in WAMAP, including new assessments, will not automatically show up in the LMS; you would need to repeat the export/import process.
- If configured, grades will be sent from WAMAP to the LMS immediately every time the student completes a question, but the LMS may delay updating the grade.

Moodle Integration

Go to Course Items → Export, select the items you want to export, select your LMS, and Download the Export Cartridge

To import the cartridge in Moodle:

Under Course Administration (in some versions, the big gear icon in the upper right), select Restore.
Choose the export file and select Restore.
Follow the prompts to import the content.
Turn on editing for your course.
For one of the assessment, use the Edit dropdown and select Edit Settings.
If the Launch URL does not display the warning Tool configuration not found for this URL, then you must have an existing key and secret set up, and can skip ahead. If you do see that warning, then follow these steps.
- Click the + sign located directly after the External tool type pulldown (in some versions, this is labeled Preconfigured Tool)
- Give the tool a name, like WAMAP
- For Tool base URL enter the address shown on the Export page
- For Consumer Key, enter: LTIkey_####_1, where #### is your Course ID
- For Shared Secret enter the secret you set up in your Course Settings
- Under Privacy, it is recommended to set all options to Always, but it is fine to leave it as Delegate to teacher instead.
- Save changes
- The Launch URL should now indicate Using tool configuration WAMAP. Click Save.

Next you will need to establish the connection between your WAMAP course and Moodle course

In Moodle, click one of the assessment links in your course.
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
Follow the prompts to associate the LMS course with your existing WAMAP course or create a copy.
Once complete, all the LTI links in your LMS should work.
Be aware:
- LTI assessments may not show in the gradebook columns until a student started working on an assignment.
- Links, files, forums, and and text items were imported into your LMS. Changing them in WAMAP will not change them in your LMS
- If you change assessment settings or the questions in an assessment in WAMAP, those changes will show up when the assessment is launched from the LMS
- If you change due dates in WAMAP, they will be enforced by WAMAP, but the due dates in the LMS will not automatically be updated.
- Any new items added in WAMAP, including new assessments, will not automatically show up in the LMS; you would need to repeat the export/import process.
- If configured, grades will be sent from WAMAP to the LMS immediately every time the student completes a question, but the LMS may delay updating the grade.

LTI Integration for Other LMSs - Using Import

Go to Course Items → Export, select the items you want to export, select your LMS, and Download the Export Cartridge. The cartridge is an IMS Common Cartridge format.

Import the cartridge into your LMS. If your school has a global key and secret setup, skip ahead. Otherwise, you'll likely need to configure the LTI connection by providing the key and secret, which can be found on the Course Settings page.

Next you will need to establish the connection between your WAMAP course and LMS course

In your LMS, click one of the assessment links in your course.
If this is your first time using this key and secret, WAMAP will ask you, the teacher, to sign into your WAMAP account. This is necessary to establish a connection between your LMS account and your WAMAP account. You will not need to do this step again, and students will not be asked to sign in and will not need a WAMAP account.
Follow the prompts to associate the LMS course with your existing WAMAP course or create a copy.
Once complete, all the LTI links in your LMS should work.
Be aware:
- Links, files, forums, and and text items were imported into your LMS. Changing them in WAMAP will not change them in your LMS
- If you change assessment settings or the questions in an assessment in WAMAP, those changes will show up when the assessment is launched from the LMS
- If you change due dates in WAMAP, they will be enforced by WAMAP, but the due dates in the LMS will not automatically be updated.
- Any new items added in WAMAP, including new assessments, will not automatically show up in the LMS; you would need to repeat the export/import process.
- If configured, grades will be sent from WAMAP to the LMS immediately every time the student completes a question, but the LMS may delay updating the grade.

LTI Integration for Other LMSs - Manual Process

If you have a global college-wide key and secret, you do not need to set up a course-level configuration. Otherwise, you will need to set up a course-level LTI configuration. Consult your LMS's help for how to do this; some LMSs configure an LTI took at the course settings level, while some have you enter the credentials with each link.

If you need to set up a course-level LTI configuration, you will need:

A Consumer/Tool Key: LTIkey_####_1, where #### is your Course ID
A Secret: use the LTI secret shown in your WAMAP Course Settings
Launch/Tool URL: https://www.wamap.org/bltilaunch.php

The process to set up LTI links varies by LMS, so consult your LMS for details.

Be aware assessment links created manually in this way will lose their association with WAMAP assessments when the course is copied in the LMS, so using the Export/Import process is recommened if you are creating individual assessment links and your LMS supports it.