Linking to Assets in Storyline Content

Introduction

imSMART has an API (Application Programming Interface) that allows interactive content to call out functions within the app. In order to open files that exist in imSMART from storyline, you need to call the "macs" API.

Finding the "Asset ID"

In order to link to a file, you need to know the asset ID you are going link to. The asset id is in the url of the asset. To find it, go to the asset, and click on the URL bar in your browser. The "id" after the question mark is your asset ID. In the example below, the id is 17175.

Adding the Link to the Asset in StoryLine

StoryLine supports "triggers" that can be applied to any element. To add a trigger, select the element and click "create a new trigger."

 Choose execute Javascript and click the "..." button

With the editor, type the command: macs.viewAsset('17175'); but replace 17175 with whatever the asset id is.

Do this for all of your links to items in imSMART.

Publishing the Content

When publishing from StoryLine, check "Include HTML5 output" and uncheck use articulate mobile player for iOS.

Preparing the content for imSMART

When the publishing is complete, open the folder from your explorer/finder or by clicking "open" under the folder icon in storyline.

The folder structure should look something like this:



In order for the imSMART API to work, you will need to add a javascript file to the "story_content" folder and an html file to the base. The two files you need are attached to this article at the bottom of the page. 

After downloading the field, drag "macs.js" to the story_content folder, and, "index.html" to the base of the folder. 

After adding the items, right click in a blank area of the folder and create a new "Compressed (Zipped) Archive" and name it whatever you'd like.

CTRL+click on all the files in the folder, except the new compressed folder, and, drag them to the new archive folder.

Uploading to imSMART

You can now upload the compressed folder to imSMART, like you would any other asset (see article here: Adding Assets).

The storyline content will now open like any other asset, and, when users tap on an element with a trigger to an imSMART file, the file will open.