Prolydian Integration

Overview

LearningBuilder can integrate seamlessly with Pearson VUE to:

• Establish eligibility for a candidate to sit for an exam
• Allow the candidate to schedule their exam using Pearson's self-service website
• Obtain exam results from Pearson VUE
• 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
• Complete Activity
• Complete Learning Plan
• Grant/Edit Member Role

Data Flow

1. Workflow Action triggers the Behavior, which:
   1. Makes an API call to Pearson's "Candidate Demographic Data" service to establish a Candidate Id
   2. Makes an API call to Pearson's "Exam Authorization Data" service and sends an exam authorization for the Candidate ID (using an Exam Code and eligibility period pulled from the Behavior configuration)
      
      
2. Workflow refreshes, Candidate sees a "Schedule Exam" button.
   1. Clicking this button navigates the user to the Pearson VUE self-service exam scheduling website where they can schedule their exam
      
      
3. Candidate is redirected to LearningBuilder and either continues with their Workflow or exits, depending on configuration.
   
   
4. At some point in the future, after the candidate has actually taken the exam, a file containing the exam results is placed by Pearson VUE on an SFTP site that is monitored by LearningBuilder.
   1. Exam file is retrieved, parsed, and processed.
   2. Workflow Attributes are updated with relevant pieces of the result data, per the Behavior configuration
   3. The appropriate Workflow Action is executed depending on the exam grade. (This typically moves the Workflow forward into the next step)

Configuration

• Enable the integration via App Config
• Obtain client certificate from Pearson VUE
• Configure the Pearson VUE web service
• Create the Attributes used by the integration
• Create the Actions used by the integration
• Add the Behavior to a Workflow

Enable the integration via App Config

The Behavior cannot be added to a Workflow unless the "PearsonVueMode" App Config setting is "Test" or "Prod". If set to "Off" the integration is disabled.

Obtain client certificate from Pearson VUE

Each client will need to obtain, from Pearson, a client certificate. This will be a PKS #12 file with a .p12 extension.

Upload the certificate to Sys Admin → App Configuration → Client Certificates. The name that you assign the certificate is not significant, but make note of it because you'll need it for the app config settings.

Configure the Pearson VUE web service

The Behavior can be configured once the feature toggle is enabled, but it will not function properly until the Pearson VUE web service is properly configured.

Note that some settings have separate values for TEST and PROD modes.

Create the Attributes used by the integration

Before configuring the Behavior you must first configure some Workflow Attributes that will be referenced by the Behavior configuration:

• Exam Code - Tells Pearson VUE which exam the eligibility record is for. Can be a text-based attribute or a Template. Common configurations are a Picklist that gets the value from the candidate, a Template that calculates the exam code based on custom business logic, or a value that is specified on one of the Workflow's "reference entities" as part of the back-end configuration.
  
  
• Eligibility Start / End Date - Specifies the date range within which the candidate is allowed to sit for their exam. Can be a date-based attribute or a Template.
  
  
• Special Accommodations - (optional) Specifies a semicolon-delimited list of accommodation codes recognized by Pearson. Can be a text-based attribute, Picklist, Multi-select, or Template. 
  
  
• Authorization Id - A Short Text attribute into which the Authorization Id, which is established by Pearson VUE, is stored following a successful connection to their eligibility API.
  
  
• API Result - A Long Text attribute into which the full API response is stored. This is not generally displayed to the candidate and is stored primarily for troubleshooting purposes.
  
  
• Exam Date - A DateTime attribute into which the actual exam date is stored during the processing of the exam results file. 
  
  
• Exam Score - A Numeric attribute into which the candidate's exam score is stored during the processing of the exam results file. 
  
  
• Exam Grade - A Short Text attribute into which the "grade", which is either "Pass" or "Fail", is stored during the processing of the exam results file.
  
  
• Exam Attempts - A Numeric attribute into which the current attempt # is stored during the processing of the exam results files. 

Create the Actions used by the integration

In addition, you must also configure the Workflow Actions that will be executed after processing the exam results file. LearningBuilder can execute different Actions based on the grade:

• "On Pass" Action - the Action to execute if the candidate passed the exam.
  
  
• "On Fail" Action - the Action to execute if the candidate failed the exam.

 IMPORTANT: The Workflow must be on the step that owns the specified Action at the time that the results file is processed or else the result processing will fail. (The Workflow doesn't have to transition to that step immediately upon sending the eligibility, it just has to be on that step by the time the exam results are processed)

Add the Behavior to a Workflow

Once the supporting fields and actions are created, add the Behavior to a Workflow Action, Workflow Step, or Workflow Completion State configuration.

SFTP details

The SFTP website is managed by Pearson VUE. Credentials are stored in App Config. The site is checked for new files on a nightly basis.