Forum Discussion

AlexanderSchrij's avatar
AlexanderSchrij
Community Member
2 years ago

Overview of built-in xAPI statements in Storyline?

Hi,

I'm looking for an overview of all built-in (not custom) xAPI statements that are sent automatically from Storyline to an LRS. I want to know which verbs are being used by the built-in xAPI statements, because I want to use other verbs for my custom xAPI statements, to clearly distinguish between the two.

Where could I find such an overview?
Thanks

Victoria

  • Hi Victoria

    This is something I'd like more explanation of too.  Also, the "left" verb - which seems to be both inbuilt and used automatically by Articulate.  Also, "left" has a result.duration property which would be of a lot of use if I understood more about how it was being implemented.

    Andrew

    • StevenBenassi's avatar
      StevenBenassi
      Staff

      Hi Andrew!

      Thanks for reaching out! It sounds like you had some xAPI questions about the Left verb and also the results.duration property. I'd be happy to elaborate on both for you!

      • The ‘Left’ verb in Storyline signifies a learner's departure from the slide. You can find further details about this verb in the Tincan API registry, here.
      • In relation to the ‘Left’ verb, the results.duration property represents the length of the activity, indicating how long the user remained on the slide. In this sample screenshot, I spent approximately 13 seconds on the slide before proceeding to the next.

      Hope this helps! Please let me know if you have any more questions!

      • AndrewRowley-6a's avatar
        AndrewRowley-6a
        Community Member

        Hi Steven

        Thanks for getting back to me about the 'left' verb.

        Is it possible to get a full breakdown of the 'in-built' verbs used by Articulate - i.e. those that aren't in the dropdown of the xAPI wizard but are still in use by Articulate.

        Thank you for your help

        Kind regards

        Andrew Rowley | IT Training Officer
        Victoria House, Queen Alexandra Hospital, PO6 3LY
        T External - 023 9243 2333 option 3
        T Internal - 7701 2333 option 3
        Email: andrew.rowley@porthosp.nhs.uk

        Please note that I am currently working from home and can be contacted via MS Teams, email or on 07395 374318

  • Hi Victoria!

    It sounds like you were looking for some information on the verbs xAPI provides to describe user activity when communicating with an LMS! I'd be happy to help with that!

    Here’s a list of the verbs Articulate content uses, along with the meaning of the verbs.

    Please let me know if you have any more questions!

  • Thank you Steven!

    And Andrew, some information that I found along the way:

    The results.duration is written in ISO 8601 format.
    For example PT1H22M17S, this reads: "This period of time consists of one hour, twenty two minutes, and seventeen seconds." You can convert this to seconds using npm js (https://www.npmjs.com/package/iso8601-duration).

    Other ways to track the duration that I know of:

    • You could use the built-in variable in Storyline 'slide.elapsedtime' and send a custom xAPI statement when the user leaves the slide ('clicks next' etc) and include this variable in the xAPI statement (for instance in 'extensions' in 'context'). 
    • Devlin Peck's also has a tutorial to track duration: https://www.devlinpeck.com/content/measure-duration-xapi-storyline 

    I'm not a developer myself, so I can't help any further, but hope this helps!

  • Hi again.  Coming back to this - I really find the 'left' verb useful as we are able to track duration of time spent on a slide.  However, it is not available in the xapi wizard.  I am wondering why this is and that it would be useful to use 'left' when leaving a particular interaction.

    • JoseTansengco's avatar
      JoseTansengco
      Staff

      Hello Andrew,

      Can I ask if you were able to test your course in a different LMS to see if the left verb will appear in the statement viewer? I did a quick test in SCORM Cloud and can confirm that the left verb is correctly recorded here. 

      If the left verb doesn't appear for your course in SCORM Cloud, make sure that you are publishing your course correctly for xAPI distribution according to the steps outlined in this article. If you need additional assistance, open a case with our support team here

  • Hi Joe

    Thanks for your reply. The issue is not that the 'left' verb appears or not in the LRS (it does by the way).  

    My query is whether and how the 'left' verb can be used outside of the built-in functions in Articulate.  

    For example, I can get some great data about how long a learner viewed a slide for because upon exiting the slide, a 'left' statement is reported to the LRS - which also contains a result.duration property (which is really useful to our organisation).  I can see that in the article you link to, 'left' is 'sent when a user leaves a slide' and is not available otherwise.

    However, I cannot choose 'left' from the verb options within the Articulate xAPI wizard.  I would really love to be able to use this for specific elements within a slide - not just for the overall slide itself.  I have raised the issue of tracking elements within a slide here https://community.articulate.com/discussions/building-better-courses/mouseout-trigger-needed-for-xapi as I think they are separate (but related) issues.

    Apologies for the confusion, I am at the start of working with xAPI through Articulate and am unsure about the technical terms and also about what exactly a solution to this should look like.

    But basically I need to report as much detailed behaviour as I can about how a user interacts with elements within a slide.

    Kind regards

    Andrew

     

     

  • Hi Andrew,

    Good question! You are correct; the left verb is not included in the list of verbs when creating xAPI statements in the Storyline trigger wizard. For xAPI verbs that aren't on the list, you can use the xAPI statement editor.

    Let me know if you have additional questions!