lmsAPI Functionality in HTML5 Output

Mathew was kind enough to send me to this thread in order to resolve my problem. To summarize, some learners will go through the Storyline module and take a quiz using the basic  Storyline quiz slides and results slide. They must get 80% or higher to get completion credit. However, some learners won't be required to view most of the content nor the quiz, so I created a button to take them to the last slide ("Thanks for taking this training"), where they can exit. However, as they're not taking the quiz, they won't get credit for completion. So I wanted to set it up so that upon clicking the button (or by whatever other means), and exiting the course, it will send a passing score to the LMS.

So I'm looking at the code and have a couple of questions (as you'll see, I'm a newbie to JavaScript -- I apologize in advance):

"...we need to define a passing score:

var passingScore = "100";

…in this example, the user would need to get a score of 100 or more to pass.”

In my case, the user needs nothing to pass except clicking the button, so I’m not sure what to put here? 0? I believe passingScore would also be a custom variable I would need to create?

“Next, we will use Adam's code to find the lmsAPI. This will allow us to talk to the LMS:

function findLMSAPI(win) {

 if (win.hasOwnProperty("GetStudentID")) return win;

 else if (win.parent == win) return null;

 else return findLMSAPI(win.parent);

}

var lmsAPI = findLMSAPI(this);”

Not sure which lines of code I would need from here....I don't need to get the Student ID as Adam did.

"Then we are going to get a score from Storyline (which in this example is stored in a variable called Your_Score_Variable*) and send that to the LMS:

lmsAPI.SetScore(player.GetVar("Your_Score_Variable"), 100, 0);
Next, we will see if the score we got from Storyline is greater than or equal to the passing score that we defined earlier:

if (player.GetVar("Your_Score_Variable")>= passingScore)"

I'm not sure what lines I need here, what variable I may need to create, and what the values should be.

No worries! Thanks so much!

Hi Stephanie,

Thanks for checking in. This is something that our team is still taking a look at. Those features and Javascript elements that were accessible in Storyline 2, changed in Storyline 3 and 360 as we entirely rewrote the player and it's behavior. 

Those types of modifications have always been unsupported, but we do see the value in their use, so we're looking at how and why they fit the needs of Storyline 2 users and what options we could include in Storyline 3/360 to fix it going forward. 

Hi Ashley,

I understand that the modification of Javascript is not necessarily "supported" by Articulate.  That makes total sense, since it's not on your team if one of us makes a mistake in our coding.

However, in most cases I've encountered related to this topic, I believe we are only modifying the code because of a lack of a feature that meets our needs within Storyline.  

For example, this entire thread probably wouldn't be necessary if there was a trigger for "Mark Course Complete" within Storyline.  In that case, I would be able to simply say "Mark the course complete when the timeline starts on Page 4.4" or something to that effect.

Since this feature would be built into Storyline, it would presumably work in both Flash and HTML5, and wouldn't require external Javascript.

Alternatively, it could also be solved if we were given a new option in Publish Settings > Tracking, for "Mark [Completed/Passed] when user reaches slide: [4.4]".

I hope this is helpful for your team in determining how best to approach the request.

Absolutely Adam, and that's just the type of feedback that will help us look at what features to include as we continue to add to Articulate 360! Thanks for sharing it here. 🙂

Hey Matthew - some how i missed your offer of help. Big thanks anyway.  I think the help you gave Ilana should help me, so i will give that a go.  Thanks again!

Hi - I am able to set the status to pass/fail using the javascript so I think I am getting there.  I have put the javascript on in a trigger on the results slide I need to report on (to get the scores for the final exam across to the LMS).  The problem is that the status I set with the script is being overwritten  by some built in function used for reporting. Does anyone have a suggestion about the best way to avoid this?  Many thanks

I apologize if this is duplicative... I have read thru this thread but I still can't get this to work.. so I must be doing something wrong.

I had a very simple piece of javascript that was working to mark completion (below) and it was working for flash output just fine but now does not seem to be working for html5.

var lmsAPI = parent;
SetStatus("completed");

It doesn't sound like there has been a software update to address this yet.. but in the meantime.. is there any snippet of code that I can use to mark completion in both the flash and html5 versions?

Any help is much appreciated!

Hi Helene,

SetStatus("completed") only works with the Flash version because the HTML5 version doesn't end up using the lms.js file. So, you will have to bypass that function and directly call the function that the SetStatus function would have called... Try this:

function findLMSAPI(win) {
 if (win.hasOwnProperty("GetStudentID")) return win;
 else if (win.parent == win) return null;
 else return findLMSAPI(win.parent);
}

var lmsAPI = findLMSAPI(this);
lmsAPI.SetReachedEnd();

Awesome!!! that worked!

thanks so much!