cmi5 packages
cmi5 is a modern, xAPI-based content standard used by several authoring tools. A cmi5 package is a .zip file with a cmi5.xml file that describes the Assignable Units (AUs): each AU is a piece of content that the participant opens and completes. Eduvem plays the package and tracks the result of each AU.
Who can upload
Section titled “Who can upload”The same roles that upload SCORM packages: platform administrator, institution administrator and publisher.
Uploading a package
Section titled “Uploading a package”- Export the material from the authoring tool, choosing cmi5 as the publishing standard.
- Check that the
cmi5.xmlfile is at the root of the .zip, not inside a folder. - Under Contents, create a content version and choose the cmi5 type.
- Open the version’s Content tab, select the .zip file and click Upload.
- Publish and create the class as usual.
On the Manage Contents screen, the Type column shows cmi5 for these contents.
What participants see
Section titled “What participants see”- Each AU appears as a page in the classroom, in the order defined by the package.
- Progress is the percentage of satisfied AUs: as the participant opens and completes each AU according to its criterion, progress moves forward.
- The certificate is issued when all AUs are satisfied, as with any other content (see certificates).
- The score reported by the package feeds performance and the reports.
When an AU counts as satisfied
Section titled “When an AU counts as satisfied”Each AU defines its own criterion (moveOn) in cmi5.xml:
| AU criterion | The AU is satisfied when |
|---|---|
| Passed | the participant passes the AU |
| Completed | the participant completes the AU |
| CompletedAndPassed | the participant completes and passes |
| CompletedOrPassed | the participant completes or passes |
| NotApplicable | the AU counts as satisfied as soon as it is opened |
When the AU defines a passing score, passing only counts with a score equal to or above it.
Limits of this version
Section titled “Limits of this version”- AUs that open in their own window (OwnWindow) or that are hosted outside the package (remote AUs) are not supported.
- Plain xAPI/Tin Can packages without a
cmi5.xmlare not supported. - A cmi5 package cannot be uploaded as a language variant of a content.
- There is no administrator preview for these packages, other than the content’s test class.
- Once participants are enrolled, the package cannot be replaced. To fix or update the material, create a new content version.
Upload error messages
Section titled “Upload error messages”These are the messages the product shows, in its own wording.
| Message | What to do |
|---|---|
| cmi5.xml was not found at the root of the cmi5 package. | Re-zip the package with cmi5.xml at the root of the .zip. |
| The package’s cmi5.xml file is not valid and could not be read. | Export the package again from the authoring tool. |
| The cmi5 package does not define any Assignable Unit (AU). | Check that the exported course has at least one AU. |
| A cmi5 AU has an invalid launch address. Eduvem only accepts addresses relative to the package. | Use AUs that point to files inside the package. |
| A cmi5 AU points to a file that is not inside the package. | Add the file to the .zip and upload again. |
| This cmi5 package opens an AU in its own window (OwnWindow), which Eduvem does not support yet. | Export with the AU opening in the same window. |
| The cmi5 package defines two AUs with the same id. | Fix the ids in the authoring tool. |
| A cmi5 AU has a passing score outside the 0 to 1 range. | Adjust the AU’s passing score. |
| cmi5 packages cannot be uploaded as a language translation. | Create a separate content for the other language. |
| The package contains both imsmanifest.xml and cmi5.xml. Upload a SCORM package or a cmi5 package, not both. | Export the package in a single standard. On a SCORM or Coursebox version, the same package is accepted as SCORM. |
| This cmi5 content version already has enrolled participants, so the package cannot be replaced. Create a new content version. | Create a new content version and upload the package there. |
| The package type differs from the one this content version already uses, and it has enrolled participants. Create a new content version. | Create a new content version for the new package type. |