xAPI has always been a bit like the continuum transfunctioner, as it’s mystery is exceeded only by it’s power.
Hoping to unravel a bit of that mystery, the attached Zip contains two files, a launch HTML file, and a configuration XML file that will allow you to run Lectora published xAPI content from a regular web server, rather than having to load the content on an LMS.
To use the files, just unzip and add them as attachments to your Lectora title, or copy them into the published directory of a Lectora title. Then, rather than launching your content by the normal a001index.html file produced by Lectora, launch it by running the included launch.html file.
So what does this mysterious launch.html file do?
- loads the parameters from the included XML file
- prompts the user for any information not included in that configuration file
- formulates the launch string that loads the course
- launches the course (in the same window)
So you can preload any information that will always be the same, such as the LRS endpoint, and prompt the user for information that will change per user, such as their email and password. You can modify the configuration file any way you like, so if you don’t need individual logins for each user, you can pre-fill all of the information, and it will run the course immediately, its all up to how you want to organize your information. There is even contextual help available for each parameter that is prompted for by launch.html.
Lets look at the configuration parameters available in launch.xml:
- launchpage – this is the “start” file that will be launched once the launch string is created. For a Lectora published xAPI title, it is generally a001index.html
- basicuserid – This is your ID on the LRS
- basicpassword – This is your password on the LRS
- email – This email will identify your course results on the LRS
- endpoint – This is the URL that the course results will be sent to
- activityid – This is the unique identifier for the course.
Hopefully this utility will do everything you need to get your xAPI off the ground. If you want to dig a little deeper, or set up your launch string on your own, I’ve included a PDF that has all of the details of the launch string for xAPI published Lectora titles, along with some info about a few LRS’s you can try.