Reserved variables

Every project has a set of predefined, reserved variables. These variables are read-only; they cannot be modified. Additional variables, some of which are read-only, are available within the project depending upon the type of project you are creating.

See also: Creating an AICC/SCORM project for a LMS

Predefined Variable

Description

Dynamically Updated?

AICC_Student_Language This variable contains either the language of the student's interface in the LMS or the language that the student selected within the content itself. Yes

BrowserType

This variable contains the name of the browser currently used to view the project. The variable is set to Lectora when run in preview mode, and LectoraViewer when run as a published CD title. For projects published to the Web, the variable value contains the browser used to view the project, such as Google Chrome.

No

BT_Score_<object name> For BranchTrack simulations, this variable contains the score of the BranchTrack scenario, where <object name> is the name of the BranchTrack object. If the scenario has not yet been started or the scenario cannot be scored, the value is 0. For details about accessing the BranchTrack editor and adding BranchTrack simulations to project, see Starting BranchTrack and Working with BranchTrack objects. Yes
BT_Path_<object name> For BranchTrack simulations, this variable contains the path (selections) through the BranchTrack scenario, where <object name> is the name of the BranchTrack object. The scenario path is identified as a colon-separated value, such as ":1:2:7:25:". For details about accessing the BranchTrack editor and adding BranchTrack simulations to project, see Starting BranchTrack and Working with BranchTrack objects. Yes

CurrentChapterName

This variable contains the name of the chapter that includes the current page being displayed. If there is no current chapter, then this variable has the value of Unknown.

Yes

CurrentDate

For projects published to the Web, this variable contains today’s date in the form <Day of the Week>, <Month> <Day>, <Year>. For example: Wednesday, March 11, 2008. For projects published to a single-file executable or CD-ROM, this variable contains today’s date in the form <Month> <Day>, <Year>. For example: March 11, 2008.

No

CurrentPageName

This variable contains the name of the current page.

Yes

CurrentView This variable contains the name of the device and orientation currently being used to view the project. This will be one of the following values: Desktop, PhonePortrait, PhoneLandscape, TabletPortrait, and TabletLandscape. Yes

CurrentSectionName

This variable contains the name of the section that includes the current page being displayed. If there is no current section, then this variable has the value of Unknown.

Yes

CurrentTime

This variable contains the current time in the form hh:mm AM/PM. For example, 4:19 PM.

No

CurrentTitleName

This variable contains the name of the project.

Yes

ElapsedTime

This variable contains the amount of time the user has spent within the published project.

No

PageInChapter

This variable contains the current page number relative to the pages within the current chapter.

Yes

PagesInChapter

This variable contains the total number of pages in the current chapter.

Yes

PageInSection

This variable contains the current page number relative to the pages within the current section.

Yes

PagesInSection

This variable contains the total number of pages in the current section.

Yes

PageInTitle

This variable contains the current page number relative to the entire project. If project contains frames, this variable contains the current page relative to the total number of pages within that frame.

Yes

PagesInTitle

This variable contains the total number of pages in the project. If project contains frames, this variable contains the total number of pages within that frame.

Yes

Platform

This variable contains the name of the platform on which the published project is running. For CD-published projects, this could contain Microsoft Windows NT, Microsoft Windows XP, and so on. For projects published to the Web, the variable contains Win32 for 32-bit Windows platforms, and MacPPC for Macintosh PowerPC platforms. Values can also include:

iPad

Win32 (Windows operating system)

iPhone

MacIntel (Mac™ operating system)

Linux (Android™ operating system)

No

PublishDate

This variable contains the date and time that the project was published in the form <Month> <Day>, <Year> hh:mm AM/PM. For example, July 21, 2008 4:20 PM.

No

<test name>_Score

For each test in the project, a variable will be created that will contain the score of the test. If the test has not yet been taken or the test cannot be scored, the value is 0.

No

<test name>_<test section>_Score

For each test section in the project, a variable will be created that will contain the score of the test section. If the test has not yet been taken or the test cannot be scored, the value is 0.

No

Question_####

This variable contains the user's answer to the question. This variable name can be changed within the question's properties.

Yes

RadioGroup_####

This variable contains the user's selection from the radio buttons contained in the group. This variable name can be changed within the radio button group's properties.

Yes

Radio_####

For each radio button (not contained in a radio button group) in the project, a variable will be created that will contain whether the radio button is selected. If selected, the variable will have a value of "on" and otherwise will have no value. This variable name can be changed within the radio button's properties.

Yes

Checkbox_####

For each check box in the project, a variable will be created that will contain whether the check box is selected. If selected, the variable will have a value of "on" and otherwise will have no value. This variable name can be changed within the check box's properties.

Yes

Entry_####

For each entry field in the project, a variable will be created that will contain what the user has typed within the entry field. This variable name can be changed within the entry field's properties.

Yes

DropList_####

For each drop-down in the project, a variable will be created that will contain what the user has selected from the drop-down list. This variable name can be changed within the drop-down list's properties.

Yes

List_####

For each list box in the project, a variable will be created that will contain what the user has selected from the list box. This variable name can be changed within the list box's properties.

Yes

If you have designated project as an AICC/SCORM for LMS project type, the following additional variables are available within project:

