Summary

Exam eligibility information, sometimes called "Authorization to Test", can be automatically sent to PSI Atlas by a Workflow Behavior.

LearningBuilder supports "Test-First" registration via PSI Atlas. In this model, candidates take their test before they establish an account in LearningBuilder. During the application process, these candidates can "claim" their exam results.

See also: /wiki/spaces/AWS/pages/620233511 / PSI API docs

Overview

LearningBuilder can integrate seamlessly with PSI Atlas to:

Establish eligibility for a candidate to sit for an exam
Obtain exam results from PSI Atlas
Dynamically update the candidate's application based on those results

The integration is enabled via a Workflow Behavior. It supports these Workflow types:

Create Activity

Data Flow

When the Behavior is configured, administrator selects a Queue Template that controls the eligibility API payload sent to PSI, and an /wiki/spaces/DOCS/pages/639991859 which specifies what happens when results are received.
When a Workflow Action triggers the Behavior, the Message Queue is used to call the Atlas eligibility API. PSI is notified of:
1. The Candidate Id, a unqiue identifier for the candidate themselves, and
2. The Eligibility Id, a unique identifier which represents the authorization to sit for a specific exam administration. The Eligibility Id is determined by the Activity Instance.
At some point in the future, after the candidate has actually taken the exam, PSI Atlas calls the xAPI API endpoint and provides an xAPI document representing the exam results. The configured handler is executed which parses the document, extracts the document, and maps its values to the Activity Instance as configured. (Note: technically, PSI Atlas calls an endpoint in the Integration Hub, which then forwards the request to LearningBuilder. This prevents exam results from being dropped if LearningBuilder is down for maintenance. The integration hub plugin is NOT client-specific)
1. Workflow Attributes are updated with relevant pieces of the result data, per the Behavior configuration
2. The appropriate Workflow Action is executed depending on the exam grade. (This typically moves the Workflow forward into the next step)

Configuration

See FB-33548, FB-33884

"Test-First" registration

When a candidate takes a Test First exam, they choose their own Candidate ID using instructions given to them by PSI. (For example, "Last Name + birthday MMDDYY".

When LearningBuilder receives a Test First score result, it is not processed through the xAPI handler. Instead, it is stored in the database in an "unclaimed" state.

During the application process, an applicant that has already taken an exam will click a "Claim Exam" button. This button will perform a "Claim PSI Exam Results" behavior, which will associate the stored results with the current application.

The score result will then be processed like normal.

Requirements

LearningBuilder 8.22 or later

Capabilities

Makes an API call to PSI using a configurable template, which allows for customization of the data that are passed
When exam results are reported back to LearningBuilder, a custom /wiki/spaces/DOCS/pages/639991859 allows values in the payload to be mapped back into Workflow Attributes
Candidates may take their test before they have an account in LearningBuilder. Exam results are stored in a pending state until they are "claimed" during the application process.

Related articles

Page:
PSI Atlas Integration (LearningBuilder Documentation)
Page:
Send Exam Eligibility to PSI Atlas Behavior (LearningBuilder Documentation)

xAPI PSI Test First (TODO) - Restricted
PSI API Documentation - Restricted