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 course-level configuration, skip ahead. If are setting up a course-level App Config follow these steps.
- 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://yourWAMAPsite/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.