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 VUE

  from 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 /wiki/spaces/DOCS/pages/639991859 which specifies what happens when results are received.
   

   Image AddedImage Added

   
   
   

2. When a Workflow Action triggers the Behavior,

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

2. At some point in the future, after the candidate has actually taken the exam,

1.  Prolydian calls the xAPI API endpoint and provides an xAPI document representing the exam results

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

• 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

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.

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.

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.

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

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.

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

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:

 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)

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.

How to set up Prolydian integration for a new customer

Please complete for each customer. This will become a template so we can create one for each project with minimal hand-off between Implementation and Integration Support.

We need the following :

Configuration

Configure the Prolydian integration as follows ( Steve Ross needs to provide details):

1. If the client has used Prolydian in the past, and you need to maintain the PTI ID, create a short text PTI ID on the Member Role, Learning Plan Instance, and the Exam Activity Instance and also create a Template field call PTI - Computed on the Member Role with logic similar to

   Code Block
   @( Model.MemberRole.GetText("PTI ID").IsNotNullOrEmpty() ? Model.MemberRole.GetText("PTI ID") : "PTINIGPCPP8" + ("000000000" + Model.MemberRole.GetText("Unique Identifier")).Right(9) )

The prefix “PTINIGPCCP8” will be changed to whatever the PTI tells us it needs to be for the client. In this example the template also support PTI IDs assigned prior to launching in LearningBuilder and thus will not overwrite an existing value.

3. Include an Update Workflow Instance Attribute behavior on the Role Grant Workflow or an Update Member Role for Learning Plan behavior on the LPI workflow to set the PTI ID prior to exam eligibility.

4. Include a series of behaviors on the LPI prior to scheduling similar to below:

Image Added

5. Prior to these behaviors being executed, the Exam Activity must already be added to the learning plan.

• Option 1: Pre-add the exam activity on the Learning Plan Definition

• Option 2: Have an administrator manually add it prior to approving the eligibility

• Option 3: Create a custom SPROC to add it as part of the process

• Option 4: Use the new Add Activity to Learning Plan behavior to do it, (not tested)

• Option 5: Have the practitioner do it themselves (see NIGP). In this case, the must be an action on the Activity Instance that is executed prior to sending the eligibility that Executes an Action on the Parent Learning Plan that does the above behaviors. If there is a payment required on the exam exactivity, the Save action on Payment is a good candidate for this (see NIGP). If not, there need to be at least two practitioner steps on the Exam Workflow as the above behaviors must be executed on an entirely separate action from the one that sends the eligibility to Prolydian.

6. Create a Rabbit MQ template called Prolydian Exam Eligibility with the message to send the eligibility. Below is an example.

• Update the Client prefix and Authorization prefix for the client.

• Ensure the Activity Dates are mapped correctly

• Update the Test Group

• Ensure the Code is mapped correctly, or if only one, hard code it here. If no, include it as an extrinsic attribute on the Exam Activity Definition.

@using Heuristics.Library.Extensions
@{
    var ptiId =  Model.GetAttributeValue("PTI ID");
    var clientCandidateId = ptiId.Replace("PTINIGPCPP", "");
    var clientAuthorizationId = "PTINIGPLB" + ("00000000000" + Model.Instance.WriteToItemId.ToString()).Right(11);
	var examCode = Model.GetAttributeValue("Exam Code");
	var activityStartDate = Model.GetAttributeValue("Activity Start Date");
	var activityEndDate = Model.GetAttributeValue("Activity End Date");
	var address = Model.Member.DefaultMemberAddress;
	var phone = Model.Member.DefaultPhone;
    var country = address.Country.ToUpper();
    country = 
      country == "UNITED STATES" ? "USA" :
      country == "CANADA" ? "CAN" : 
      country.IsNull() ? "" : (country+"XXX").Substring(0,3);
  	var zip = address.MailCode;
    zip = zip.IsNull() ? "" : (zip+"00000").Substring(0,5);


}
{
	"TestAdministrationId": "@examCode",
	"PearsonCandidate":   
	{
		"ClientCandidateId": "@clientCandidateId",
		"TestGroup": "NIGP"           
    },
	"PearsonAuthorization":   {
		"TestAdministrationId": "@examCode",
		"StartDate": "@activityStartDate",
		"EndDate": "@activityEndDate",
		"ClientAuthorizationId": "@clientAuthorizationId",
		"AuthorizationCount":  1         
    },
	"FamilyName": "@Model.Member.LastName",
	"GivenName": "@Model.Member.FirstName",
	"Address":   
	{
		"AddressLine1": "@address.Street1",
		"AddressLine2": "@address.Street2",
		"AddressLine3": "@address.Street3",
		"City":   "@address.City",
		"State":   "@address.State",
		"Zip":   "@zip",
		"ZipExtension":  null,
		"Country":   "@country"              
    },
	"Phone":   
	{
		"Number":   "@phone",
		"CountryCode":   "1"      
    },
	"Email":   
	{
		"Address":   "@Model.Member.Email",
		"EmailType":   "Work"       
    },
    "object": 
	{
        "identifier": "@clientAuthorizationId",
        "objectType": "LearningBuilderXApiMessage",
        "xApiHandler": "Prolydian",
        "activityInstanceId": "@Model.Instance.WriteToItemId",
        "ownerId": "@Model.Instance.OwnerId"
    } 
}

8. Include these behaviors on the action on the Exam Workflow that is trigger when the eligklbity should be sent:

Image Added

See