Learning Record Store (LRS) Configuration
When you integrate Percipio with SumTotal, Saba, Degreed, or a custom LMS that supports xAPI, you need to setup LRS configuration. If you are integrating with another LMS using their connectors or using AICC-based communications, you do not need to setup LRS configuration. Proper configuration of the LRS ensures accurate tracking and reporting of learner activities through xAPI statements to your instance of Sumtotal, Saba, Degreed or a custom LMS that uses xAPI.
Before you begin
The LRS configuration involves several critical components that facilitate the seamless transmission of learner data from Percipio to your LRS. Below is a summary of these key items that you should have on hand before you begin:
- Authentication methods: Supports both Basic and OAuth 2.0 authentication.
- Actor ID: Determines whether the actor ID is pulled from the username or email field.
- Course satisfied verb: Specifies the verb to be used for marking course completions.
- Content type filters: Allows selection of which content types to include in the statements sent to the LRS.
- Verb filter: Enables filtering of specific xAPI verbs to be sent.
- Providers to exclude: Option to exclude certain content providers from being included in the LRS statements.
Setup LRS Configuration
To set up the LRS configurtion
- From the left navigation bar, select Site Settings > System Integration > LRS Configuration. The LRS Configuration page displays.
- Select Manage LRS Configuration.
- Input the URL of your LRS without including the endpoint for statements or tokens.
- Choose your authentication method. This information comes from your LRS system:
- Basic Authentication: From your LMS, encode your username and password into a Base64 token and input it in the authorization field.
For example, if the format for the Authentication Token = Base64(client_id:client_secret), and your client_id = testClientId and your secret = secret12345, then you get: =Base64(testClientId:secret12345)
Translating that to Base 64, you get: dGVzdENsaWVudElkOnNlY3JldDEyMzQ1
The value to populate in the Authorization field would be Basic dGVzdENsaWVudElkOnNlY3JldDEyMzQ1 - OAuth 2.0: Enable OAuth 2.0 and input the required endpoint, headers, and parameters as provided by your LRS vendor.
- Basic Authentication: From your LMS, encode your username and password into a Base64 token and input it in the authorization field.
- Select the Actor ID. The Actor ID is what is used to distinguish the learner. You can select:
- Account: pulls the learner's User ID from Percipio.
- Mbox: pulls the learner's email address from Percipio.
- Determine the Verb to use for completions. You have three verbs to specify:
- Course satisfied verb: When a learner completes a course, specify whether Percipio sends the verb Completed or Satisfied to your LRS.
- Assessment scored verb: When a learner completes an assessment, such as a Skill Benchmark, specify whether Percipio sends the verb Completed or Satisfied to your LRS.
- Waived verb: If an admin waives an asset for a learner, specify whether Percipio sends the verb Completed or Satisfied to your LRS.
- Choose which Content types to include in the statements sent to the LRS. The default is to include all content types, but you may select just specific types. For example, many companies choose to exclude individual video files because there are thousands of them, so if you are not loading videos as content into your LMS, you will not want to report on them either, deselect them from the list.
- With the Verb filter, select which xAPI verbs to include in the statements. This is crucial if your LRS supports specific verbs only. Please check with your LMS/LRS vendor for the verbs they support.
- Select Exclude providers if you do not include specific vendor content in your sync, you will not want to include those specific content providers in the LRS statements.
- Ensure all settings are accurate, then check the Enable box to enable the LRS configuration.
- The final step is to Save this configuration. When you save the configuration, Percipio immediately sends a test xAPI statement to your LRS. If the save operation fails, the screen refreshes without your data filled in, contact Support for assistance in troubleshooting.