Introduction
Note: This guide is for instructors who wish to assess exams in PrairieLearn through Honorlock’s Canvas integration.
In this guide, you will learn how to register a PrairieLearn exam as a Third Party Exam in Honorlock.
You’ll learn:
- How to set up the exam in PrairieLearn with the information Honorlock requires.
- How to register the exam in Honorlock with the information from PrairieLearn.
- How to expose the exam to your students in your Canvas course.
-
-
Create an exam in PrairieLearn however you normally would.
-
In this example, we've used the infoAssessment.json file to configure a basic exam based on the default sample question available in all PrairieLearn courses.
-
In the infoAssessment.json file, complete the allowAccess key with the appropriate restrictions. Set the exam mode to Public, specify the credit for the exam, add start & end dates/times, and set a password for the exam. The password will be used later, please remember it.
-
There are two modes for exams, Public or Exam. The exam mode 'Exam' restricts access to the exam from specific IP ranges and is useful only in a testing center environment.
-
-
-
In PrairieLearn, click on the exam you just created from within your course instance.
-
On the assessment page, click the red Instructor View button in the navigation bar at the top of the page.
-
Click on Switch to student view for ExamNameHere to switch to the student view for the exam.
-
In the student view, copy the URL in your browser's address bar. This is the URL you will use to inform Honorlock of the exam location.
-
-
-
Navigate to your course in Canvas & open the Honorlock LTI tool from the left-hand navigation menu.
-
In the Honorlock app within Canvas, click the three dots in the upper right corner and choose the option for Register Third Party Exam. This is how we will tell Honorlock about the PrairieLearn exam.
-
Fill in the exam details using the information from the PrairieLearn exam infoAssessment.json file.
-
In the Exam Platform field, enter UMD PrairieLearn.
-
In the Exam URL/link field, enter the URL of your PrairieLearn exam. You can get this value by navigating to the exam in PrairieLearn and then switching to student view using the button in the nav bar. The url displayed in your browser's address bar will be the direct link to the exam.
-
-
-
Now configure the proctoring settings for your PrairieLearn exam.
-
We recommend leaving the default options in proctoring settings and enabling both Browser Guard and Whitelist URLs settings.
-
In the Whitelist URLs box, enter prairielearn.umd.edu (omit http/https) and click Add Site.
-
After you have added the site, it will show up below the text box.
-
Specify any additional student guidelines in the next section, write in any additional accommodations, and then decide on when your exam will be visible within Honorlock.
-
After you are satisfied with the configuration, click on the Create button to create the exam within Honorlock.
-
-
-
After you've created the PrairieLearn exam in Honorlock, it will show up in the list of exams within Honorlock and you will see when the exam is available listed below its name.
-
You can change your exam's settings (for example, to add another whitelisted url) using the settings button.
-
You can view the results of the exam (incident level, etc.) using the results button.
-
-
-
Finally, you'll need to provide instructions to your students on how to access the exam in Honorlock.
-
Students can see the exam by opening the Honorlock navigation item in their course.
-
It's up to you as the instructor to determine how you expose the exam to your students.
-
We recommend creating an assignment in Canvas that unlocks at the specified times you set in PrairieLearn and Honorlock.
-
When creating the assignment, under Submission Type specify External Tool & use the Find button to select Honorlock.
-
When it's time to take the exam, students will open the assignment in Canvas & Canvas will load Honorlock into a window below the assignment description, providing a quick and easy method to launch the exam in Honorlock.
-
Congratulations, you’ve successfully set up your PrairieLearn exam to use Honorlock.
Congratulations, you’ve successfully set up your PrairieLearn exam to use Honorlock.