Rustici Information

Rustici Information

This is an excerpt from the Course Administration Guide version 22.7 pages 217 and 276. 

About 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.

  1. If Rustici Engine is enabled for your LMS implementation, course administrators can:
  2. Import new course content packages (including CMI5-based courses) into Rustici Engine
  3. Migrate existing courses to use the Rustici Engine launch interface.
  4. Migrate course revisions to the Rustici Engine for courses originally loaded to the original native LMS SCORM engine.
  5. Preview courses that have changed their launch interface to Rustici Engine.

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.


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:

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

Migrate a Course to Rustici Engine

Course administrators can migrate courses that use the native LMS SCORM engine to Rustici Engine. Only

SCORM, AICC and xAPI courses imported via the Import Content Package page can be migrated. It is not

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


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. For

more information, see About Importing Courses.


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 InterfaceSpecifications  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.


Once a course has been configured for Rustici, the following settings are available.


Launch Settings:
PlayerLaunchType - Specifies how the individual parts of the course should be launched.


PlayerScoLaunchType - Specifies how the player as a whole should be launched for this course.


Navigation Settings:
Player Show Finish Button - Specifies whether the interface should show a button that allows the learner to return to the LMS
Player Show Nav Bar - Specifies whether the interface should show the navigation bar containing buttons like Prev, Next, Exit, etc

Compatibility Settings:
Player Wrap SCO Window with API - When a SCO is launched in a new window, this specifies whether the window should be wrapped with a shell window containing a copy of the SCORM API. This setting allows content with errors in the use of its API finder algorithm to still be delivered in a new window. Essentially, this mimics the structure of the ADL Test Suite.
Player Finish Causes Immediate Commit - This setting forces data to be sent to the server immediately upon the call of LMSFinish or Terminate by the SCO. Can be useful for SCOs that are not completing because of timing issues related to window closing.
Player Validate Interaction Responses - Determines whether the interaction responses are validated for expected SCORM format.  Use this setting when you want to include descriptive text in addition to the single number/character allowed by SCORM 1.2.  This affects both the user response and the correct response
Player Score Overrides Status - Determines whether or not the status derived from a score should override the actual status.
Player Scale Raw Score - In SCORM 2004 content, if a SCO sets a raw score but not a scaled score, should the raw score count as the normative score for the SCO?
Player Rollup Empty Set to Unknown - In SCORM 2004, determines whether a set of child activities in an unknown state rollup to "unknown" or "complete/satisfied"
Player Return to LMS Action - Defines what happens when a user click "Return To LMS"


Player Roll Runtime at SCO Unload - Initiates rollup and transfer of runtime data at ScoUnload for all SCOs.
Player Force Objective Completion Set by Content - Override the manifest settings for "Objective Set By Content" and "Completion Set By Content" with true values.
Player Invoke Rollup at Suspend All - Initiates rollup when SuspendAll is invoked.
Player Suspend Data Max Length Player - Maximum suspend data length in bytes.


These have not been documented yet but more info can be found here: https://rustici-docs.s3.amazonaws.com/engine/20.1.x/Configuration/Configuration-API.html

    • Related Articles

    • How To Assign A Catalog To A Course?

      As best practice, all courses should be assigned to at least one catalog. To assign a catalog to a course, follow these steps: Go to Learning. Search for the Module/Course. In the Module Properties, look for the Catalog Configuration. Select "Show in ...

    • Cannot Update Admin Accounts On An Interface Level - User Data Loader as a workaround

      Admin with the same role cant update expiration date, email and organization Solution Use the User Data Loader to update the admin account. You may use the User Data Loader to update the following fields for the admin account: - Expiration Date - ...

    • Product Release information Version 22.11

      The attached document lists all the additional functionality and enhancements that have been addressed in Version 22.11.  Please review and advise the Peak Pacific team if you would like to upgrade your LMS. Peak Pacific Admin Team

    • Product Release Information for Version 24.04

      The attachment outlines all the functional enhancements as part of the 24.04 release. Please reach out to use at Peak Pacific support should you wish to have your system upgraded.

    • Product Bug Fix Information for Version 23.11

      With each new release Peoplefluent has been address the various reported bug in the system. The attached document outlines those bug fixes that have been address in this version