Predefined Variable

Description

Modifiable?

AICC_Core_Lesson

This variable contains information used by the published project to properly calculate the score of the user in the published project. If you modify the value of this variable within the content of a project that contains more than one automatically graded test, then the AICC_Score of the student cannot be properly updated and reflected to the AICC/SCORM Learning Management System (LMS).

For all versions of SCORM including SCORM 2004, this variable is typically referred to by your LMS as cmi.suspend_data.

Yes

AICC_Core_Vendor

This variable contains the information required by the program when running an AICC-compliant project within an AICC learning management system. This variable is not used by published content.

No

AICC_Course_ID

This variable contains the id of the course in the AICC/SCORM learning management system.

No

AICC_Credit

This variable reflects whether the AICC/SCORM project is being taken for "credit" or just in a "browse" mode.

No

AICC_Lesson_ID

This variable contains the name of the project's assignable unit.

No

AICC_Lesson_Location

This variable contains the current location within the project content. The published content sets this variable on every page of the project to reflect the current location of the student within the AICC/SCORM LMS.

For all versions of SCORM including SCORM 2004, this variable is typically referred to by your LMS as cmi.location.

Yes

AICC_Lesson_Status

This variable contains the current status of the course within the AICC/SCORM LMS. The program sets the value of this variable to incomplete. The AICC/SCORM LMS will further modify the variable based on the current AICC_Score for the user and the value specified as the Mastery Score.

For SCORM 1.2, use the AICC_Lesson_Status variable which sets the cmi.core.lesson_status for the project. Different LMSs might require special values for this. The typical values are not attempted, incomplete, and completed. The variations are usually only for the completed value; Completed, complete, passed are some variations.

For SCORM 2004, the 3rd Edition, cmi.progress_measure is not used. Instead, the cmi.completion_status varible is set directly. This is done by using the CMI_Completion_Status variable.

Check your LMS standards to verify the correct capitalization of this setting. For more information, visit Using SCORM 1.2 and SCORM 2004 with an LMS in our Community forum.

Yes

AICC_Score

This variable contains the average of all test scores in the published project. If you modify the value of this variable within the content of a course that contains more than one automatically graded test, the modification will be lost when the user completes an automatically graded test.

For SCORM 2004, this variable is typically referred to by your LMS as cmi.score.raw. For all other versions of SCORM, it is typically referred to as cmi.core.score.raw.

Yes

AICC_Student_ID

This variable contains the user id as reported by the AICC/SCORM LMS.

For SCORM 2004, this variable is typically referred to by your LMS as cmi.learner_id. For all other versions of SCORM, it is typically referred to as cmi.core.student_id.

No

AICC_Student_Name

This variable contains the user name as reported by the AICC/SCORM LMS.

For SCORM 2004, this variable is typically referred to by your LMS as cmi.learner_name. For all other versions of SCORM, it is typically referred to as cmi.core.student_name.

No

AICC_Time

This variable contains the total time the user has been in the published project. This value is automatically updated while the student is viewing the project. If you modify the value of this variable, the modification will be lost when the student exits the project. Also, this variable must be in the format of HH:MM:SS:mm to be valid when reported to the AICC LMS.

For SCORM 2004, this variable is typically referred to by your LMS as cmi.total_time. Additionally, cmi.session_time is also automatically set.

Yes

CMI_Core_Entry

This variable is only accessible in SCORM published projects and contains information related to whether the student has previously accessed the published project.

For SCORM 2004 this variable is typically referred to by your LMS as cmi.entry and for all other versions of SCORM it is referred to as cmi.core.entry.

No

CMI_Core_Exit

This variable is only accessible in SCORM-published projects and is used to indicate how or why the student exited the published project.

For SCORM 2004 this variable is typically referred to by your LMS as cmi.exit and for all other versions of SCORM it is referred to as cmi.core.exit cmi.core.exit.

This exit value is automatically set to suspend if an unfinished course is being attempted, otherwise it is left alone. Some LMS vendors require specific values that you can set through this write-only variable. If your LMS vendor requests that the course needs to set this variable, it can be done with a Modify Variable action. For details about configuring the Modify Variable action, see Adding an action.

Yes

CMI_Completion_Status

This variable is only accessible in SCORM 2004 published projects and determines the point at which the student has actually completed viewing the published project. In a SCORM 2004 published course, the author MUST set this variable at the point in the course that the student has been determined to have completed viewing the necessary content for the course.

Lectora supports SCORM 2004 3rd Edition. The value must be one of these four tokens: “completed”, “incomplete”, “not attempted”, or “unknown”. The hosting LMS might require different values if it does not conform to the same specification.

  This variable is typically referred to by your LMS as cmi.completion_status.

Yes

If the project is being created for placement on the CourseMill 2.0 learning management system, the following additional variables are available:

Predefined Variables

Description

Modifiable?

CM_Course_ID

This variable contains the ID of the course as defined in CourseMill.

No

CM_Course_Name

This variable contains the name of the project as defined in CourseMill

No

CM_Student_ID

This variable contains the student ID as reported by CourseMill.

No

CM_Student_Name

This variable contains the student name as reported by CourseMill.

No

Knowledge Base | Training | Support
© Copyright ELB Learning 2023