LMS integration using AICC – Brillium Support Community

Exchanging Brillium data with an AICC-compliant Learning Management System is a reliable way to get learners to and from an LMS.

Exchanging Brillium data with an AICC-compliant Learning Management System (LMS) requires each Brillium assessment to be configured to exchange data with the LMS in an AICC-compliant way. A Brillium Workspace must first be configured to use the proper AICC Respondent Fields, and the assessment must have one of the AICC-compliant Integration Methods selected on the Integration tab of Assessment Builder.

Once the Brillium Workspace and assessments are properly configured for AICC integration, the AICC-compliant Learning Management System (LMS) application must be configured to properly connect with the LMS's AICC course linking mechanisms.

This guide provides details and guidelines to properly configure a Workspace and assessments for AICC integration with an LMS. Where possible, suggested guidelines to use when configuring an AICC-compliant LMS application are also specified. For help with a specific LMS application, contact the application vendor.

Configuring Brillium for AICC Integration

Brillium Configuration

The following steps must be performed within a Brillium Workspace.

NOTE: All assessments within a workspace inherit the Respondent Field, Assessment UI, and Default settings. When AICC is configured, all assessments within the Workspace. Create separate Assessment Workspaces for each integration method. AICC requires a set of static Respondent Fields

Create a new Assessment Workspace by selecting Settings→Workspaces and right-clicking the current (top most) Workspace
Enter the workspace by right-clicking the workspace just created and choosing "Enter" from the drop-down menu
Create an assessment

Note: There are no restrictions when creating assessments that use AICC integration. Any Brillium Topic or Question type may be used. The AICC standard does not transmit detailed data that would prevent an Brillium assessment type to work properly.

AICC requires a set of specific pre-defined set Respondent Fields selectable from within Brillium. From any page, select Settings (gear icon)→Respondent Fields. Select AICC Compatible from the pre-defined set dropdown list and confirm the selection. Any Respondent Fields already defined will be lost and replaced with the Predefined Set selection. Save the changes
For each assessment in the Workspace, the Integration settings in Assessment Builder must be specified through the following steps.
1. Select an assessment by clicking on the name or by selecting the Edit (pencil) icon from the ellipsis menu
2. In Assessment Builder, select the Integration tab
3. From the Integration Method drop-down list, select the appropriate AICC method in accordance with your LMS provider implementation, either AICC - Pass/Fail or AICC - Completed/Incomplete.

AICC Compliant LMS or Application Configuration

Method Selection

Most Learning Management Systems (LMS) support two methods of configuring AICC-compliant content. The first and most simple method is via a single URL that links to the content on the Web. The second method is via Course Structure Data Files.

Single URL Format and Structure

Use the following URL format as a guide for linking to the content:

https://mycompany.onlinetests.app/assess.aspx?a=L2&aid=myassessid&apass=mypass

Within the above example, there are several key elements:

mycompany.onlinetests.app represents the DNS domain of your Brillium instance. The first section of the domain, "mycompany", represents the Brillium instance DNS sub-domain.
"myassessid" represents the Assessment ID of the Brillium assessment being linked.
"mypass" represents the Assessment Key of the assessment you are linking to.

Example AICC URL

Below is an example for an assessment ID of "MATH101" that has an Assessment Key of "MYPASS":

https://samplecorp.brillium.com/assess.aspx?a=L2&aid=MATH101&apass=MYPASS

Course Structure Data Files Setup

This method of course setup is more common in enterprise LMS environments and allows greater control.

TIP: More information regarding this type of AICC configuration can be found at the AICC website in the document entitled "CMI Guidelines for Interoperability AICC".

AICC Level 1 complexity, as defined by AICC guidelines, is the simplest level and requires the following four course structure data files:

MyCourse.CRS
MyCourse.AU
MyCourse.DES
MyCourse.CST

Creating Course Structure Files Automatically

Brillium creates course files automatically. View and download the AICC course files with the following steps:

Select Assessments from the main menu.
Select the link icon from the ellipsis menu next to the AICC integrated assessment
Select the course files to download them individually OR download the single combined ZIP file.
Import the course files into your LMS

Screen image of AICC Course Files download links

Creating Course Structure Files Manually

Although Brillium can automatically generate these files for you, following are some examples of each of the required files if you decide to create your own course files.

The following set of course structure file examples represents a course that is composed of two assessments.

Note

Course structure files are not required when using the Single URL method of AICC integration described above.

.CRS File Example (Math101.CRS)

[Course]
Course_Creator=MyCompany
Course_ID=MATH-BASIC
Course_System=Brillium
Course_Title=MATHEMATICS - BASIC SKILLS - 1
Level=1
Max_Fields_CST=4
Total_AUs=2
Total_Blocks=1
Version=2.0

.AU File Example (Math101.AU)

https://mycompany.brillium.com/assess.aspx?a=L2&aid=MATH101&apass=ASSESSMENTKEY

.DES File Example (Math101.DES)

"Mathematics 101 - Addition"

.CST File Example (Math101.CST)

"Root","A001","A002"

AICC Communication Data Returned to the LMS

The following information will be communicated back to the LMS upon the successful completion of the assessment by the respondent.

Respondent’s Session ID
Lesson Location (end)
Score (0-100)
Time (hh:mm:ss)
Lesson Status (pass or fail)

Related to