Certiverse Skilljar Live Eligibility Integration

Certiverse Skilljar Live Eligibility Integration

Overview 

Exams in the Certiverse Exam Store can be configured to verify eligibility for candidates in Skilljar when they book an exam in Certiverse. The eligibility verification uses API calls to check that a student in Skilljar with the same email address as the candidate’ booking the exam in Certiverse exists and is enrolled in the configured course and lesson. The Skilljar Configuration section below provides some pointers on how to configure the Published Course, Course and Lesson in Skilljar. 

Certiverse Configuration 

Eligibility using the Skilljar platform is configured for each exam in the Certiverse Exam Store (Admin Portal> Store Exams>Exam). The eligibility is configured on the “Eligibility Configuration” tab and will require the user to know the API Key, Domain name, Published Course name, and the Lesson name from the Skilljar platform. You do not need to know the Published Course ID or Lesson ID, these will be set seamlessly when you select the Published Course and Lesson. 

Candidate Flow and Eligibility Verification 

The eligibility verification from Certiverse into Skilljar will occur once an exam is selected from either the Organization landing page or a deep link to the exam. Prior to verifying eligibility, if the candidate is not already logged into the Certiverse platform, the candidate will be required to log-in; or create a new account if necessary. The students Certiverse account must use the same email address as their Skilljar student account that was used for the course enrollment in Skilljar. Once eligibility is verified, using the Skilljar API, the candidate can complete booking the exam, and the Lesson_Progress_ID returned from the Skilljar API will be stored with the Certiverse exam booking as the Eligibility ID. Upon completion of 

the exam, the Certiverse platform will use the Skilljar API to complete the lesson using the Lesson_Progress_ID and return the pass/fail status. 

Troubleshooting Candidate Eligibility Configuration and Candidate Eligibility 

When verifying the eligibility for an exam in Skilljar there are several steps, and if the candidate eligibility cannot be verified the system will provide additional feedback. This additional feedback can be used to help identify any issues.  

The table below contains the list of additional which can be used to troubleshoot eligibility configuration and candidate eligibility issues. 

Eligibility Flow with API Calls 

1. Skilljar User ID retrieved 
   1. v1/users?email=email@email.com 
   2. Email address used to create Certiverse account is passed to Skilljar and user_id is returned 
   3. Candidate is not eligible if user not returned 
2.  Enrollment in Skilljar Course and Lesson verified 
   1. v1/users/{userId}/published-courses/{courseId}/lessons/{lessonId} 
   2. {userId} returned in step 1 
   3. {coursed} and {lessonId} configured in Certiverse Configuration
   4. Candidate is not eligible if… o Enrollment not returned o Lesson_Progress_ID not returned o Lesson Progress is completed 
3.  Exam completion and Skilljar lesson closed
   
   1. v1/users/{userId}/published-courses/{courseId}/lessons/{lessonId} response has null lesson_progress_id 
   2. Lesson marked completed and pass/fail status returned to Skilljar 
      
      

Skilljar Configuration 

Organizations are responsible for the correct configuration within Skilljar. The Certiverse platform requires a course with one lesson into which a candidate is enrolled. The course and lesson progress are used to verify exam eligibility in the Skilljar platform. The Certiverse platform will make API calls to the Skilljar platform to verify that a user with the candidate’s email exists and is enrolled in the configured course and lesson. 

Skilljar Lessons, Courses, and Published Course Configuration 
The correct configuration of the Course and Lesson in Skilljar are critical to ensure seamless and functional integrations. Below are some pointers we have found may help when configuring exam eligibility in Skilljar. 

Skilljar Lessons 
After creating a Course in Skilljar you will need to add a Lesson, which is used to create a lesson progress ID when the candidate enrolls in the course, which can then be used by Certiverse to complete the course enrollment and return a pass or fail outcome. 

Lesson Content Type 
We have found the “Text Lesson” type works best. The “Text Lesson” includes the setting to “Disable Automatic Completion”; which is necessary to have a course enrollment in progress which can be used to verify eligibility; and allows a Hyperlink to be configured with the link to your Organization Landing Page in Certiverse or a deep link to the exam in the Certiverse exam store. 

 
Skilljar Lesson Configuration 
Adding a hyperlink in the lesson Content to the exam in the Certiverse exam store will create a seamless flow. The “Disable Automatic Completion” setting must be selected to ensure the lesson remains open after the candidate enrolls, which allows Certiverse to verify eligibility and close the lesson with the pass/fail outcome. 

 
Skilljar Course Configuration 
The Skilljar Course configuration is used to control the display and behavior of the course content, versus the “Published Course” which controls the availability on your catalog page and candidates’ ability to enroll. A couple important settings for the Course are the “Use Lesson Score As Course Score” and “Completion Criteria”, both in the “Course Score” section when configuring the Course Settings. 

Updating the Course Pass/Fail with the Lesson Score 
Enabling the “Use Lesson Score As Course Score” and selecting the Lesson you configured for the exam will update the Course with the pass/fail status returned from Certiverse for the lesson. This will allow you to use the course status for various purposes in Skilljar and will display “Passed” or “Not Passed” in the status column of students Skilljar profile, versus “Completed”. 
When using the lesson score for the course score, you should also select “Mark the course as complete if the student passes or fails”. This will complete course enrollment even if the student fails, require the student to enroll in the course again to retake the exam, and track the pass/fail outcome for each enrollment. 

 
Skilljar Published Course Configuration 
Publishing a course adds the course to your course catalog to make it visible and accessible to students. The Published Course is what you will select in the Certiverse platform when you configure Skilljar eligibility for a Certiverse exam. The Published Course has a few settings under the Re-enrollment Settings that will impact the integration with Certiverse. 

Configuring the Published Course Domain 
The first setting is the “Domain”. The Domain is selected in the Certiiverse platform to determine which Published Courses are listed when you configure Skilljar eligibility. 

 
Configuring Re-enrollment and Course Progress 
To allow students to immediately enroll in the course again after completing the exam you need to configure the Re-Enrollment settings. This is done by enabling “When students complete the course, enable them to re-enroll in the course immediately” under “Self-service Re-enrollment” section. This is particularly useful when you are first setting up the integration and need to test the flow multiple times. Later on, you may choose to use other functionality in Skilljar to control when the enrollment is expired or de-activated, and the allow the student to enroll in the course again and re-take the exam. 

Creating a new course progress when a candidate re-enrolls in a course is necessary to create new eligibility when retaking an exam. This course progress will also be used to track the pass/fail outcome of each attempt in Skilljar. This is done by enabling “Create a new course progress each time a student enrolls in the course” under the “Course Progress” section.
 
 
Implementation Note 
During implementation, as well as when adding new courses/exams, you may choose not to add the course to a Skilljar catalog page and use the URL to access the Published Course. This will hide the course from students while you verify the configuration. 
 

SkillJar Status Check: