Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
titleSummary

Exam eligibility information, sometimes called "Authorization to Test", can be automatically sent to Pearson VUE Prolydian by a Workflow Behavior. This integration:

  • Establishes a candidate record in the Pearson system
  • Allows the practitioner to schedule their own exam date using a seamless "single-sign-on" redirect to Pearson's website
  • Retrieves exam results using SFTP
  • Updates the exam Activity's Workflow, depending on the results

 

LearningBuilder supports "Test-First" registration via Prolydian . 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.


Overview

LearningBuilder can integrate seamlessly with Pearson VUE with Prolydian to:

  • Establish eligibility for a candidate to sit for an examAllow the candidate to schedule their exam using Pearson's self-service website
  • Obtain exam results from Pearson VUEfrom Prolydian 
  • 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

Data Flow

  1. When the Behavior is configured, administrator selects a Queue Template that controls the eligibility API payload sent to Prolydian, and an xAPI Event Handler which specifies what happens when results are received.
    Image AddedImage Added

  2. When a Workflow Action triggers the Behavior, which:
  3. Makes an API call to Pearson's "Candidate Demographic Data" service to establish a Candidate Id
  4. 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)
    Workflow refreshes, Candidate sees a "Schedule Exam" button.Clicking this button navigates the user to the Pearson VUE self-service exam scheduling website where they can schedule their exam
    Candidate is redirected to LearningBuilder and either continues with their Workflow or exits, depending on configuration.the Message Queue is used to call the Atlas eligibility API. Prolydian 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. 

  5. At some point in the future, after the candidate has actually taken the exam, a file containing  Prolydian calls the xAPI API endpoint and provides an xAPI document representing the exam results is placed by Pearson VUE on an SFTP site that is monitored by LearningBuilder.Exam file is retrieved, parsed, and processed.. The configured handler is executed which parses the document, extracts the document, and maps its values to the Activity Instance as configured. (Note: technically, Prolydian 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

AnchorFeatureToggleFeatureToggleEnable 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.

AnchorClientCertClientCertObtain 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.

AnchorWebServiceConfigWebServiceConfigConfigure 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.

SettingDescriptionPearsonVueMode

Can be "Off", "Test", or "Prod".

Setting this to "Off" disables the entire feature and prevents the Behavior from being added to a Workflow.

PearsonVueCertificateNameProd

PearsonVueCertificateNameTest

The names of the Client Certificates (from Sys Admin → App Configuration → Client Certificates) to use for the web service. calls

PearsonVueClientId

PearsonVueUserName(Test|Prod)

PearsonVuePassword(Test|Prod)

PearsonVuePassphrase(Test|Prod)

Credentials used when calling the EAD and CDD services.

These are client-specific and should be obtained from Pearson.

PearsonVueClientCode

PearsonVueSsoPassphrase(Test|Prod)

Credentials used during the "SSO" handshake when redirecting users to Pearson's self-service exam scheduling website.

These are client-specific and should be obtained from Pearson.

PearsonVueSFTPUsername

PearsonVueSFTPPassword(Test|Prod)

Credentials used when polling Pearson's SFTP server.

These are client-specific and should be obtained from Pearson.

AnchorCreateAttributesCreateAttributesCreate 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. 
  • AnchorCreateActionsCreateActionsCreate 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.
  • (warning) 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)

    AnchorAddBehaviorToWorkflowAddBehaviorToWorkflowAdd 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.

    Requirements

    LearningBuilder 9.2 or later
    Client Certificate from Pearson VUE (client-specific)
  • Web service and SFTP credentials from Pearson VUE (client-specific)
  • Capabilities

    Calls Pearson VUE's "Candidate Demographic Data" web service to establish a Candidate Id
    Calls Pearson VUE's "Exam Authorization Data" web service to create an eligibility record for a specified Exam Code and within a specified eligibility period. All values are pulled from Workflow Attributes and support Templates
    Special Accommodations can be collected and passed to Pearson
    Exam results can be stored in additional Attributes:
  • Exam Date
  • Exam Score
  • Exam Grade
  • Exam Attempts
    Can execute a specific Workflow Action upon receiving a "pass" result. 
    Can execute a specific Workflow Action upon receiving a "fail" result. 
    Candidates schedule their own exams via "SSO" to Pearson's self-service scheduling website (button is displayed on the Workflow popup once the eligibility has been established)

    See 

    Jira Legacy
    serverSystem JIRA
    serverId80a5de98-58ff-3b59-a4bd-e013083b8a1d
    keyLB-2712

    Requirements

    • LearningBuilder 11.0.3 or later

    Capabilities

    • Makes an API call to Prolydian using a configurable template, which allows for customization of the data that are passed

    • When exam results are reported back to LearningBuilder, a custom xAPI Event Handler 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.



    Filter by label (Content by label)
    cqllabel = "pearson-vue"
    Jira Legacy
    serverSystem JIRA
    columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
    serverId80a5de98-58ff-3b59-a4bd-e013083b8a1d
    keyLB-15


    Page Properties
    hiddentrue


    Related issues