SAP Knowledge Base Article - Public

2154023 - Standard AICC_DATA Values - Learning Management System

Symptom

An AICC post is composed of a series of name/value pairs (see the AICC Communication Parameters page attached). The AICC_Data parameter is the name/value pair that contains the specific data being sent from the content to the LMS. The AICC_Data parameter is also composed of name/value pairs which define the information being sent (see the table below). The AICC_Data value is url-encoded.

Environment

Learning Management System

Resolution

 

Group
Parameters
Description

[Core]
(required)

Lesson_status Used for passing module status to LMS
Lesson_location Used to store bookmarking data
Score Score (one per content object)
Time HHHH:MM:SS.SS (accumulative value- adds to previous time in the SuccessFactors LMS)
[Objectives_Status]
J_ID.1 Objective Identifier (must match Objective Name in SuccessFactors LMS)
J_Score.1 Score for the objective
J_Status.1 Objective Completion Status
[Core_Lesson]
Data is undefined and may be unique to each lesson Open-ended element used to store content specific data

NOTE: A carriage return and line feed must be included after each name/value pair and group tag (i.e. [core]).

 

Usage Rules

  • The AICC_Data value is URL-encoded.
  • The Name/value pairs can appear in any order.
  • If an optional value is to be omitted, the name must also be omitted.
  • The name of each parameter is not case sensitive.
  • The [core] group and all of its parameters are required.

 

Example:
[core]
lesson_location=end
lesson_status=pass
score=87
time=00:23:15

[core_lesson]
This is sample text for the core_lesson parameter


URL-encoded, the string would look like this:
[core]%0D%0Alesson_location%3Dend%0D%0Alesson_status%3Dpass%0D%0Ascore%3D87%0D%0Atime%3D00:23:15%0D%0A[core_lesson]%0D%0AThis%20is%20sample%20text%20for%20the%20core_lesson%20parameter

 

The full AICC post would look like this:
https://icontentlearning.plateau.com/learning/PwsAicc?command=putparam&version=2.2&session_id=C1232241M1568S&aicc_data=[core]%0D%0Alesson_location%3Dend%0D%0Alesson_status%3Dpass%0D%0Ascore%3D87%0D%0Atime%3D00:23:15%0D%0A[core_lesson]%0D%0AThis%20is%20sample%20text%20for%20the%20core_lesson%20parameter

 

Tips

  • %0D is the url-encoded value for a carriage return
  • %0A is the url-encoded value for a line feed
  • %3D is the url-encoded value for "="
  • %26 is the url-encoded value for "&"
  • %20 is the url-encoded value for a space

 


[CORE] Group

Edit section

The Core group contains the main data elements for your content. The Core group and all of its parameters are required when sending an AICC post.

Group
Parameters
Description

[Core]
(required)

Lesson_status Used for passing completion status to LMS
Lesson_location Used to store bookmarking data
Score Score (one per content object)
Time HHHH:MM:SS.SS (accumulative value- adds to previous time in LMS)

Lesson_status
Lesson_Status is used to determine the completion status of the content module. Acceptable values for Lesson_Status are as follows:

  • Passed (or p)
    Necessary number of objectives in the lesson were mastered, or the necessary score was achieved. Student is considered to have completed the lesson and passed.
  • Completed (or c)
    The lesson may or may not be passed, but all the elements in the lesson were experienced by the student. The student is considered to have completed the lesson.
  • Failed (or f)
    The lesson was not passed. All the lesson elements may or may not have been completed by the student.
  • Incomplete (or i)
    The lesson was begun but not finished.
  • Not attempted (or n or na)
    This is the initial lesson_status value set by the LMS. Not attempted means that the student did not even begin the lesson.

 

The SuccessFactors LMS interprets the values as follows:

AICC Lesson_Status
SuccessFactors Finished
(Viewed but not mastered all the material)
SuccessFactors Complete
(Earned Credit )
passed
yes
yes
completed
yes
no
failed
yes
no
incomplete
no
no
not attempted
no
no

Each Lesson_Status value may be followed by one of the following flags:

  • Time_out (or T)
    This indicates the lesson ended because the lesson has determined an excessive amount of time has elapsed.
  • Suspend (or S)
    This indicates the student leaves the lesson with the intent of returning to it later at the point where he/she left off. The LMS will send a resume lesson_status flag the next time the content is launched.
  • Logout (or L)
    This indicates that the student logged out of the LMS from within the lesson instead of returning to the LMS to log out. The intent is to require re-authentication from the student.

 

Rules:

  • Only the first letter of the lesson_status value is processed, so "P", "pass", and "passed" would all be treated the same.
  • The Lesson_Status and Lesson_Status Flag are separated by a comma (for example: P,L).
  • The flag information is not passed back as part of the Getparam response. The only flags possible when passing information back to the content are the ab initio and resume flags. For more information, please refer to the CMI Guidelines for Interoperability document.(attached)

 

Lesson_location
Bookmarking information can be stored using the AICC Lesson_Location value. Each new Lesson_location post overwrites the existing value.
The Lesson_Location field is limited to 255 characters.

 

