- 1.0 Overview
- 2.0 References
- 3.0 Definitions
- 4.0 Conformance
- 5.0 Conceptual Model: Informative
- 6.0 LMS Requirements
- 7.0 AU Requirements
- 8.0 Content Launch Mechanisms
- 9.0 xAPI Statement Data Model
- 10.0 xAPI State Data Model
- 11.0 xAPI Agent Profile Data Model
- 12.0 xAPI Activity Profile Data Model
- 13.0 Course Structure Data Requirements
- 14.0 Course Package
- 15.0 Course Structure Examples
Versioning in the cmi5 specification is managed in the following manner:
- Major Version – Stones (Sandstone, Quartz, etc.) – Major changes in functionality
- Minor Version – Editions (1st edition, 2nd edition, etc.) – Minor changes in functionality.
- Errata – Minor corrections that do not affect functionality are not versioned. (See GitHub repository for specific revision history)
The versions of this specifcation are as follows:
Quartz - 1st Edition (June 1, 2016)
Sandstone - 1st Edition (May 15, 2015):
- Developer release
Convert Working Draft to Markdown in GitHub (Feb 20, 2013):
- Converted existing working draft to markdown format from Microsoft Word. All previous work from 2012 discarded.
| Name: | Organization: |
|---|---|
| Ed Cohen | AICC Infrastructure Subcommittee Chair |
| Aaron Silvers | ADL |
| Jonathan Poltrack | ADL |
| Andy Johnson | ADL |
| Tom Creighton | ADL |
| Nik Hruska | ADL |
| Avron Barr | The LETSI Foundation |
| Mike Rustici | Rustici Software |
| Ben Clark | Rustici Software |
| Megan Bowe | Rustici Software |
| Andrew Downes | Rustici Software |
| Brian J. Miller | Rustici Software |
| Jacques Talvard | Airbus |
| Bill McDonald | Boeing |
| Ray Lowery | Pratt & Whitney |
| Dennis Hall | Learning Templates |
| John Kleeman | Questionmark |
| Kris Rockwell | Hybrid Learning Systems |
| Paul Roberts | Questionmark |
| Christopher Reynolds | Pelesys |
| Mingrui Zheng | Pelesys |
| Chris Sawwa | Meridian Knowledge Systems |
| Michael Roberts | VTraining Room |
| Thomas Person | (Formerly of Adobe) |
| Art Werkenthin | RISC,Inc |
| Severin Neumann | die eLearning AG |
| Chris Amyot | ICOM Productions, Inc. |
| David Pesce | Exputo Inc. |
| Henry Ryng | inXsol |
| Chris Handorf | Pearson |
| Jamie Burns | Virtual College |
| Pankaj Agrawal | Next Software Solutions |
This specification describes interoperable runtime communication between Learning Management Systems (LMS) and Assignable Units (AU).
The scope of this specification is limited to the following:
- Launch by an LMS of AUs.
- Launch and runtime environment used by LMS and AUs.
- Runtime communication data and data transport between the LMS and AUs.
- LMS course definition as it pertains to runtime data used by AUs.
- LMS Course Structure Import/Export.
- Reporting requirements for the LMS.
This specification references how to use the xAPI specification within this scope.
Other uses of the xAPI specification are outside of this scope.
Uses of activities not explicitly defined above are outside of the scope of this specification.
The following referenced documents are indispensable for the application of this specification.
- Internationalized Resource Identifiers (IRIs): IRI Syntax January 2005
https://www.ietf.org/rfc/rfc3987.txt - "Experience API", version 1.0.x (subject to change just prior to release), ADL
https://github.com/adlnet/xAPI-Spec/blob/xAPI-1.0.2/xAPI.md - cmi5 Course Structure, Sandstone 1st Edition (merged into this document)
- MIME Types
http://www.iana.org/assignments/media-types/index.html - Extensible Markup Language (XML)
http://www.w3.org/XML - The JSON Data Interchange Format
http://json.org/ - ISO/IEC 21320-1:2015(en) Information technology — Document Container File — Part 1: Core (Commonly called ZIP file format) https://www.iso.org/obp/ui/#iso:std:iso-iec:21320:-1:ed-1:v1:en
For purposes of this specification, the following terms and definitions apply:
-
Administrator: The administrative user who manages the LMS and related systems. This user performs tasks such as learner enrollment, course structure definition, and report management.
-
Activity: In this specification it is representative of an AU or the Object of a statement with objectType of “Activity”. Thus the granularity can be anything from a single AU course down to a specific interaction.
-
Assignable Unit (AU): A learning content presentation launched from an LMS. The AU is the unit of tracking and management. The AU collects data on the learner and sends it to the LMS.
-
Block: A grouping of AU's and other Blocks (nesting).
-
Course: A collection of assignable units, in a logical grouping, of learning content. A course is typically an internal data structure. Courses are often assigned to learners and tracked by the LMS.
-
Course Structure: A list of assignable units and launch parameters, with an implied sequence, representing a course.
-
Experience API (xAPI): A runtime data communication specification for learning content (AU) to send and receive data to a Learning Record Store (LRS). The xAPI specification referenced by this document is used to define the data transport and the data model.
-
Internationalized Resource Identifier (IRI): A unique identifier according to RFC 3987. The IRI may be an IRL. IRLs SHOULD be defined within a domain controlled by the person creating the IRL. Note that IRI’s in this spec MUST be fully qualified and not IRI References.
-
Internationalized Resource Locator (IRL): According to the xAPI specification, an IRL is an IRI that, when translated into a URI (according to the IRI to URI rules), is a URL.
-
Learner: The end user viewing/using the learning content (AUs).
-
Learning Management System (LMS): A computer system that may include the capabilities to register learners, launch learning presentations, analyze and report learner performance, and track learners' progress. LMS launching, reporting, and tracking roles are the focus of the cmi5 specification. The LMS is integrated with an LRS. In the remainder of this document the term “LMS” refers to an integrated entity of LMS and LRS.
-
Learning Records Store (LRS): As defined in the xAPI specification.
-
Registration: An enrollment instance of a learner in a course. (a registration ID uniquely identifies this). The registration ID persists throughout the course progress to completion and during review of a completed course. A new registration is created for new enrollment instances (such as recurrent courses or re-taking courses).
-
Session: A period of time marked by the launch of an AU until its termination (or abandonment).
ADL: Advanced Distributed Learning
AICC: Aviation Industry Computer-Based Training Committee
API: Application Programming Interface
CMI: Computer Managed Instruction
JSON: JavaScript Object Notation
IRI: Internationalized Resource Identifier
IRL: Internationalized Resource Locator
LMS: Learning Management System
LRS: Learning Record Store
PII: Personally Identifiable Information
URI: Uniform Resource Identifier
URL: Uniform Resource Locator
URN: Uniform Resource Name
xAPI: Experience API
XML: Extensible Markup Language
XSD: XML Schema Definition
Conformance to this specification is defined in this section.
In this specification:
- "MUST" is to be interpreted as a requirement on an implementation.
- "MUST NOT" is to be interpreted as a prohibition.
- "SHOULD" is to be interpreted as a recommendation for implementation.
- "SHOULD NOT" is to be interpreted as the converse of "SHOULD".
- "MAY" is to be interpreted as a course of action that is permissible within the limits of the specification.
- "NEED NOT" is to be interpreted as a course of action that is not required.
Uses of the xAPI specification outside of the scope of this specification do not affect conformance with this specification.
See Section 7 – AU Requirements. An Assignable Unit MUST conform to all requirements as specified in the xAPI specification (see References).
See Section 6 – LMS Requirements. The LMS MUST conform to all LRS requirements as specified in the xAPI specification (see References).
The LMS MUST have an account which is able to retrieve all Resource data (from the Statement API, etc, including attachments and extensions) about another distinct user across multiple sessions for that user.
If JSON properties are indicated as "optional", you MAY leave such properties out of the JSON structure being described.
A course MUST be bundled with course structure data that conform to all requirements listed in Section 13 and Section 14.
Course structure data MUST NOT implement any features or functionality (optional or mandatory) described in this specification in a non-conforming manner.
Synopsis of the cmi5 model:
- An LMS imports a course structure which contains at least one AU. Optionally, the course structure may include one or more blocks, which consist of 1 or more AUs or nested blocks.
- An LMS administrative user assigns a course to a learner.
- A learner authenticates with an LMS or a related system.
- A learner launches an AU from the LMS or an associated launching system, using an interface.
- The LMS writes launch data to the integrated LRS.
- The AU sends a message to the LMS requesting launch parameters and previous state information.
- The learner views the AU content and performs the learning. During this time, the AU MAY request data from, and store data to, the LMS.
- The learner exits the AU.
- The AU reports the final tracking data to the LMS and issues a "terminate" statement.
- Administrative users create and view reports of the tracking data recorded by the AUs for individual learners.
Responsibilities of the Assignable Unit:
- Parse the parameters from the launching environment to determine where the LMS location is and initiate communication with the LMS.
- Acting as a "client", send and receive messages using the defined transport mechanism(s) and associated commands as prescribed in this specification.
- Format all data according to the defined data types and vocabularies that are defined in this specification.
- Send a "terminate" statement prior to terminating the AU's execution.
Responsibilities of the LMS:
- Create and maintain course structures.
- Acting as a "server", receive and reply to messages using the defined transport mechanism(s) and associated commands as prescribed in this specification.
- Format all data according to the defined data types and vocabularies that are defined in this specification.
- Launch the specified AU contained in the courses within the defined environment(s).
The LMS MUST:
- Implement an LRS as defined in the xAPI specification.
- Implement additional "State API" requirements to initialize the AU state as defined in Section 10.
- Implement the runtime launch interface as defined in Section 8.0.
- Implement additional xAPI "Statement API" requirements as defined in Section 9.
- Implement additional xAPI "Agent Profile API" requirements as defined in Section 11.
- Implement course handling as defined in Section 6.1.
- The LMS SHOULD implement a means to create, edit, and maintain course structures.
- The LMS MUST implement the import of the Course Structure defined in Section 13 and the Course Package defined in Section 14.
- The LMS SHOULD implement the export of the course data structure defined in Section 13 and the Course Package defined in Section 14.
- The LMS SHOULD provide a user interface to the LMS administrative users to create and edit course structures internally.
- The LMS MUST support course structures containing more than 1000 AUs.
- The LMS MUST support course structures conforming to the XSD schema defined in Section 14.0.
The LMS MUST implement the State API Requirements as defined in Section 10.
The LMS MUST NOT provide permissions/credentials which allow the AU to issue voiding Statements.
The LMS SHOULD reject statements that conflict with the "Statement API" requirements as defined in Section 9.
The LMS MUST Void statements that are NOT rejected AND conflict with the "Statement API" requirements as defined in Section 9.
An AU MUST:
- Implement the runtime launch interface as defined in Section 8.
- Implement runtime communication as defined in the xAPI Specification.
- Implement State API requirements in this specification as defined in Section 10.
- Implement Profile API requirements in this specification as defined in Section 11.
- Implement Statement API requirements as defined in Section 7.1.
The AU MUST issue a statement to the LRS after being launched, initialized, and ready for learner interaction using the Initialized verb as described in Section 9.3.2.
The AU MUST issue a Terminated statement to the LRS as described in Section 9.3.8 as the last statement in a session.
Once the AU has determined that the session will end (e.g. by user action or some other means) the AU SHOULD issue a Terminated statement.
Circumstances under which the AU may determine that the session is ending could include:
- Monitoring for browser window or application close events
- An AU defined user action for closing the AU session
- Other AU defined events such as a timeout from user inactivity
The statements issued within an AU session could fall within the following categories:
- "cmi5 defined" - Statements using cmi5 defined verbs, category id as defined in section 9.6.2.1, and context template.
- "cmi5 allowed" - Statements using any verb and cmi5 context template (but NOT including cmi5 category id as defined in section 9.6.2.1).
- "cmi5 not-allowed" - Any statements not conforming with the cmi5 specification.
"cmi5 allowed" statements posted by the AU MUST occur between cmi5 statements using the "Initialized" verb and the "Terminated" verb. "cmi5 allowed" statements are not considered in cmi5 defined session management and satisfaction rules.
The AU MUST be launched by the LMS using one of the following methods, depending on the launchMethod in the Course Structure (Section 13.1.4 AU Meta Data, URL):
When the launchMethod is "OwnWindow", the LMS MUST use one of the following:
- Spawning a new browser window for the AU.
- Re-directing the existing browser window to the AU.
When the launchMethod is "AnyWindow", the LMS MUST choose the window context of the AU. All browser window options are acceptable - Frameset, New window, browser redirect, etc.
Regardless of the launchMethod the AU MUST be launched by the LMS with a URL having query string launch parameters as defined in this section. The launch parameters MUST be name/value pairs in a query string appended to the URL that launches the AU.
If the AU's URL requires a query string for other purposes, then the names MUST NOT collide with named parameters defined below.
The AU MUST have the ability to process the query string launch parameters in any order.
Each value for the associated names MUST be URL-encoded.
The format of the launching URL is as follows:
<URL to AU>
?endpoint=<URL to LMS Listener>
&fetch=<Fetch URL for the Authorization Token>
&actor=<Actor>
®istration=<Registration ID>
&activityId=<AU activity ID>
Example:
http://www.example.com/LA1/Start.html
?endpoint=http://lrs.example.com/lrslistener/
&fetch=http://lms.example.com/tokenGen.htm?k=2390289x0
&actor={"objectType": "Agent","account":
{"homePage": "http://www.example.com","name": "1625378"}}
®istration=760e3480-ba55-4991-94b0-01820dbd23a2
&activityId=http://www.example.com/LA1/001/intro
(For readability the above example is not URL encoded.)
The values for the URL launch parameters are described below:
| Description: | A URL to the LMS listener location for xAPI requests to be sent to. |
|---|---|
| LMS Usage: | The LMS MUST place the endpoint in the query string. |
| AU Usage: | The AU MUST get the endpoint value from the query string. The AU MUST use the endpoint value as the Base Endpoint for xAPI requests. |
| Data type: | String (URL-encoded) |
| Value space: | A URL-encoded URL |
| Sample value: | https://example.com/my-cmi5-listener/ |
| Description: | The fetch URL is used by the AU to obtain an authorization token created and managed by the LMS. The authorization token is used by the AU being launched. |
|---|---|
| LMS Usage: | The LMS MUST place the fetch in the Launch URL. The fetch URL is a "one-time use" URL and subsequent uses SHOULD generate an error as defined in section 8.2. The authorization token returned by the fetch URL MUST be limited to the duration of a specific user session. |
| AU Usage: | The AU MUST get the fetch value from the query string. The AU MUST make an HTTP POST to the fetch URL to retrieve the authorization token as defined in section 8.2. The AU MUST place the authorization token in the Authorization headers of all HTTP requests made to the endpoint using the xAPI. The AU SHOULD NOT make more than one post to the fetch URL. |
| Data type: | String (URL-encoded) |
| Value space: | A URL-encoded URL |
| Sample value: | http://lms.example.com/tokenGen.htm?k=2390289x0 |
| Description: | A JSON object of objectType "Agent" (as defined in the xAPI specification) that identifies the learner launching the AU so the AU will be able to include it in xAPI requests. |
|---|---|
| LMS Usage: | The LMS MUST populate the actor parameter in the query string based on the authenticated learner's identity conforming to Section 9.2. The LMS SHOULD create this parameter with an object that is specific to the LMS instance that does NOT include sensitive PII of the learner. |
| AU Usage: | The AU MUST get the actor value from the query string. The AU MUST use the actor value in xAPI requests that require an "actor" property. |
| Data type: | String (URL-encoded) |
| Value space: | A JSON object (as defined in Section 9.2) |
| Sample value: | {"objectType": "Agent","account": {"homePage": "http://www.example.com","name": "1625378"}} |
| Description: | A Registration ID corresponding to the learner's enrollment for the AU being launched. |
|---|---|
| LMS Usage: | The LMS MUST place the value for registration in the query string based on the authenticated learner's corresponding enrollment for the Course that the AU being launched is a member of. |
| AU Usage: | The AU MUST get the registration value from the query string. The AU MUST use the registration value in xAPI requests that require a "registration". |
| Data type: | String (URL-encoded) |
| Value space: | UUID (as defined in the xAPI specification) |
| Sample value: |
| Description: | The Activity ID of the AU being launched. |
|---|---|
| LMS Usage: | The LMS MUST generate a unique activityId for the AU. The LMS MUST place its value in the query string. The activityId generated MUST NOT match the AU's id (publisher id) from the course structure (See Section 13.1.4 - AU Metadata). The LMS MUST use the same generated activityId on all subsequent launches (for the same AU) within the same registration. The LMS SHOULD use the same generated activityId (for the same AU) for all registrations. |
| AU Usage: | The AU MUST get the activityId value from the query string. The AU MUST use the activityId value as the id property of the Object in all "cmi5 defined" statements. |
| Data type: | String (URL-encoded) |
| Value space: | IRI |
| Sample value: |
The LMS MUST include the fetch name/value pair in the launch URL. The AU MUST make an HTTP POST to the fetch URL to retrieve an authorization token. Note than an HTTP GET is not allowed in order to prevent caching of the request.
The fetch URL MUST return a JSON structure using a Content-Type of "application/json". The structure MUST be an object with the property "auth-token" in the first successful response. An example JSON structure is shown below:
{
"auth-token": "QWxhZGRpbjpvcGVuIHNlc2FtZQ=="
}The AU MUST place the auth-token in the HTTP header, as defined in RFC 1945 - 11.1 Basic Authentication Scheme, in all subsequent xAPI communications with the LMS. The authorization token returned by the fetch URL MUST be limited to the duration of the session.
The AU SHOULD NOT attempt to retrieve the authorization token more than once. The fetch URL is a "one-time use" URL and subsequent uses SHOULD generate an error (see Section 8.2.3).
| auth-token | |
|---|---|
| Description: | An authorization token used in all xAPI communications with the LMS. |
| LMS Usage: | The LMS MUST place the value for auth-token in a JSON structure, as shown in Section 8.2.1, in its response to a fetch URL request. The response MUST have a Content-Type of "application/json". The HTTP status code MUST be "200" for a valid request (including one that generates error as described in section 8.2.3). |
| AU Usage: | The AU MUST get the auth-token value using an HTTP POST to the fetch URL. The AU MUST then place the authorization token in the Authorization headers of all HTTP requests made to the endpoint using the xAPI. |
| Data type: | String (URL-encoded) |
| Value space: | Defined by the LMS |
| Sample value: | QWxhZGRpbjpvcGVuIHNlc2FtZQ== |
The fetch URL is a "one-time use" URL and MUST NOT return an auth-token more than once. Subsequent requests made to the fetch URL during the session SHOULD generate an error. An example JSON structure is shown below:
{
"error-code": "1",
"error-text": "The authorization token has already been returned."
}The following error-code values are allowed.
| Code | Meaning |
| 1 | Already in Use or Expired - Token has been used before or the AU session has expired |
| 2 | General Security Error - All other security issues including invalid tokens |
| 3 | General Application Error - Application or environment failures |
The values for error-text are defined by the LMS.
Other launch environments are not currently implemented in this specification. cmi5 implementations for LMS's and AU's in these other environments will use the same REST communication interface as specified in xAPI specification. The xAPI specification does not specify launch mechanisms.
The AU MUST assign a statement id property in UUID format (as defined in the xAPI specification) for all statements it issues.
The Actor property MUST be defined by the LMS. The Actor property for all "cmi5 defined" statements MUST be of objectType "Agent". The Actor property MUST contain an "account" IFI as defined in the xAPI specification.
The following xAPI verbs are defined in this specification.
Note that "cmi5 allowed" statements are NOT subject to the usage rules in this section.
All statements in this section refer to "cmi5 defined" statements unless otherwise noted.
AUs MUST use the below verbs that are indicated as mandatory in other sections of this specification.
For all requirements listed below including language involving order, the order is determined by the value of the timestamp property.
AU Verb Ordering Rules within an AU session are as follows:
- Verbs MUST NOT be duplicated (in cmi5 defined statements).
- More than one of the set of {"Passed","Failed"} verbs MUST NOT be used (in cmi5 defined statements).
- The "Initialized" verb MUST be the first statement (cmi5 allowed or defined).
- The "Terminated" verb MUST be the last statement (cmi5 allowed or defined).
AU Verb Ordering Rules within a Registration (per AU) are as follows:
- Exactly zero or one "Completed" cmi5 defined statement MUST be used per registration.
- Exactly zero or one "Passed" cmi5 defined statement MUST be used per registration.
- A "Failed" statement MUST NOT follow a "Passed" statement (in cmi5 defined statements) per registration.
AUs may use additional verbs not listed in this specification.
The LMS MUST record and provide reporting for all "cmi5 defined" and "cmi5 allowed" statements that are not being rejected regardless of the verbs used in statements sent by AUs.
LMS verb ordering rules are as follows:
- LMS may issue multiple satisfied statements (in a session).
- LMS SHOULD NOT issue multiple satisfied statements per object (Block or Course) (in a registration).
- LMS MUST NOT issue more than one abandoned statement for a session.
- LMS MUST NOT issue more than one waived statement per session and MUST not issue more than one waived statement per registration per AU.
| Verb | Launched |
|---|---|
| ID | http://adlnet.gov/expapi/verbs/launched |
| Description | The verb "Launched" indicates that the AU was launched by the LMS. |
| AU Obligations | None |
| LMS Obligations | The LMS MUST use this verb in a statement recorded in the LRS before launching an AU. (See Statement API, Section 10) The LMS MUST NOT issue multiple statements with "Launched" for the same AU within a given AU session. |
| Usage | A "Launched" statement is used to indicate that the LMS has launched the AU. |
| Verb | Initialized |
|---|---|
| ID | http://adlnet.gov/expapi/verbs/initialized |
| Description | An "Initialized" statement is used by the AU to indicate that it has been fully initialized. The "Initialized" statement MUST follow, within a reasonable period of time, the "Launched" statement created by the LMS. |
| AU Obligations | The AU MUST use "Initialized" in the first statement (of any kind) in the AU session. The AU MUST NOT issue multiple statements with "Initialized" for the same AU within a given AU session. |
| LMS Obligations | None |
| Usage | An "Initialized" statement is used by the AU to indicate that it has been fully initialized. |
| Verb | Completed |
|---|---|
| ID | http://adlnet.gov/expapi/verbs/completed |
| Description | The verb "Completed" indicates the learner viewed or did all of the relevant activities in an AU presentation. The use of the Completed verb indicates progress of 100%. |
| AU Obligations | The AU MUST send a statement containing the "Completed" verb when the learner has experienced all relevant material in an AU. The AU MUST NOT issue multiple statements with "Completed" for the same AU within a given course registration for a given learner. |
| LMS Obligations | The LMS MUST use "Completed" statements based on the "moveOn" criteria for the AU as provided in the LMS Launch Data. (See xAPI State Data Model, Section 10.0 - moveOn). |
| Usage | The criterion for "Completed" is determined by the course designer. |
| Verb | Passed |
|---|---|
| ID | http://adlnet.gov/expapi/verbs/passed |
| Description | The learner attempted and succeeded in a judged activity in the AU. |
| AU Obligations | The AU MUST send a statement containing the "Passed" verb when the learner has attempted and passed the AU. If the "Passed" statement contains a (scaled) score, the (scaled) score MUST be equal to or greater than the "masteryScore" indicated in the LMS Launch Data. (See xAPI State Data Model, Section 10.0 - masteryScore). The AU MUST NOT issue multiple statements with "Passed" for the same AU within a given course registration for a given learner. |
| LMS Obligations | The LMS MUST use "Passed" statements based on the "moveOn" criteria for the AU as provided in the LMS Launch Data. (See xAPI State Data Model, Section 10.0 - moveOn). |
| Usage | The criterion for "Passed" is determined by the course designer. |
| Verb | Failed |
|---|---|
| ID | http://adlnet.gov/expapi/verbs/failed |
| Description | The learner attempted and failed in a judged activity in the AU. |
| AU Obligations | The AU MUST send a statement containing the "Failed" verb when the learner has attempted and failed the AU. If the "Failed" statement contains a (scaled) score, the (scaled) score MUST be less than the "masteryScore" indicated in the LMS Launch Data. (See xAPI State Data Model, Section 10.0 - masteryScore). |
| LMS Obligations | None. |
| Usage | The criterion for "Failed" is determined by the course designer. |
| Verb | Abandoned |
|---|---|
| ID | https://w3id.org/xapi/adl/verbs/abandoned |
| Description | The verb "Abandoned" indicates that the AU session was abnormally terminated by a learner's action (or due to a system failure). |
| AU Obligations | None |
| LMS Obligations | In the absence of a "Terminated" statement, the LMS MUST make the determination if an AU abnormally terminated a session by monitoring new statement or state API requests made for the same learner/course registration for a different AU. The LMS MUST record an "Abandoned" statement on behalf of the AU indicating an abnormal session termination. The LMS MUST NOT allow any statements to be recorded for a session after recording an "Abandoned" statement. |
| Usage | See LMS obligations. |
| Verb | Waived |
|---|---|
| ID | https://w3id.org/xapi/adl/verbs/waived |
| Description | The verb "Waived" indicates that the LMS has determined that the AU requirements were met by means other than satisfying the AU. |
| AU Obligations | None |
| LMS Obligations | The LMS MUST use this verb in a statement recorded in the LRS when it determines that the AU may be waived. A statement containing a "Waived" verb MUST include a "reason" in the extension property of the Statement Result. (See Section 9.5.5.2) The LMS MUST generate a unique session id for the statement containing a "Waived" verb and MUST NOT issue any other statements (except for statements with the "Satisfied" verb) using that session id. The LMS MUST NOT issue multiple statements with "Waived" for the same AU within a course registration. |
| Usage | A "Waived" statement is used by the LMS to indicate that the AU may be skipped by the learner. |
| Verb | Terminated |
|---|---|
| ID | http://adlnet.gov/expapi/verbs/terminated |
| Description | The verb "Terminated" indicates that the AU was terminated by the Learner and that the AU will not be sending any more statements for the launch session. |
| AU Obligations | The AU MUST send a statement containing the "Terminated" verb. This statement MUST be the last statement (of any kind) sent by the AU in a session. |
| LMS Obligations | The LMS MUST use the "Terminated" statement to determine that the AU session has ended. Upon receiving a "Terminated" statement, the LMS MUST wait a specified period of time (defined by the LMS implementation) after which it MUST reject statements (of any kind) for the AU session. |
| Usage | See obligations. |
| Verb | Satisfied |
|---|---|
| ID | https://w3id.org/xapi/adl/verbs/satisfied |
| Description | The verb "Satisfied" indicates that the LMS has determined that the Learner has met the moveOn criteria of all AU's in a block or has met the moveOn criteria for all AU's in the course. |
| AU Obligations | None |
| LMS Obligations |
The LMS MUST use the "Satisfied" statement when the learner has met the moveOn criteria of all AU's in a block. In this statement the LMS MUST use the block object per Section 9.4. The LMS MUST use the same block object for all Satisfied statements that refer to that block.
The LMS MUST also use the "Satisfied" statement when the learner has met the moveOn criteria for all AU's in a course. In this statement the LMS MUST use the course object per Section 9.4. The LMS MUST use the same course object for all Satisfied statements that refer to that course. The LMS MUST use the session id from the AU launch for all "Satisfied" statements triggered as a result of an AU launch session. The LMS MUST generate a unique session id for all "Satisfied" statements triggered outside of an AU launch session. The LMS SHOULD NOT issue multiple statements with "Satisfied" for the same Block or Course within a course registration for a given learner. |
| Usage | See LMS obligations. |
An Object MUST be present, as specified in this section, in all "cmi5 defined" statements.
Except for Statements with the Satisfied verb, the Object in a cmi5 defined statement represents the AU. When the Object is the AU, the value of the Object's "id" property for a given AU MUST match the activityId defined in the launch URL.
In Satisfied statements, the Object represents a Block or Course. (see 9.3.9 - Satisfied)
The LMS MUST generate a unique ID for each block object. The generated block id MUST NOT match the publisher’s ID from the course structure. The LMS block object MUST use "https://w3id.org/xapi/cmi5/activitytype/block" as the value of the "type" property in the Object's Definition.
The LMS MUST generate a unique ID for each course object. The generated course id MUST NOT match the publisher’s ID from the course structure. The LMS course object MUST use "https://w3id.org/xapi/cmi5/activitytype/course" as the value of the "type" property in the Object's Definition.
Result may be present in a statement depending on the cmi5 verb used.
A score is not required to be reported. If a score is reported by an AU, the verb MUST be consistent with "masteryScore" (if defined for the AU in the LMS Launch Data).
The "score" property of the result MAY be set in the following cmi5 defined statements:
- Passed
- Failed
cmi5 defined statements, other than "Passed" or "Failed", MUST NOT include the "score" property.
- scaled
A decimal value between 0 and 1 (inclusive). - raw
An integer value between the "min" and "max" properties (inclusive) of the score object. The AU MUST provide the "min" and "max" values for score when the "raw" value is provided. - min
An integer value indicating the minimum value for the "raw" score property. - max
An integer value indicating the maximum value for the "raw" score property.
The "success" property of the result MUST be set to true for the following cmi5 defined statements:
- Passed
- Waived
The "success" property of the result MUST be set to false for the following cmi5 defined statements:
- Failed
cmi5 defined statements, other than "Passed", "Waived" or "Failed", MUST NOT include the "success" property.
The "completion" property of the result MUST be set to true for the following cmi5 defined statements:
- Completed
- Waived
cmi5 defined statements, other than "Completed" or "Waived", MUST NOT include the "completion" property.
The "duration" property is an ISO 8601 formatted time value required in certain statements as defined in this section. Other cmi5 defined statements MAY include the duration property.
The AU MUST include the "duration" property in "Terminated" statements. The AU SHOULD calculate duration for Terminated statements as the time difference between the "Initialized" statement and the "Terminated" statement. The AU may use other methods to calculate the duration based on criteria determined by the AU.
The AU MUST include the "duration" property in "Completed" statements. The AU SHOULD calculate duration as the time spent by the learner to achieve completion status.
The AU MUST include the "duration" property in "Passed" statements. The AU SHOULD calculate duration as the time spent by the learner to attempt and succeed in a judged activity of the AU.
The AU MUST include the "duration" property in "Failed" statements. The AU SHOULD calculate duration as the time spent by the learner to attempt and fail in a judged activity of the AU.
The duration property MUST be included in "Abandoned" statements. The LMS SHOULD use LMS specific methods (if available) to determine the duration if it has more accurate means of session time calculation than time stamp differences between statements. In the absence of such methods, the duration property MUST be set as the total session time, calculated as the time between the "Launched" statement and the last statement (of any kind) issued by the AU.
| ID: | https://w3id.org/xapi/cmi5/result/extensions/progress |
|---|---|
| Description: | An integer value between 0 and 100 (inclusive) indicating the completion of the AU as a percentage. |
| LMS Usage: | None |
| AU Usage: | The AU may set this value in statements to indicate level of completion. The AU SHOULD NOT set a progress value in a Completed statement or if it has previously issued a Completed statement for the AU in the current registration. |
| AU Obligation: | Optional |
| LMS Obligation: | None |
| Data type: | Integer |
| Value space: | 0 to 100 (inclusive) |
| ID: | https://w3id.org/xapi/cmi5/result/extensions/reason |
|---|---|
| Description: | Indicates the reason why an AU was "waived" (marked complete by an alternative means) |
| LMS Usage: | The LMS MUST set this value in statements it makes with the verb "Waived". The value SHOULD be one of the following -
|
| AU Usage: | The AU may retrieve this value from the LRS and use it to change presentation behavior based on the "reason". |
| AU Obligation: | Optional |
| LMS Obligation: | This is a required extension for LMS statements that include the Waived verb. |
| Data type: | String |
| Value space: | Any string value |
| Sample value: | Tested Out |
All cmi5 defined statements MUST contain a context that includes all properties as defined in this section. Either the LMS or the AU MAY provide additional properties.
The value for the registration property used in the context object MUST be the value provided by the LMS. The LMS MUST generate this value and pass it to the AU via the launch URL. The LMS MUST evaluate MoveOn criteria in the course structure at the time of registration. For example, AUs with MoveOn criteria of "Not Applicable" in the course structure would be evaluated and could generate Satisfied statements at this time.
The purpose of this property is to facilitate searches of the LRS by the LMS or other reporting systems. The "contextActivities" property contains list(s) of Activity objects whose ids can be used as a statement list filter. All cmi5 defined statements MUST include all properties and values defined in the contextActivities of the context template (see section 10 - xAPI State Data Model).
An Activity object with an "id" of "https://w3id.org/xapi/cmi5/context/categories/cmi5" in the "category" context activities list MUST be used in cmi5 defined statements as described in section 7.1.3.
cmi5 defined statements with a Result object (Section 9.5) that include either "success" or "completion" properties MUST have an Activity object with an "id" of "https://w3id.org/xapi/cmi5/context/categories/moveon" in the "category" context activities list. Other statements MUST NOT include this Activity.
Used to identify statements about the AU using the publisher's id from the course structure.
The LMS MUST include an Activity object with an "id" property whose value is the unaltered value of the AU's "id" attribute from the course structure (See Section 13.1.4 AU Metadata – id) in the "grouping" context activities list in the "contextTemplate" as described in the State API (See Section 10) prior to launching an AU. The LMS MUST include the publisher id Activity in the "grouping" context activities list for all "cmi5 defined" and "cmi5 allowed" statements it makes directly in the LRS.
The following are extensions specified for cmi5. Statements MUST NOT include extensions that conflict with or duplicate the ones specified here. Statements MAY include extensions not specified here.
| ID: | https://w3id.org/xapi/cmi5/context/extensions/sessionid |
|---|---|
| Description: | A unique identifier for a single AU launch session based on actor and course registration |
| LMS Usage: | The value for session ID MUST be generated by the LMS. The LMS MUST record the session ID in the State API (See Section 10) prior to launching an AU. The LMS MUST provide the session ID in the context as an extension for all "cmi5 defined" and "cmi5 allowed" statements it makes directly in the LRS. |
| AU Usage: | An AU MUST include the session ID provided by the LMS in the context as an extension for all "cmi5 defined" and "cmi5 allowed" statements it makes directly in the LRS. |
| AU Obligation: | Required |
| LMS Obligation: | Required |
| Data type: | String (URL-encoded) |
| Value space: | string value |
| Sample value: |
| ID: | https://w3id.org/xapi/cmi5/context/extensions/masteryscore |
|---|---|
| Description: | "masteryScore" as provided in the LMS Launch Data for the AU plus registration used to determine the pass/fail result based on score |
| LMS Usage: | The LMS MUST add masteryScore to the context of a "Launched" statement when it is provided in the LMS launch data. |
| AU Usage: | An AU MUST include the "masteryScore" value provided by the LMS in the context as an extension for "passed"/"failed" Statements it makes based on the "masteryScore". |
| AU Obligation: | Required, when present and evaluated |
| LMS Obligation: | Required, when in launch data |
| Data type: | decimal |
| Value space: | Decimal value between 0 and 1 (inclusive) with up to 4 decimal places of precision |
| Sample value: | 0.92 |
| ID: | https://w3id.org/xapi/cmi5/context/extensions/launchmode |
|---|---|
| Description: | Indicates what launch mode an AU was launched with by the LMS |
| LMS Usage: | The LMS MUST add launchMode to the context of a "Launched" statement. |
| AU Usage: | Not Applicable |
| AU Obligation: | None |
| LMS Obligation: | Required |
| Data type: | string |
| Value space: | Per launchMode vocabulary defined in section 10.0 xAPI State Data Model |
| Sample value: | "Normal" |
| ID: | https://w3id.org/xapi/cmi5/context/extensions/launchurl |
|---|---|
| Description: | The URL used by the LMS to launch the AU |
| LMS Usage: | The LMS MUST put a fully qualified URL equivalent to the one that the LMS used to launch the AU without the name/value pairs included as defined in section 8.1 in the context extensions of the "Launched" statement. |
| AU Usage: | Not Applicable |
| AU Obligation: | None |
| LMS Obligation: | Required |
| Data type: | string |
| Value space: | URL |
| Sample value: | http://www.example.com/LA1/Start.html |
This section is no longer applicable. See section 9.6.2.3 Publisher ID Grouping Activity.
| ID: | https://w3id.org/xapi/cmi5/context/extensions/moveon |
|---|---|
| Description: | "moveOn" as provided in the LMS Launch Data for the AU plus registration |
| LMS Usage: | The LMS MUST add moveOn to the context of a "Launched" statement. |
| AU Usage: | Not Applicable |
| AU Obligation: | None |
| LMS Obligation: | Required |
| Data type: | string |
| Value space: | Per moveOn vocabulary defined in section 10.0 xAPI State Data Model |
| Sample value: | "Passed" |
| ID: | https://w3id.org/xapi/cmi5/context/extensions/launchparameters |
|---|---|
| Description: | "launchParameters" as provided in the LMS Launch Data for the AU plus registration |
| LMS Usage: | The LMS MUST add launchParameters to the context of a "Launched" statement when it is provided in the LMS launch data. |
| AU Usage: | Not Applicable |
| AU Obligation: | None |
| LMS Obligation: | Required, when in launch data |
| Data type: | String |
| Value space: | Any string value |
All statements MUST include a timestamp property per the xAPI specification to ensure statement ordering requirements are met. All timestamps MUST be recorded in UTC time. Timestamps are not required to be unique in statements within a session. The time recorded SHOULD indicate when the condition actually occurred.
Prior to launching an AU, the LMS MUST create or update a document in the State API record in the LRS. This MUST be a JSON document, as defined in this section.
State API PUT Properties:
- activityId: Activity id for the AU. This MUST match the activity id used by the LMS at AU launch time.
- agent: Agent representing the LMS learner being enrolled. This MUST match the actor property used by the LMS at AU launch time.
- registration: Registration id representing the LMS learner enrollment in the course. This MUST match the registration used by the LMS at AU launch time.
- stateId: LMS.LaunchData
The properties for the "LMS.LaunchData" document are described below.
| Description: | Context template for the AU being launched. |
|---|---|
| LMS Required: | Yes |
| AU Required: | Yes |
| LMS Usage: | The LMS MUST include a "contextTemplate" object and MUST include the following values:
|
| AU Usage: | The AU MUST get the "contextTemplate" value from the "LMS.LaunchData" State document. The AU MUST NOT modify or delete the "LMS.LaunchData" State document. The AU MUST use the contextTemplate as a template for the "context" property in all xAPI statements it sends to the LMS. While the AU may include additional values in the Context object of such statements, it MUST NOT overwrite any values provided in the contextTemplate. NOTE: this will include the session id specified by the LMS. |
| Data Type: | JSON Context object as defined in xAPI specification. |
| Description: | The launch mode determined by the LMS. There are three possible values:
|
|---|---|
| LMS Required: | Yes |
| AU Required: | Yes |
| LMS Usage: | The LMS MUST include a value for launchMode. |
| AU Usage: | The AU MUST conform to the following based on the value of launchMode
|
| Data Type: | String |
| Value Space: | "Normal", "Browse", or "Review" |
| Sample Value: | "Normal" |
| Description: | The launchParameters defined in the cmi5 Course Structure. |
|---|---|
| LMS Required: | The LMS MUST include the launchParameters in the State API document if the launchParameters were defined by the course designer in the Course Structure. |
| AU Required: | No |
| LMS Usage: | The launchParameters value written in the State API Document MAY be different than the one in the course structure (e.g. based on content vendor options that may be used by the LMS admin users). |
| AU Usage: | The AU SHOULD get the launchParameters value from the State API document if the launch parameters were defined in the Course Structure. |
| Data Type: | String |
| Value Space: | Any string value |
| Description: | The masteryScore from the cmi5 Course Structure. |
|---|---|
| LMS Required: | The LMS MUST include a "masteryScore" in the State API document if the masteryScore was defined by the course designer in the Course Structure. |
| AU Required: | If the masteryScore is provided. |
| LMS Usage: | The masteryScore value written in the State API Document MAY be different than the one in the course structure (e.g. based on administrative rules defined by the LMS). |
| AU Usage: | If the AU issues "Passed" or "Failed" statements they MUST be based on the masteryScore if provided. (See Sections 9.3.4 and 9.3.5) |
| Data Type: | decimal |
| Value Space: | Decimal value between 0 and 1 (inclusive) with up to 4 decimal places of precision. |
| Sample Value: | 0.75 |
| Description: | The moveOn value from the cmi5 Course Structure. |
|---|---|
| LMS Required: | Yes |
| AU Required: | No |
| LMS Usage: | The LMS MUST provide a moveOn value in the state API document. The moveOn value written in the State API Document MAY be different than the one in the course structure (e.g. based on administrative rules defined by the LMS). |
| AU Usage: | The AU MAY get the moveOn value from the "LMS.LaunchData" state document and MAY use the value to modify its behavior. |
| Data Type: | string |
| Value Space: | moveOn values as defined in the Course Structure (Section 13.1.4 – AU Metadata) |
| Sample Value: | "Passed" |
| Description: | Used by the LMS when launching the AU if the LMS requires the AU (in a web-browser environment) to redirect the learner when he or she exits the AU. |
|---|---|
| LMS Required: | No |
| AU Required: | If the returnURL is provided. |
| LMS Usage: | The LMS MAY include the returnURL when the learner SHOULD be redirected to the returnURL on exiting the AU. |
| AU Usage: | The AU MUST attempt to get the returnURL value from the "LMS.LaunchData" state document. The AU MUST redirect the current browser window or frame to the returnURL when the AU is terminated if the returnURL is provided. |
| Data Type: | String (Not URL encoded) |
| Value Space: | Any URL. |
| Sample Value: | http://www.example.com/lms/mod/xapilaunch/view.php?id=12 |
| Description: | The entitlementKey object is used by the AU to determine if the launching LMS is entitled to use the AU. |
|---|---|
| LMS Required: | Yes |
| AU Required: | No |
| LMS Usage: | The LMS MUST add an entitlementKey object to the "LMS.LaunchData" state document if an entitlementKey is present in the Course Structure for the AU. The entitlementKey consists of 2 properties, “courseStructure” and “alternate”. See items below for LMS usage requirements. |
| AU Usage: | The AU SHOULD use this data in combination with other data provided from the LMS to determine entitlement. |
| Data Type: | JSON Object |
| Value Space: | The value for entitlementKey properties are defined by the AU provider. |
| Sample Value: | {"courseStructure": "xyz-123-9999", "alternate": "abc-456-1111"} |
| Description: | The courseStructure property contains the value for entitlementKey from the Course Structure. The courseStructure values MAY be used by the AU to determine if the launching LMS is entitled to use the AU. |
|---|---|
| LMS Required: | Yes |
| AU Required: | No |
| LMS Usage: | The LMS MUST obtain this from the Course Structure. |
| AU Usage: | The AU SHOULD use this data in combination with other data provided from the LMS to determine entitlement. |
| Data Type: | string |
| Value Space: | The value is defined by the AU provider. |
| Sample Value: | "xyz-123-9999" |
| Description: | The alternate property is data from some other source as agreed upon between the LMS and the AU. The alternate property values MAY be used by the AU to determine if the launching LMS is entitled to use the AU. |
|---|---|
| LMS Required: | No |
| AU Required: | No |
| LMS Usage: | The LMS MUST obtain the value for the alternate property from a source as agreed upon with the AU. |
| AU Usage: | The AU SHOULD use this data in combination with other data provided from the LMS to determine entitlement. |
| Data Type: | string |
| Value Space: | The value is defined by the AU provider. |
| Sample Value: | "xyz-123-9999" |
In cmi5, Learner Preferences are scoped to the Agent representing the enrolled LMS learner. The Agent used in xAPI Agent Profile requests MUST match the actor property generated by the LMS at AU launch time. Both the LMS and the AU MAY write changes to Learner Preferences in the xAPI Agent Profile. The LMS/LRS MAY choose to ignore or override Learner Preference changes requested by the AU by returning a "403 Forbidden" response as defined in the xAPI specification (Section 7.6). The AU MUST NOT treat the 403 response as an error condition.
The AU MUST retrieve the Learner Preferences document from the Agent Profile on startup.
When reading or writing to the Agent Profile, the document name MUST be "cmi5LearnerPreferences". The document content MUST be a JSON object with the "languagePreference" and "audioPreference" properties as described in Section 11.1 and 11.2. For example:
{
"languagePreference": "<values for languages>",
"audioPreference": "<on or off>"
}The languagePreference MUST be a comma-separated list of RFC 5646 Language Tags as indicated in the xAPI specification (Section 5.2). In the list, languages MUST be specified in order of user preference. In the example below, the user's first preference for language is en-US. The user's second preference for language is fr-FR and the third preference is fr-BE.
{
"languagePreference": "en-US,fr-FR,fr-BE",
...
}If the AU supports multiple languages, the AU SHOULD display in the language preference order of the user as in the example above. If the AU supported "zh-CN", "fr-BE" and "fr-FR", it SHOULD display in "fr-FR". If the AU does not support multiple languages, or if no languagePreference is specified in the Agent Profile, it may display in its default language.
The audioPreference value indicates whether the audio SHOULD be "on" or "off". The AU MUST turn the audio on or off at startup based on this value. If no value is provided in the Agent Profile for audioPreference the AU MAY use its own default value.
Example:
{
"audioPreference": "on",
...
}The AU MAY use the Activity Profile API according to the xAPI specification (Section 7.5 - Activity Profile API).
All leading/trailing whitespace MUST be removed by the LMS on import of the course structure for all of the data elements defined in this section.
The following Data Types are used in the cmi5 course structure data model, see the CourseStructure.xsd (Section 14.0) for specific format:
- decimal – XSD definition: "xs:decimal"
- IRI – XSD definition: "xs:anyURI"
- string – XSD definition: "xs:string"
- langstring – XSD definition : <xs:element name="langstring" maxOccurs="unbounded" minOccurs="1"/>
- objectiveReference – XSD definition : <xs:element name="objectives" type="referencesObjectivesType" minOccurs="0"/>
The following metadata attributes and elements are at the course level and describe the course instance as a whole.
Required: Yes |
Description: Value space: |
Required:
Yes |
Description: Value space: Sample value: |
Required: Yes |
Description: Value space: Sample value: |
The data in this section are used for the block structures which group AUs. A Block consists of one or more AUs. Blocks can also contain references to objectives and other Blocks.
Required: Yes |
Description: A globally unique IRI to identify the Block in xAPI requests made by the LMS. This id MUST be unique within the course structure. Value space: Values defined by course designer Sample value: |
Required: Yes |
Description: |
Required:
Yes |
Description: |
Required:
No |
Description: |
The data in this section are used by the Objectives. Objectives can be associated with a Block or with individual AUs.
Required: Yes |
Description: Value space: Sample value: |
Required: Yes |
Description: Value space: Sample value: |
Required: Yes |
Description: Value space: Sample value: |
The data in this section are used by the LMS to locate the AU and provide launch data. AUs may also contain objectives.
Required: Yes |
Description: A globally unique IRI defined by AU publisher that the AU uses to identify itself in xAPI statement contexts. This id MUST be unique within the course structure. Value space: Values are defined by the AU publisher. Sample value: |
Required: No |
Description: Used by the LMS when launching the AU (in a web-browser environment) to determine whether the AU requires its own window, or whether the LMS may choose the window context for the AU. Usage:
Value space: "OwnWindow", "AnyWindow" |
Required: No |
Description: A score used by the LMS to determine passing or failure of judged activity in the AU (if the AU has scoring). Usage:
Value space: Decimal number. |
Required: No |
Description: Used by the LMS to determine if an AU has been sufficiently satisfied for the purposes of determining overall course satisfaction or determining if prerequisites were met for other activities. moveOn Values are as follows:
Usage: If all member AUs in a block are satisfied, then the block is considered satisfied for prerequisites and sequencing. Value space:
Sample value: |
Required: No |
Description: Used by the LMS to determine the activity type of the AU before a first start to indicate this type to the user. Sample value:<au id="…" activityType="http://adlnet.gov/expapi/activities/media"> … </au> |
Required: Yes |
Description: A descriptive title for the AU. Value space: Values are defined by the course designer. Sample value: |
Required:
Yes |
Description:
Value space: Values are defined by the course designer. Sample value: |
Required:
No |
Description:
Value space: Values are defined by the course designer.
Sample value: |
Required: Yes |
Description:
Value space: Values are determined by the course designer. Sample value: |
Required: No |
Description: Value space:
Sample value: |
Required: No |
Description: Value space: Values are defined by the AU content provider. |
Course Designers MAY place their own namespaced elements into the course structure and thus define an extension for the source structure specification. For that they MUST provide a XML Schema Definition and SHOULD provide a human readable specification describing these vendor specific extensions. These extensions MUST keep the course structure XML valid. An importing LMS MAY ignore these elements. Therefore the extension SHOULD be created in such a manner that a course is still useable if the LMS does not support the additional elements.
To achieve a larger distribution of their extension course designers SHOULD choose a free or open source license for their specification and make it publicly available.
Conceptually, a course package is a collection of all of the components (AUs) of the course. While previous standards often equated this with the gathering of all resources into a single archive (often a .ZIP file), cmi5 does not have this restriction; all files can be "packaged", even by reference.
Technically, a course package is an XML file format with a course structure. It can be standalone or contained in a ZIP file. A course package, when located in a ZIP file, MUST be named "cmi5.xml". The course package MUST conform to https://w3id.org/xapi/profiles/cmi5/v1/CourseStructure.xsd. Available locally in v1/CourseStructure.xsd.
An LMS MUST provide functionality such that a targeted course package is processed, resulting in a Course Structure import (See Section 13). An LMS MUST support Course Packages in at least these three file formats:
- Standalone XML file
- 32-bit Zip Format
- 64-bit Zip Format
An LMS MAY support alternate course package formats.
The two ZIP file formats MUST follow the specification defined at https://www.pkware.com/support/zip-app-note. When the ZIP file is used to package a course, it MUST contain the course structure XML file at its root directory and it MAY contain media associated with the course AUs.
- Any media included in a ZIP course package MUST use relative URL references in the Course Structure XML.
- Any media not included in a ZIP course package MUST use fully qualified URL references in the Course Structure XML.
- A ZIP course package MAY contain a mix of fully qualified and relative URLs, provided the rules above are followed.
When a course structure XML file is provided without a ZIP file package, all URL references MUST be fully qualified.
Using the domain of geology the following two examples demonstrate how simple and complex a course designer can structure a course. The titles and descriptions are fetched or translated from the Earth Sciences Portal at Wikipedia (https://en.wikipedia.org/wiki/Portal:Earth_sciences).
Simple single AU course structure is available in v1/examples/simple-cmi5.xml.
Complex course structure with multiple objectives, multiple blocks with nesting, multiple AU blocks, etc. is available in v1/examples/complex-cmi5.xml.
An extended simple course structure example is available in v1/examples/extended-cmi5.xml which uses vendor specific metadata following the XML Schema Definition defined in v1/examples/extended-cmi5.xsd.
Copyright © 2012-2021 Advanced Distributed Learning (ADL) Initiative, U.S. Department of Defense, All rights reserved
Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.