Embedding assessments allows you to embed an entire Qualified assessment directly in another page. This makes it easy to fully test candidates and students without them leaving your site.
You should embed the full assessment whenever you need the following:
- The complete assessment experience, including getting full scores & playback.
- The full project challenge experience, including creating and moving files.
- Q&A challenges
Quick Start Example
Before you can use embedded assessments, you need to invite the candidate or student using the AssessmentInvitations API. This provides you with the unique
authToken properties needed to load the assessment.
Then simply create a new
QualifiedEmbeddedAssessment with a DOM node and those properties, the assessment will be loaded into your page automatically.
There are a few options you can use to customize the assessment editor, as well as interact with the editor directly.
Below will highlight some of the more useful options. A complete list of options is available in
Example Appearance Options
These options will help you configure the style and visible components of the editor.
modecan be set to
restrictedto change how editing and saving works.
hideSidebarcan be used to completely hide the built-in navigation sidebar. If you do this, you may want to provide external controls for challenge navigation. However, the internal challenge buttons will allow the candidate to move forward to the next challenge and through to submission (but never backwards to a previous one).
Also note this hides the timer. On timed assessments, this means you'll need to provide your own external timer. You can use
onLoadedto create an external timer.
hideWelcomecan be used to immediately start a candidate on the assessment. This also hides any welcome screen information, such as navigation and timer information.
The embedded editor provides several callbacks throughout its lifecycle. Click on any callback for details.
onLoaded()is called after the assessment editor has been loaded. It can be used to learn more about the assessment.
onUpdated()is called whenever there is an update to the assessment result, including events that affect score & completion information.
onSolutionUpdated()is called as challenges are changed and solutions are modified.
onSubmitted()is called once the entire assessment has been submitted.
onError()is called for unrecoverable error events, such as network errors or permissions errors.