Score
Indication of the performance of the student during his/her last session in the content object. This score may be determined and calculated in any manner that makes sense to the program designer. For instance, it could reflect the percentage of objectives complete, it could be the raw score on a multiple choice test, or it could indicate the number of correct first responses to the embedded questions in the content object.

The score can be a stand alone value, or may be followed by two values: a maximum and minimum. Where the maximum is the largest score the student could have achieved with the interactions experienced and the minimum is the smallest score that the student could have achieved with the interactions experienced.

Format:
Decimal number or blank for all three values. If three values are passed, they are separated by commas, and the order is significant: Score, Maximum, Minimum

Score Examples:
SCORE= 79
Probably a percentage result.

Score = 8.0,10.0,0.0
Raw score of 8 with a maximum of 10.
The LMS would show a percentage score of 80%.

 


Time
Accumulated time of all the student sessions in the content.

format:
HHHH:MM:SS.SS Integer number representing hours, followed by a colon, an integer from 00 to 59 representing minutes, followed by a colon and a decimal or integer from 00 to 59.99 representing seconds. Three numbers, separated by colons, are always required, even if only seconds or minutes are represented.

Examples:
TIME=00:29:00
Student spent 29 minutes in lesson.

time=01:27:00
Student spent 1 hour 27 minutes in lesson.

 


[Objective_Status] Group

Edit section

The Objectives_Status group allows the content to store information related to the lesson's learning objectives. To link an AICC objective with an LMS objective, create an objective in the SuccessFactors LMS and assign the AICC objective name as the "objective name" field in the LMS (not the auto-generated objective ID value). The newly created objectives can then be assigned to the AICC content object that contains the objectives. The SuccessFactors LMS will then update the objective status using the J_Status and J_Score values passed for that objective.

 

Group
Parameters
Description
[Objectives_Status]
J_ID.1 The lesson-specific objective identifier.
J_Score.1 Score for the objective
J_Status.1 Objective Status

NOTE: The Objectives_Status group can contain multiple objectives differentiated by a unique numeric parameter extension (i.e. J_ID.3 or J_ID.9).

 

J_Score Values
The objective score parameter indicates the score obtained by the student after each attempt to master an objective. A maximum and minimum value may accompany the score. The maximum value indicate the largest score the student could have achieved and the minimum value is the smallest achievable score.

  • A semicolon separates multiple attempts with the latest attempt listed first.
  • Commas separate maximum and minimum values.

 

J_Score Examples:
J_Score.2=87
The student scored an 87 (assumed to be 87%).

J_Score.2=2,3
The student scored 2 out of a maximum possible score of 3.

J_Score.4=9.5,10,0;6.5,10,0
On the student's first attempt, they scored a 6.5 out of a maximum of 10 and a minimum of 0, and on their second attempt, they scored a 9.5 out of a maximum of 10 and a minimum of 0.

 

J_Status Values
The objective status parameter indicates the completion status of the objective. There are four possible statuses:

  • Passed (or p or pass) - The student has mastered the objective.
  • Completed (or c ) - The student has gone through all segments of the lesson related to the objective. She may or may not have passed.
  • Failed (or f ). Failed may be followed by a comma and an integer number indicating the number of times the objective has been failed.
  • Incomplete (or i ) - The student has not gone through all the segments of the lesson related to this objective.

 

Objectives_Status Usage Rules:

  • The Objectives_Status values are URL-encoded and passed as part of the AICC_Data parameter.
  • Objectives_Status data is processed as part of either a "PutParam" or a "PutObjectives" command.
  • The Name/value pairs can appear in any order.
  • If an optional value is to be omitted, the name must also be omitted.
  • The name of each parameter is not case sensitive.

 

Objectives_Status Examples:
[Objectives_Status]
J_ID.1=Obj1
J_Status.1=Passed
J_Score.1=87
J_ID.2=Obj2
J_Status.2=Failed
J_Score.2=33


URL-encoded, the string would look like this:
[Objectives_Status]%0D%0AJ_ID.1%3DObj1%0D%0AJ_Status.1%3DPassed%0D%0AJ_Score.1%3D87%0D%0AJ_ID.2%3DObj2%0D%0AJ_Status.2%3DFailed%0D%0AJ_Score.2%3D33

 

Tips:

  • %0D is the url-encoded value for a carriage return
  • %0A is the url-encoded value for a line feed
  • %3D is the url-encoded value for "="
  • %20 is the url-encoded value for a space

 


[Core_Lesson] Group

The Core_Lesson group is contained in the AICC_Data section of a PutParam command. Core_Lesson contains data that is created by the content and stored by the LMS to be passed back to the content the next time it is run. Typically this data is used to store learner progress data.
Any new Core_Lesson data will overwrite the existing data. Core_Lesson is limited to 4096 bytes.

Keywords

KBA , LOD-SF-LMS-CNT , Content , Problem

Product

SAP SuccessFactors Learning all versions

Attachments

AICCv3.5.pdf