cmi.core.entry

Syntax: LMSGetValue("cmi.core.entry");

Responsibility: The LMS has the sole responsibility for setting the value of cmi.core.entry.

Data: CMIVocabulary: must be either an empty string, "ab-initio" or "resume".

  • ab-initio: This indicates it is the first time the student is entering the SCO. Because the student may have passed all of the objectives in a SCO by completing a pretest, the lesson_status of not attempted is not a reliable indicator. That is, a SCO may be passed without the student having ever seen it.
  • resume: This indicates that the student was in the SCO earlier. The student is resuming a suspended SCO.
  • "": The empty string should be used to represent an entry into the SCO that is neither an initial (ab-initio) nor a continuation from a suspended state (resume). A scenario that this might be used is if the SCO was already completed and then later it was loaded for review purposes. In this case it was neither an initial launch nor a continuation from a suspended state.

Description: The command LMSGetValue("cmi.core.entry") returns one of the above three strings. The value is an indication of whether the student has been in the SCO before. When a student enters a SCO for the first time, the LMS sets this string to "ab-initio". If the student re-enters a suspended SCO then the string is set to "resume". The LMS would set the string to empty (""), if the SCO has been completed.

Example Javascript: The following JavaScript reads the entry status. If the status is "resume" then the student bypasses this page, an initialization page, and goes to the 1st content page.

<script language="javascript">

var currentScoPage = "initialPage.html";
var pageNumber = 0;
LMSInitialize();
var entryValue = LMSGetValue("cmi.core.entry");
if (entryValue = "ab-initio") {
   currentScoPage = scoPage[1];
}else{
   currentScoPage = LMSGetValue("cmi.core.lesson_location");
}
self.location = currentScoPage; // load either the 1st content page or the page last
                                              // visited.

</Script>

BACK