tune up your tracking: getting your content to work in your lms · 2014-04-14 · session 803 -...

803

Tune up your Tracking: Getting your Content to

Work in your LMS

Andrew Chemey Macromedia, eLearning Specialist

Session 803 - Tune up Your Tracking: Getting Your Content to Work in Your LMS -Andrew Chemey, eLearning Specialist, Macromedia

The LMS/LCMS Implementation & Management Online SymposiumJuly 27-29, 2005

Tune Up your Tracking:Getting your content to work in your LMS

Andrew ChemeyMacromedia

ObjectivesReview typical LMS issues with Breeze Presenter, Captivate and Authorware

– General LMS integration issues– AICC issues– SCORM issues– Specific LMS issues

Review LMS Features of Breeze Presenter, Captivate and Authorware tools

– Metadata– Manifest or packaging files– Run-time communication files– Other

Describe additional support resources/integration with Breeze



What level of experience do you have with an LMS?

A. I wandered into the wrong virtual classroom and think you are using too many acronyms

B. It is all new to me, I may have used some LMS content

C. I’m familiar with it and work with others who know about LMS products, AICC, SCORM and so forth

D. I’ve used an authoring product that automates LMS communication, but want to know more

E. I’ve actually hand crafted content and code to work with an LMS

Click to edit Master title style

Click to edit Master subtitle style

LMS Features

Features provided by each tool



LMS Features: Breeze Presenter

Run-time Communication– Automatic (separate launch file for AICC and SCORM)– Two-way communication with an LMSManifest/Packaging– Simple form-based UI– Single “Universal” package when publishing for Breeze– Separate files for SCORM 1.2 and SCORM 2004Breeze 5– Seamless integration/support

LMS Features: Captivate

Run-time Communication– Automatic (publish separately for AICC and SCORM)– Two-way communication with an LMSManifest/Packaging– Simple form-based UI– Separate files for SCORM 1.2 and SCORM 2004Breeze 5– Seamless integration/support



LMS Features: Authorware

Run-time Communication– LMS KOs– LMS HTML Publishing Template– Single set of published files are AICC and SCORM-compliant– Two-way communication with an LMS– Complete control over *all* LMS run-time communication data

Metadata– Authorware Learning Object Metadata Editor (complete control)

Manifest/Packaging– Authorware Learning Object Content Packager (complete control)

Additional tools– LMS Emulator

Breeze 5 tracking through manual upload

Click to edit Master title style

Click to edit Master subtitle style

LMS Issues

Typical issues that affect each tool



General LMS Issues

Breeze Presenter

General LMS: Breeze PresenterLMS Interactivity needs to be enabled



General LMS: Breeze PresenterDetermine appropriate LMS standard

General LMS: Breeze PresenterKnow what your LMS supports: Import



General LMS: Breeze PresenterKnow what your LMS supports: SCORM ‘04

General LMS: Breeze PresenterKnow what your LMS supports: Status



General LMS: Breeze PresenterKnow what your LMS supports: Score

General LMS: Breeze PresenterKnow what your LMS supports: Interactions



General LMS: Breeze PresenterKnow what your LMS supports: Suspend

General LMS Issues

Captivate



General LMS Issues: CaptivateLMS Interactivity needs to be enabled

General LMS Issues: CaptivateDetermine appropriate LMS standard



General LMS Issues: CaptivateKnow what your LMS supports: Import

General LMS Issues: CaptivateKnow what your LMS supports: SCORM ‘04



General LMS Issues: CaptivateKnow what your LMS supports: Status

General LMS Issues: Captivate



General LMS Issues: CaptivateKnow what your LMS supports: Score

General LMS Issues: CaptivateKnow what your LMS supports: Interactions



General LMS Issues: Captivate

Closing browser with the “exit” button in toolbarif(window.parent != window){

window.close = function(){

window.parent.close();}

}Close browser when files don’t display a toolbar– Add an “exit” button at the end of the Captivate file with “Javascript” function

window.close();

General LMS Issues

Authorware



General LMS Issues: AuthorwareDo NOT combine LMS KOs with CMI Functions/Variables

General LMS Issues: AuthorwareEnsure all CMI checkboxes in File/Properties dialog are unchecked



General LMS Issues: Authorware

Use “LMS KO” Publishing Template


