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 an LTI 1.3 connection or global LTI 1.1 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 an LTI 1.3 connection or global LTI 1.1 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 you have an LTI 1.3 connection or global LTI 1.1 college-wide key and secret, 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.
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.
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 you have an LTI 1.3 connection or global LTI 1.1 college-wide key and secret, 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.
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.
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 an LTI 1.3 connection or global LTI 1.1 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 an LTI 1.3 connection or global LTI 1.1 college-wide 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.
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.
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 LTI 1.3 connection or LTI 1.1 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.
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.
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 you have an LTI 1.3 connection or global LTI 1.1 college-wide key and secret, 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.
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.
LTI Integration for Other LMSs - Manual Process
If you have an LTI 1.3 connection or global LTI 1.1 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.