Claim PSI Atlas Exam Results Behavior
Associates previously stored PSI Atlas exam results with the current Activity Instance, used when a candidate took their exam before creating a LearningBuilder account.
Overview
LearningBuilder supports "Test-First" registration with PSI Atlas, a model where candidates take their exam before they have an account in the system. When PSI reports results for a Test-First candidate, those results are stored in an unclaimed state rather than being processed immediately — there is no active application to attach them to yet.
During the application process, the member clicks a "Claim Exam" button which fires this behavior. It locates the stored results using the candidate's self-assigned identifier, associates them with the current Activity Instance, and then processes the score exactly as it would for a standard inbound result — updating Workflow Attributes and executing the appropriate pass or fail action. If the candidate sat for multiple exam portions, all matching results are claimed and processed together.
This behavior is only available on Complete Activity Workflows.
If no stored result can be found matching the candidate's identifier, the behavior sets the Claim Processed attribute to false and writes an error message to the Claim Disposition attribute. This condition requires manual intervention to resolve.
For JSON argument structure and field reference, see Behavior Arguments JSON Reference.
See also: PSI Atlas Integration.
Configuration
Each field selects a Workflow Attribute that will hold the corresponding value. PSI-specific identifiers are read from these attributes to locate the stored results; outcome fields are written to once the claim is processed.
Field | Purpose |
|---|---|
Candidate ID Attribute | Identifies the candidate to PSI. In Test-First scenarios this is a self-assigned value the candidate chose using instructions from PSI — for example, Last Name + birthday MMDDYY. |
Test Code Attribute | Identifies the specific exam the candidate sat for. |
Portion Code Attribute | Identifies the portion or section of the exam, where applicable. |
Claim Processed Attribute | Written to once the claim has been successfully processed. Set to false if the claim cannot be matched. |
Claim Disposition Attribute | Stores the outcome of the claim as reported by PSI Atlas, or an error message if the claim fails. |
Claimed By Attribute | Records who performed the claim action. |