Use only ONE LMS (Initialize) KOUse at least one LMS (Send Data) KOMake sure to “quit” after sending data



General LMS Issues: AuthorwareDetermine what satisfies “completion”Know what your LMS supports for Status

– “incomplete”– “completed”– “passed”– “failed”

Know what your LMS supports for Score– Percentage– Raw, Max, Min

Does your LMS support Interaction Data? (Not in Basic KOs)How do you want to handle Resume

– Resume (where learner left off)– Suspend Data (state data, including questions answered, etc)

How often do you want to send data?Use Custom VariablesIT/Infrastructure

– # of Users– # of Concurrent Users– Amount of data you want to send and when

True Control over all aspects


Use the LMS EmulatorUse the LMS Debug Window for debugging (press <Ctrl> + <Alt> + L)



AICC Issues

General Process

AICC Issues1. You create the AICC-Compliant content using Macromedia tools.

• Note: This is not exposed to the student.2. The learner launches the LMS 3. The learner logs in to the LMS. 4. The learner navigates through the course structure to find an assignable unit

(AU). In this case, you can assume its content that was created using any Macromedia Tool.

5. The learner opens the content. 6. The content is located on a web server (for example,

htttp://myserver/MMContent.htm). • Note: Most content does not need to be in a frameset. In some cases, though, a frameset may be

required. 7. The LMS adds two parameters to the end of the URL; AICC_URL and AICC_SID.

When the content opens, the URL would look like: http://myserver/MMContent.htm?AICC_URL=http://myserver/trackurl.asp&AICC_SID=123

• Note: This is not exposed to the student.8. The learner proceeds through the content. 9. The content sends tracking data to the LMS (through properly

formatted AICC commands) when the learner answers a question and/or proceeds through a quiz.

• Note: This is not exposed to the student.



AICC Issues

Breeze Presenter

AICC Issues: Breeze Presenter

Cross-Domain Tracking– Definition: Content resides on one domain and the LMS resides

on another domain• Content: http://www.content.com; LMS: http://www.lms.com. • Content: http://macromedia.content.com; LMS:

http://macromedia.lms.com (also known as N-1 matching).

– Solutions:1. Ensure your files are on the exact same domain 2. Host a properly configured file called “crossdomain.xml” on the root

of the LMS server AND use Flash Player 6 (r65) or higher.3. Use a one-way tracking mechanism (with a frameset, similar to how

previous versions of Breeze PowerPoint plug-in published content). NOTE: Will not allow/support bookmarking or resume.




Pop-up window OR alert box appears when closing the content window

– It’s to comply with the AICC standard, which requires an “ExitAU” command to be sent

– Solutions1. Comment out the code, if your LMS doesn’t require it

2. Display a Message box (instead of the pop-up window)

3. Use a Java Applet or other mechanism to issue ExitAU


Learner Sessions might not expire– Breeze Presenter sends tracking data:

• After learner answers each question (even if not sending interaction data)

• When entering a new quiz slide

• When entering the results slide

• Approximately every two minutes




Time doesn’t appear in LMS correctly– Some LMSs store last reported session time– According to AICC standard user time sent to

LMS is supposed to be reset every time tracking data is sent to LMS


AICC Course Structure Files (AICC CSF)– AICC CSF uses data from “Manifest” section– Probably need to modify “presenter.au” file to

reflect actual URL where content will reside




SumTotal/Aspen/Ingenium LMS– Need to change the AICC.htm file so that it does

NOT url-encode the AICC parameters• Edit the AICC.htm created at publish OR• Edit the AICC.htm file template (typically found at

C:\Program Files\Macromedia\Breeze 5\AICC)

• Comment out the line that begins:

strURLParams = (strURLParams==unescape(…

AICC Issues: Breeze PresenterOracle iLearning// -------------------------------// Oracle-specific HACP references// -------------------------------var strURLParamsAICC = "";var strURLTemp = "";intTemp = strURLParams.toUpperCase().indexOf("AICC_URL");if(intTemp > -1){

strURLParamsAICC = strURLParams.substring(intTemp + (intTemp==0?8:9))strURLTemp = (intTemp>0?strURLParams.substring(0, intTemp):strURLTemp);if(strURLParamsAICC.indexOf("&") > 0){

strURLTemp = strURLTemp + strURLParamsAICC.substring(strURLParamsAICC.indexOf("&")+1);

strURLParamsAICC = strURLParamsAICC.substring(1, strURLParamsAICC.indexOf("&"));

}if(strURLParamsAICC.toLowerCase().indexOf("ilearning.oracle.com") > -1){

// replace ilearning.oracle.com with ilearningcontent.oracle.comstrURLParamsAICC = strURLParamsAICC.substring(0,

strURLParamsAICC.toLowerCase().indexOf("ilearning.")) + "ilearningcontent." + strURLParamsAICC.substring(strURLParamsAICC.toLowerCase().indexOf("ilearning.") + 10);

}strURLParams = (strURLTemp==""?"":strURLTemp +

(strURLTemp.substring(strURLTemp.length-1)=="&"?"":"&")) + strURLParams.substring(intTemp, intTemp + 9) + strURLParamsAICC;}// -----------------------------------// End Oracle-specific HACP references// -----------------------------------



AICC Issues

Captivate

AICC Issues: Captivate

Cross-Domain Tracking– Definition: Content resides on one domain and the LMS resides

on another domain• Content: http://www.content.com; LMS: http://www.lms.com. • Content: http://macromedia.content.com; LMS:

http://macromedia.lms.com (also known as N-1 matching).

– Solutions:1. Ensure your files are on the exact same domain 2. Host a properly configured file called “crossdomain.xml” on the root

of the LMS server AND use Flash Player 6 (r65) or higher.3. Use a one-way tracking mechanism (with a frameset, similar to how

previous versions of RoboDemo published content). NOTE: Will not allow/support bookmarking or resume.




Pop-up window OR alert box appears when closing the content window

– It’s to comply with the AICC standard, which requires an “ExitAU” command to be sent

– Solutions1. Display the Captivate toolbar and have learners click the “X”

to end communication with LMS and exit/close file.

2. Comment out the code, if your LMS doesn’t require it

3. Display a Message box (instead of the pop-up window)

4. Use a Java Applet or other mechanism to issue ExitAU


Learner Sessions might not expire– Captivate sends tracking data:


• When entering a new quiz slide

• When entering the results slide

• Approximately every two minutes




Time doesn’t appear in LMS correctly– Some LMSs store last reported session time– According to AICC standard user time sent to

LMS is supposed to be reset every time tracking data is sent to LMS


AICC Course Structure Files (AICC CSF)– Captivate does not create AICC CSF




SumTotal/Aspen/Ingenium LMS– Need to change the AICC.htm file so that it does

NOT url-encode the AICC parameters• Edit the AICC.htm created at publish OR• Edit the AICC.htm file template (typically found at

C:\Program Files\Macromedia\Captivate\Templates\Publish)

• Comment out the line that begins:

strURLParams = (strURLParams==unescape(…

AICC Issues: CaptivateOracle iLearning// -------------------------------// Oracle-specific HACP references// -------------------------------var strURLParamsAICC = "";var strURLTemp = "";intTemp = strURLParams.toUpperCase().indexOf("AICC_URL");if(intTemp > -1){

strURLParamsAICC = strURLParams.substring(intTemp + (intTemp==0?8:9))strURLTemp = (intTemp>0?strURLParams.substring(0, intTemp):strURLTemp);if(strURLParamsAICC.indexOf("&") > 0){

strURLTemp = strURLTemp + strURLParamsAICC.substring(strURLParamsAICC.indexOf("&")+1);

strURLParamsAICC = strURLParamsAICC.substring(1, strURLParamsAICC.indexOf("&"));

}if(strURLParamsAICC.toLowerCase().indexOf("ilearning.oracle.com") > -1){

// replace ilearning.oracle.com with ilearningcontent.oracle.comstrURLParamsAICC = strURLParamsAICC.substring(0,

strURLParamsAICC.toLowerCase().indexOf("ilearning.")) + "ilearningcontent." + strURLParamsAICC.substring(strURLParamsAICC.toLowerCase().indexOf("ilearning.") + 10);

}strURLParams = (strURLTemp==""?"":strURLTemp +

(strURLTemp.substring(strURLTemp.length-1)=="&"?"":"&")) + strURLParams.substring(intTemp, intTemp + 9) + strURLParamsAICC;}// -----------------------------------// End Oracle-specific HACP references// -----------------------------------



AICC Issues

Authorware

AICC Issues: Authorware

Sending ExitAU– Make sure you have a Exit button with the

“Quit, after sending any data” checked




Inactivity or ending a session– Authorware developer has complete control

over determining if there hasn’t been interactivity for a period of time. Developer can also terminate session and/or send tracking data whenever appropriate (e.g. every 30 minutes)


AICC Course Structure Files (AICC CSF)– Authorware does not create AICC CSF



SCORM Issues

General Process

SCORM Issues1. SCORM-compliant content is created using Macromedia

tools Note: This is not exposed to the student.2. The LMS is launched. 3. The student logs in to the LMS. 4. The student navigates through the course structure to find

a Sharable Content Object (SCO). 5. The student launches the content. 6. The content is located on a web server (for example,

"http://myserver/captivatecontent.htm"). 7. The LMS creates a JavaScript API that is used for

communicationNote: This is not exposed to the student.

8. The student progresses through the content. 9. Content sends tracking data to the LMS by calling the

appropriate JavaScript API methods. The tracking data is sent when the student answers a question and progresses through a quiz.Note: This is not exposed to the student.



SCORM Issues

Breeze Presenter

SCORM Issues: Breeze Presenter

Finding the SCORM API• If Breeze Presenter does NOT seem to send any

tracking data to your LMS:– Ensure you are launching “SCORM.htm”

– Add an alert box to the “SCORM.htm” file before any of the document.write lines that reads: alert(g_objAPI);

– If the alert doesn’t show an API reference - change the order for finding the SCORM API by modifying the line: var g_intAPIOrder = 0;

to read:var g_intAPIOrder = 1;




Breeze Presenter expects data to be returned for these LMS:

LMSInitialize(“”); - SCORM 1.2 or Initialize(“”); – SCORM 2004

LMSGetValue(“cmi.core._children”); – SCORM 1.2

LMSGetValue(“cmi.core.score._children”); - SCORM 1.2 orGetValue(“cmi.score._children”); - SCORM 2004

LMSGetValue(“cmi.interactions._children”); - SCORM 1.2 or GetValue(“cmi.interactions._children”); - SCORM 2004


Learner Sessions might not expire– Breeze Presenter sends tracking data:


• When entering a new quiz slide• When entering the results slide• Approximately every two minutes

– Modify the SCORM.htm file to configure and control when and how often to send tracking data or to automatically close the browser window (IE-only) after a period of time or in-activity.




How do you disable bookmarking?– Modify the SCORM.htm file

if(strFSCmd=="LMSGetLastError"){

strErr = eval('g_objAPI.' + strFSCmd + '();')Captivate1Obj.SetVariable(strFSArg3, strErr);

} else {if(strFSArg1 == "cmi.suspend_data"){

strErr = "";} else {

strErr = eval('g_objAPI.' + strFSCmd + '(\"' + strFSArg1 + '\");')}Captivate1Obj.SetVariable(strFSArg3, strErr);

}

– Modify “SCORM_Support.js”if(strSCOproperty == "cmi.suspend_data"){

varResult = "";}dataToFlash('dynamic', strFLvariableName + "|" + varResult);


Blackboard– Edit the SCORM.htm file and make the following change to force “g_zAPIVersion = “0.2”;

if (g_objAPI != null){

g_zAPIVersion = “0.2”;strURLParams += (strURLParams==""?"?":"&") + "SCORM_API=" + g_zAPIVersion + "&SCORM_TYPE=" +

g_intAPIType;}

Oracle iLearning– Requires an additional XSD files to be included in the SCORM-PIF. Contact your Oracle

representative for additional informationWebCT

– Requires a change to find the SCORM API: var g_intAPIOrder = 1;

SumTotal/Aspen/Ingenium– Requires a change to find the SCORM API:

var g_intAPIOrder = 1;



SCORM Issues

Captivate

SCORM Issues: Captivate

Finding the SCORM API• If Captiate does NOT seem to send tracking data:

– Ensure you are launching “SCORM.htm”

– Add an alert box to the “SCORM.htm” file before any of the document.write lines that reads: alert(g_objAPI);

– If the alert doesn’t show an API reference - change the order for finding the SCORM API by modifying the line: var g_intAPIOrder = 0;

to read:var g_intAPIOrder = 1;




Captivate expects data to be returned for these LMS:

LMSInitialize(“”); - SCORM 1.2 or Initialize(“”); – SCORM 2004





Learner Sessions might not expire– Captivate sends tracking data:


• When entering a new quiz slide• When entering the results slide• Approximately every two minutes

– Modify the SCORM.htm file to configure and control when and how often to send tracking data or to automatically close the browser window (IE-only) after a period of time or in-activity.




How do you disable bookmarking?– Modify the SCORM.htm file

if(strFSCmd=="LMSGetLastError"){

strErr = eval('g_objAPI.' + strFSCmd + '();')Captivate1Obj.SetVariable(strFSArg3, strErr);

} else {if(strFSArg1 == "cmi.suspend_data"){

strErr = "";} else {

strErr = eval('g_objAPI.' + strFSCmd + '(\"' + strFSArg1 + '\");')}Captivate1Obj.SetVariable(strFSArg3, strErr);

}

– Modify “SCORM_Support.js”if(strSCOproperty == "cmi.suspend_data"){

varResult = "";}dataToFlash('dynamic', strFLvariableName + "|" + varResult);


4 SCORM 1.2 XSD Files– Captivate does not include the 4 optional XSD files with the SCORM 1.2 package. IMSManifest.xml for SCORM 1.2 has a duplicate LOM-TAG Reference

– Replace with an updated template on Macromedia’s Developer CenterCaptivate expects return values from LMS to NOT include spaces for:




A workaround is to modify the SCORM.htm to strip all spaces before returning values to Captivate




Blackboard– Edit the SCORM.htm file and make the following change to force “g_zAPIVersion = “0.2”;

if (g_objAPI != null){

g_zAPIVersion = “0.2”;strURLParams += (strURLParams==""?"?":"&") + "SCORM_API=" + g_zAPIVersion + "&SCORM_TYPE=" +

g_intAPIType;}

Oracle iLearning– Requires an additional XSD files to be included in the SCORM-PIF. Contact your Oracle

representative for additional informationWebCT

– Requires a change to find the SCORM API: var g_intAPIOrder = 1;

SumTotal/Aspen/Ingenium– Requires a change to find the SCORM API:

var g_intAPIOrder = 1;

SCORM Issues

Authorware



SCORM Issues: Authorware

Sending Finish command– Make sure you have a Exit button with the

“Quit, after sending any data” checked

SCORM Issues: Authorware

Use the LMS Metadata Editor to create a metadata XML file for each SCOUse the Content Packager to create the IMSManifest.xml fileUse the Content Packager to bundle and/or .zip up the contents into a valid SCORM-PIF fileOracle iLearning– Requires an additional XSD files to be included in the SCORM-

PIF. Contact your Oracle representative for additional information



ResourceseLearningGuild

– Website: http://www.eLearningGuild.com (and look for Tom King’s presentations)Breeze Presenter / Captivate

– General: http://www.macromedia.com/devnet/captivate/articles/lms_output.html– AICC: http://www.macromedia.com/devnet/captivate/articles/output_aicc.html– SCORM: http://www.macromedia.com/devnet/captivate/articles/output_scorm.html

Authorware– LMS KOs: http://www.macromedia.com/devnet/authorware/articles/compliant_files.html– Building Content: http://www.macromedia.com/resources/elearning/article/lo_packager01/– Metadata Editor: http://www.macromedia.com/devnet/authorware/articles/metadata_editor.html– Content Packager: http://www.macromedia.com/resources/elearning/article/lo_packager02/– LMS KO Professional: http://www.learningconsulting.com

Standards– Advanced Distributed Learning (http://www.adlnet.org)– Aviation Industry Computer-Based Training Committee (http://www.aicc.org)– IEEE Learning Technology Standards Committee (http://www.ltsc.ieee.org)– IMS Global Learning Consortium (http://www.imsproject.org)

Books– eLearning Standards, a Guide to Purchasing, Developing and Deploying

Standards-Conformant e-Learning (http://www.elearning-standards.com)

Q&A

Andrew ChemeyMacromedia

tune up your tracking: getting your content to work in your lms · 2014-04-14 · session 803 -...

Documents