PSI Atlas Integration

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

1. 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.
   
   
   
2. 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. 
      
      
3. 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.