Import or Migrate a Course to Rustici Engine

Rustici Engine is a separately licensable component that provides improved SCORM compliance and integrates with the Analytics dashboards (also separately licensed) in the SaaS PeopleFluent Learning platform. Rustici Engine integration enables LMS users to take advantage of third-party content connectors, such as G01.

Migration of courses to Rustici Engine applies only to SCORM, AICC, and xAPI courses imported via Import Content Package. Online modules that launch exams, launch a file from the repository, or launch a web address cannot be migrated to Rustici Engine. Additionally, Rustici Engine cannot be selected as the launch interface for AICC courses imported via the Import AICC Course Structure feature. The launch interface for these courses is set to Structured Content and cannot be changed.

It is not possible to migrate courses from Rustici Engine back to the native LMS SCORM engine.

If Rustici Engine is enabled for your LMS implementation, course administrators can:

  • Import new course content packages (including CMI5-based courses) into Rustici Engine
  • Migrate existing courses to use the Rustici Engine launch interface.

  • Migrate course revisions to the Rustici Engine for courses originally loaded to the original native LMS SCORM engine.

  • Preview courses that have changed their launch interface to Rustici Engine.

If Rustici Engine is enabled for your LMS implementation, you can:

  • Import new course content packages (including CMI5-based courses) into Rustici Engine
  • Migrate existing courses to use the Rustici Engine launch interface.

  • Migrate course revisions to the Rustici Engine for courses originally loaded to the original native LMS SCORM engine.

  • Preview courses that have changed their launch interface to Rustici Engine.

For more information about the benefits of using Rustici Engine, and each standard, see the Rustici Software website. 

Learners who are In Process on a revision will not have their registration state transferred to Rustici Engine. This means all In Process users will have to start over. Administrators may need to communicate this information or decide when or if to migrate the course.

To load a new revision into Rustici Engine, you must first load the revision into the native player and then change its launch interface in the Catalog Editor or Course CSV Loader. The Rustici Engine option is available only when Rustici Engine is configured in the ekp.properties file. Similarly, if Rustici Engine is not configured, changing the Launch.Interface to 14 (Rustici Engine) via the Course CSV Loader causes the import to fail. 

Once a course revision has been migrated to Rustici Engine, subsequent revisions are automatically loaded to Rustici Engine, so there is no need to update the launch interface for each revision. After migrating a course to Rustici Engine, administrators can preview the course from the Catalog Editor's Preview page. The migration happens the first time a user launches the course, either as a Preview through the Catalog Editor or when an enrolled learner launches the course.

To migrate the latest revision of an existing course to Rustici Engine in the Catalog Editor

  1. Go to Manage Center > Learning > Learning Modules and click the name of the module you want to migrate to Rustici Engine. The Catalog Editor opens at the Define Module Properties page.
  2. Click Define Launch Properties in the Module Properties tab. The Web Launch Interface Specifications page opens.
  3. Select Rustici Engine from the Launch interface drop-down list in the Web Launch Interface Specifications page. 
  4. Click the Save icon to save your changes.

To migrate a course to Rustici Engine using the Course CSV Loader

  • Set the Launch.Interface value to 14.

Importing CMI5 Courses to Rustici Engine

You can import xAPI (or TinCan) based courses that use the CMI5 specification as content packages via the Course CSV Data Loader or the Import Content Package page in the LMS application. The import mechanism for CMI5 content packages differs slightly from xAPI/TinCan packages to accommodate the cmi5.xml manifest file name. For more information about the CMI5 xAPI specification, see https://xapi.com/cmi5/.

Error Message Translation

Rustici Engine exceptions raised by the LMS during launch, preview, or import of Rustici Engine courses are translated to the user's preferred language, based on their profile settings.

The following error messages are translated for import errors:

  • Failed to create Learning Module [CourseId] for Rustici Engine
  • Error in importing course to Rustici Engine [CourseId] 

The following error messages are translated for launch or preview errors:

  • Failed to acquire Engine config properties; these are necessary to work with Engine content. [engineCourseId, transcriptId]
  • Unhandled Exception upon Launch of Engine course [engineCourseId, transcriptId]