Ensure that privacy settings allow student information to be sent to Perusall
When setting up Perusall as an LTI app, make sure that your LMS is sending name, email, and role information to Perusall; Perusall uses this information to assign users the correct role (student, teaching assistant, or instructor) in the course, show student names in conversations, and send students email notifications when other students respond to their questions or comments. (For example, Canvas has a "Privacy" dropdown that should be set to "Public.")
Ensure that the first launch of Perusall from the LMS is from an instructor account
The first time you click on the Perusall link in your LMS, it should be from an instructor account (not an admin or student account); this will trigger course creation in Perusall. After this point, any member of the course can click the Perusall link and will be taken to the corresponding course in Perusall.
Ensure all required fields are being sent
If LTI launch fails, ensure that your LMS is sending all of these required fields (in particular, some fields will not be sent without the proper privacy settings from above):
-
user_id(an ID number uniquely identifying each user) -
roles(LTI standard role identifier) -
lis_person_name_full(full name) -
lis_person_name_given(first name) -
lis_person_name_family(last name) -
lis_person_contact_email_primary(email address) -
resource_link_title(placement identifier, if gradebook sync enabled) -
lis_outcome_service_url(URL to post grades back to, if gradebook sync enabled) -
lis_result_sourcedid(indicator of grade passback location, if gradebook sync enabled)
Ensure Perusall will open in a new tab/window
Make sure that you have selected the option to open Perusall in a new tab or window; otherwise, LTI launch will fail. Perusall blocks LTI launches within an iframe for security reasons.
- In Blackboard, web Links added to the left-hand navigation menu or within a Learning Module cannot be opened within a new tab/window, so make sure any Perusall links are created within a regular content area. Edit the Web Link and change Open In New Window to Yes:
- In Canvas, edit the assignment settings, and under Submission Type check the box Load This Tool In A New Tab:
- In Desire2Learn, click the down arrow next to the Perusall link you have created in a content area, and then click Edit Properties In-place. Then check the Open as External Resource box, and reload the page.
- In Moodle, navigate to Site administration > Plugins > External Tool > Manage Tools, and click the gear button to edit the Perusall tool. Then change Default Launch Container to New window under the Tool settings area:
Ensure that the assignment description does not contain newline or special characters
Some LMSs fail to properly process LTI launches when the assignment description for an assignment that launches Perusall contains newline characters or special characters such as accents. Place the description of the assignment on one line.
(For LTI 1.1 courses) Ensure that students are launching Perusall assignments from assignment-specific links in your LMS, if you want to use grade sync
In order for the grade sync to work, students have to launch each Perusall assignment from an assignment-specific link in your LMS (i.e., one with a name that matches the title of an assignment in Perusall). During that launch process, the LMS passes information to Perusall that tells Perusall where to send the grade for that student back to.
If you have a grade for a student that isn't syncing back to Perusall, it may be because the student launched Perusall from a generic LTI link and navigated to an assignment within Perusall (so Perusall won't be able to sync the student's grade on that assignment back to Perusall).
However, this can be fixed retroactively -- if the student launches the Perusall assignment from the corresponding assignment-specific link in the LMS (and then just closes the browser, if the assignment is already complete), that will allow the LMS to send the information to Perusall it needs to do a grade sync, and that student's grade will then be sent back to the LMS. (Most grades sync immediately, although it may take up to an hour for a grade update to be reflected in the LMS.)
Ensure that assignments are worth the same number of points in the LMS as they are in Perusall
Due to the way LTI works, grades are sent to the LMS as a percentage, rather than as a raw score. The LMS will then apply that percentage to the assignment based on the number of points you have set for that assignment in the LMS. For example, if your lowest possible assignment score is 0 and highest possible assignment score in Perusall is 5, and the assignment is set in the LMS to be worth 10 points, a score of 4 will be sent across to the LMS as 80% and will show up in the LMS as 8/10. For this reason, we recommend that you set up assignments in your LMS to be worth the same number of points as they are worth in Perusall.
Please whitelist messages coming from @perusall.com and @mg.perusall.com to ensure users are able to receive our emails.
Related to