Procedures
Setup Canvas
- Log in to Canvas as a System Admin.
- Select Admin and select the appropriate account.
- Select Developer Keys in the list on the left.
Note: If you do not see this option, you'll need to select a higher-level account.
- Select + Developer Key and then+ API Key.
- Enter your information in the Key Settings fields:
- For Key Name, enter: ExamSoft
- For Owner Email, enter your LMS or ExamSoft admin email.
- For Redirect URIs, enter: https://phx004-api-prod.examsoft.com/v1/canvasdevkey
- The remaining fields can be left blank.
- Select Enforce Scopes.
- Select the Allow Include Parameters checkbox.
- Enable the following endpoints under each category:
Accounts
- url:GET|/api/v1/accounts
- url:GET|/api/v1/course_accounts
- url:GET|/api/v1/accounts/:id
- url:GET|/api/v1/accounts/:account_id/help_links
- url:GET|/api/v1/accounts/:account_id/courses
Assignments
- url:GET|/api/v1/courses/:course_id/assignments
- url:POST|/api/v1/courses/:course_id/assignments
Courses
- url:GET|/api/v1/accounts/:account_id/courses/:id
- url:GET|/api/v1/courses/:course_id/users
Enrollments
- url:GET|/api/v1/courses/:course_id/enrollments
Result
- url:GET|/api/v1/courses/:course_id/live_assessments/:assessment_id/results
Roles
- url:GET|/api/v1/accounts/:account_id/roles
Sections
- url:GET|/api/v1/courses/:course_id/sections
- url:GET|/api/v1/courses/:course_id/sections/:id
- url:GET|/api/v1/sections/:id
Submissions
- url:GET|/api/v1/courses/:course_id/assignments/:assignment_id/submissions/:user_id
- url:PUT|/api/v1/courses/:course_id/assignments/:assignment_id/submissions/:user_id
- Select Save (in the bottom right corner).
- Under State, select ON for the ExamSoft entry you just created.
- Make note of the values that you'll need to set up the ExamSoft integration:
- Open a text file where you can copy and paste two values that you'll need later.
- On the first line, enter the phrase Client ID, followed by a colon and a space.
- Make a new line, and enter the phrase Client Secret, followed by a colon and a space.
- Return to Canvas.
- In the Details column, copy the numeric value above the Show Key button. (For this value, do not select the button, just copy the value that appears in the box above it.)
- In your text document, paste the copied value after the phrase Client ID.
- Return to Canvas, select the Show Key button, and then copy the value that appears.
- In your text document, paste the copied value after the phrase Client Secret.
Setup ExamSoft and Run the Sync Process
- Log in to your ExamSoft portal as an Institution Administrator.
Note: If you are the LMS admin without any access to your ExamSoft portal, you need to either obtain an account with proper access or work with someone who has the correct access before you can continue.
- Select Admin >Global Settings >LMS Settings.
- Select Canvas Dev Key from the LMS Type drop-down menu.
- Enter your information in the following fields:
- For Canvas Server, paste your Canvas instance URL.
- For Client ID, paste the value that you saved earlier in your text file.
- For Client Secret, paste the value that you saved earlier in your text file.
- Select the Generate Key button, and it will launch a Canvas login screen.
- Log in with a Canvas admin account.
- Select Authorize, and you'll be redirected back to your ExamSoft portal.
- Select Save (in the top right corner).
- Select Configure to configure course, section, & student ID types as well as role designations.
- Select the desired Course ID, Section ID, and Student ID Types from their respective drop-down menus.
Note: These values are the elements from the Canvas environment that will end up being the course, section, and student IDs within ExamSoft.
- Select the applicable Course Admin and Student Roles.
Note: The value selected for Course Admin roles will dictate which Canvas users names are synced to ExamSoft courses as course admins. The value selected for Student roles will dictate which Canvas users are synced to ExamSoft as students.
- Select Save (in the top right corner).
- Select Edit Sync Settings to open the list of courses from Canvas.
Notes:
- If this is your first time visiting the Sync Settings page, select Refresh Courses to retrieve the list of the courses from your Canvas instance.
- This is just retrieving the list of courses, not syncing them. It can take a while to retrieve this list depending on the amount of courses in Canvas.
- Once the refresh is complete, you will see the full list of courses retrieved from your Canvas instance on the Select Courses tab.
- Search by Course ID or Name to find each specific course to add to the sync list.
Note: If you're searching by ID, the specific ID is dependent on your choice from the Configure page.
- Select + to add each desired course or section to the sync list.
Note: For courses that have sections, you will also see a> icon. Selecting that will show the nested sections underneath.
- Select the Edit Sync List tab.
- Adjust the start and end dates for courses, as needed.
- Select the department that the courses will be created in within the ExamSoft portal.
Note: This step may be done in bulk. Select the check-boxes on the left, and you can use the bulk options that appear at the bottom of the page.
- Select Save (in the top right corner).
- Select Sync Now to trigger a manual sync into your ExamSoft portal.
Note: This process may take several minutes depending on how much data you are syncing into the portal.
- Select View History to view the current sync status.
- Verify that the course and student data are now in ExamSoft by navigating to the department that you synced into.
- Search for the courses and sections you chose to sync, and make sure the enrollments match with Canvas.
Next Steps
If you do not see the data that was supposed to sync over, see: Enterprise Portal: LMS Sync Errors