Tin Can Content - You must add a query string to the URL that contains the information required to track the course

Aug 14, 2017

This video on, "How To Create a Tin Can Course using Articulate 360", makes no reference to how to add a query string to the URL that contains the information required to track the course.

This URL "https://articulate.com/support/article/Implementing-Tin-Can-API-to-Support-Articulate-Content#communicationexplains" we must add a query string to the URL that contains the information required to track the course.

How do we add the information?

How can we add the "activity_id" to the launch link?

Here is the documentation from the above referenced link:

You must add a query string to the URL that contains the information required to track the course. The required values include the Tin Can endpoint (endpoint), the authorization token (auth), and the learner information (actor). The query string should also include the activity ID (activity_id) and the registration (registration) if the LMS implementation requires these values when receiving requests from the content. Below is an example of a launch link with line breaks and without URL encoding for readability:

http://my.lms.com/TCActivityProvider/story.html

?endpoint=http://my.lms.com/lrs/endpoint/

&auth=Basic OjFjMGY4NTYxNzUwOGI4YWY0NjFkNzU5MWUxMzE1ZGQ1

&actor={"name": ["First Last"], "mbox": ["mailto:firstlast@mycompany.com"]}

&activity_id=61XkSYC1ht2_course_id

&registration=760e3480-ba55-4991-94b0-01820dbd23a2
A properly URL encoded launch link will look like the following (line breaks added for readability):

http://my.lms.com/TCActivityProvider/story.html

?endpoint=http%3A%2F%2Fmy.lms.com%2Flrs%2Fendpoint%2F

&auth=Basic OjFjMGY4NTYxNzUwOGI4YWY0NjFkNzU5MWUxMzE1ZGQ1

&actor=%7B%22name%22%3A%20%5B%22First%20Last%22%5D%2C%20%22mbox
%22%3A%20%5B%22mailto%3Afirstlast%40mycompany.com%22%5D%7D

&activity_id=61XkSYC1ht2_course_id

&registration=760e3480-ba55-4991-94b0-01820dbd23a2
You can also add custom parameters to the launch link’s query string. Any additional parameters will be echoed back when the content reports statements to the LMS.

 

I have added the course file we are working with.

 

Thank you!

 

Shawn Fitzpatrick

 

 

1 Reply
Ashley Terwilliger-Pollard

Hi Shawn, 

Have you looked at how this course behaves in a site like SCORM Cloud? When you upload it there, or to any other  Learning Management System (LMS), the LMS will add the endpoint, auth actor, activity_id and registration values in the URL in the address bar  if you have published for Tin Can API.

The LMS is what creates your course URL, so it's the LMS's job to create the query string added to the URL too. 

If you haven't yet tested at SCORM Cloud, take a look at the steps here to get started. 

This discussion is closed. You can start a new discussion or contact Articulate Support.