Configuring OLSA Java Free for TPLMS

OLSA supports Java Free communication for tracking back to the TPLMS.

Java Free communication between Skillsoft Players and the client TPLMS uses an HTML5 PostMessage JavaScript command that supports two-way, intra-browser, cross-domain communication. The communication package is launched within an HTML "stub page" that acts as an intermediary between the player and the TPLMS when a learner launches a course enabled for the feature.

For SCORM implementations, the stub page is packaged within each SCORM course PIF and is installed to the TPLMS, as usual. For AICC implementations, the stub page is an HTML file that clients must install on their own server within the same domain that hosts their TPLMS. The URL for this location must then be entered into the OLSA Admin page as described below. Additionally, the AICC asset metadata Assignable Unit (.au) file for each course includes parameters for accessing the stub page, and for launching the course. For both SCORM and AICC courses, the necessary information is added to the PIF or metadata by the Download Asset Metadata page, and/or web service.

For a more in-depth description of how the stub page achieves Java Free tracking, see the Java Free OLSA Solution chapter in the OLSA v8 KB.

In order for customers to utilize the OLSA Java Free Solution, the feature must be configured by a Skillsoft user with Super Admin privileges. This includes activating three parameters - one SKP parametr on the SKillport Admin Configuration page, and two parameters (for AICC only) on the Java-Free RO AICC Configuration page in the OLSA Admin UI. (This page is enabled for Skillsoft Super Admins only and is not accessible by customers.)

Note: Skillsoft must use the same communication protocol as the client's TPLMS; if the TPLMS is using HTTP, then Skillport must also.

To enable the feature:

1. In the Skillport Admin Configuration > Set Parameters page, click the drop down for SKP parameters and select olsa_enable_javafree_ro.
2. Click Edit and enter one of the following values:
   • stock_content_only - enables the feature for Skillsoft content only.
   • stock_and_custom_content - enables the feature for both Skillsoft and custom content.
   • off - disables the feature.
3. Click Save.
4. After the above steps are complete, open the OLSA Admin page for the client's company site.

   

5. In the left menu, click Java-Free RO AICC Configuration.
6. Download the AICC Stub Page.
7. Send the stubCourse_aicc.zip file to the client and instruct them to extract the stubCourse_aicc.htm file to a location in the same domain as the TPLMS.

   The client must provide you with the URL to the location of the stubCourse_aicc.htm file.

8. Once you know the URL for the file, return to the Java-Free RO AICC Configuration page above.
9. In the AICC Stub Page Location, enter the URL to the location on the client's site.
10. Check the Enable Java-Free RO for AICC TPLMS box.
11. Click Submit.

From this point forward, all Java Free AICC courses downloaded with the Download Asset Metadata page, or the Download Asset Metadata web service, will include the data required for launching content via the stub page.

About the Download Asset Metadata Page

AICC

The Select Formats for AICC (AICC, XML, CSV, CSV (UTF-16) will generate Java Free RO metadata for an asset when:

• The feature is enabled globally
• The feature is enabled for AICC
• The AICC stub page URL is populated
• The asset is a course
• The asset uses RIA player, passive player, or SCORM 1.2 RTE
• The asset is designated as Java Free via a supported platform of HTML5, mobile, or tablet

Otherwise, the existing RO metadata will be generated for that asset.

SCORM

Selecting the SCORM format option will generate HTML5 Post Message SCORM course packages for assets asset when:

• The feature is enabled globally
• The asset is a course
• The asset uses RIA player, passive player, or SCORM 1.2 RTE
• The asset is designated Java Free via a supported platform of HTML5, mobile, or tablet

Each SCORM course will generate a course package with a PIF in a larger zip file.

Otherwise, Java RO course packages will be generated for that asset.

Notes:

• If Enable Java-Free RO for AICC TPLMS box is enabled while the AICC Stub Page Location field is blank, an "AICC Stub Page Location required" error displays.
• Turning this solution on or off has no effect on previously generated Asset Metadata Downloads that remain in the directory. It will only impact future requests.
• If the olsa_enable_javafree_ro SKP parameter allows for custom content metadata to be generated, then supported custom content will use the Post Message method when generating asset metadata. Custom content has to be enabled separately as custom content is generally expected to be installed directly to the the client’s TPLMS rather than accessed indirectly via Skillport/OLSA RO. The parameter ensures that the client has to obtain permission to use custom content with this solution.