⚠️ This page is for an older version. Go to the latest version (12.1.0)

Obojobo Event Reference

Obojobo Events are used to announce and record actions. They may be initiated on the server or client, and can be listened to in order to trigger other actions. These events can be useful for research and data analysis. This document provides details about the different events.

Obojobo Event exports will have the following columns:

Column Description
created_at DateTime when the event was written to the database
actor_time DateTime when the event was initially created. This can differ from created_at when the event is initialized on the client.
actor Which user’s session was active during this event
action Name of the event type (eg: visit:create or nav:hide)
ip IP address of the user’s client.
draft_id Draft Id of the document related to this event.
draft_content_id Draft Content Id of the specific version the document content this event is related to.
version_number Semantic Version of the event itself. Properties can change as Obojobo changes.
payload JSON data of the actual event properties (shown in the rest of this document)

Note: Obojobo Events cannot be used on the client in trigger and action nodes.

Visit

visit:create

Occurs when a new visit is created. The visit is not considered started until the visit:start Event occurs.

Version
1.0.0

Properties

Property Description
visitId id of the visit created
deactivatedVisitId id of the deactivated visit

visit:start

Occurs when a visit is started after its creation. Not all visits that are created are started.

Version
1.0.0

Properties

Property Description
visitId id of the visit to start

Viewer

viewer:open

Occurs when the user has opened a document in the Obojobo Veiwer.

Version
1.1.0

Properties

Property Description
visitId id of the visit User/draft

viewer:close

Occurs when the user closed the browser window containing the Obojobo Viewer.

Version
1.0.0

Properties

None

viewer:inactive

Occurs when the user has not interacted with the page in the last 10 minutes.

Version
2.0.0

Properties

Property Description
lastActiveTime ECMAScript Date string representation of the last recorded time of interactivity
inactiveDuration The amount of time in milliseconds recorded with no measured interactivity (10 minutes)

viewer:returnFromInactive

Occurs when the user has interacted with the page after having not interacted with the page for 10 minutes or more.

Version
2.1.0

Properties

Property Description
lastActiveTime ECMAScript Date string representation of the last recorded time of interactivity
inactiveDuration The updated amount of time in milliseconds recorded with no measured interactivity
relatedEventId The id of the corresponding viewer:inactive Obojobo event

viewer:leave

Occurs when the user has hidden the draft page, either by changing tabs or minimizing the window. Corresponds to the visibilitychange browser event and document.hidden browser value.

Version
1.0.0

Properties

None

viewer:return

Occurs when the user is again viewing the draft page, either by changing tabs or re-selecting the window.

Version
2.0.0

Properties

Property Description
relatedEventId The id of the corresponding viewer:leave Obojobo event
leftTime ECMAScript Date string representation of the recorded time when the tab/window went inactive
duration The amount of time in milliseconds recorded in which the tab/window was not active

Question

question:scoreSet

Occurs when a user recieves a score for a graded question.

Version
1.0.0

Properties

Property Description
id A generated UUID to represent this score
score The score value (0-100)
itemId The id of the item that was scored
context The context (string) when this score was set

question:scoreClear

Occurs when the score for a question was reset.

Version
1.0.0

Properties

Property Description
id The UUID to the score that was cleared. This UUID was generated by a previous question:scoreSet event for this question.
score The score value (0-100)
itemId The id of the item that was scored
context The context (string) when this score was cleared

question:showExplanation

Occurs when the user is viewing the explanation (aka. solution) of a question.

Version
1.1.0

Properties

Property Description
questionId The id of the corresponding Question
context The context (string) when the explanation was shown

question:hideExplanation

Occurs when the user or ViewerClient has hidden a question explanation.

Version
1.1.0

Properties

Property Description
questionId The id of the corresponding Question
actor Either 'user' or 'viewerClient'

question:checkAnswer

Occurs when the user is checking their answer to a graded question.

Version
1.1.0

Properties

Property Description
questionId The id of the corresponding Question
context The context (string) when the user is checking their answer
response The state of the response of the question
scoreId Internal id of the question score
score The score value (0-100)

question:submitResponse

Occurs when the user has submitted a response for an un-graded question.

Version
1.0.0

Properties

Property Description
questionId The id of the corresponding Question
context The context (string) when this score was set
response The state of the response of the question

question:retry

Occurs when the user is reattempting a question. Previous responses and scores are hidden.

Version
1.1.0

Properties

Property Description
questionId The id of the corresponding Question
context The context (string) when this question was retried

question:setResponse

Occurs when the user has selected a response to a question.

Version
2.1.0

Properties

Property Description
questionId The id of the corresponding Question
targetId The id of the OboNode item that was interacted with
response The state of the response of the question
context  
assessmentId  
attemptId  

question:view

Occurs when the user has activated a question, making it visible.

Version
1.1.0

Properties

Property Description
questionId The id of the corresponding Question
context The context (string) when this question was viewed

question:hide

Occurs when a question has been hidden.

Version
1.1.0

Properties

Property Description
questionId The id of the corresponding Question
context The context (string) when this question was hidden

Assessment

assessment:attemptStart

Occurs when an assessment attempt has started.

Version
1.1.0

Properties

Property Description
attemptId  
attemptCount  

assessment:attemptEnd

Occurs when an assessment attempt has ended.

Version
1.1.0

Properties

Property Description
attemptId  
attemptCount  

assessment:attemptScored

Occurs when an assessment attempt has been scored.

Version
2.0.0

Properties

Property Description
attemptId  
attemptCount  
attemptScore  
assessmentScore null or a number 0 to 100 (This value is equal to scoreDetails.assessmentModdedScore)
ltiScoreSent null or a number 0 to 1 (This value was sent via an LTI replaceResult to a tool consumer)
ltiStatus One of LTI Status values (see below)
ltiGradebookStatus One of LTI Gradebook Status values (see below)
ltiErrorDetails Error information (may have a value of type object, otherwise expect null)
assessmentScoreId Internal id of this assessment score
ltiAssessmentScoreId Internal id of this LTI assessment score
scoreDetails.status One of 'passed', 'failed' or 'unableToPass'
scoreDetails.rewardTotal The total amount of mods rewarded (The sum of all reward values for each mod with an index in rewardedMods)
scoreDetails.attemptScore The attempt score - A value from 0 to 100
scoreDetails.rewardedMods An array of mod indicies from the attempt rubric that were rewarded
scoreDetails.attemptNumber  
scoreDetails.assessmentScore The assessment score with rewards applied
scoreDetails.assessmentModdedScore The final assessment score after rewards are applied

Occurs when the user has clicked on a navigation link or button and has moved to another area in the document.

Version
1.0.0

Properties

Property Description
from OboNode id that user is navigating from
to OboNode id that user is navigating to

Occurs when the user has clicked a button which fires a nav:goto event and has now moved to another area in the document

Version
1.0.0

Properties

Property Description
from OboNode id that user is navigating from
to OboNode id that user is navigating to

Occurs when the user has clicked on the ‘previous’ button and has moved back one step in the document’s navigation.

Version
1.0.0

Properties

Property Description
from OboNode id that user is navigating from
to OboNode id that user is navigating to

Occurs when the user has clicked on the ‘next’ button and has moved ahead one step in the document’s navigation.

Version
1.0.0

Properties

Property Description
from OboNode id that user is navigating from
to OboNode id that user is navigating to

Occurs when the navigation has been locked.

Version
1.0.0

Properties

None

Occurs when the navigation has been unlocked.

Version
1.0.0

Properties

None

Occurs when the navigation sidebar has been closed.

Version
1.0.0

Properties

None

Occurs when the navigation sidebar has been opened.

Version
1.0.0

Properties

None

Media

Currently media events are used exclusively for the IFrame OboNode.

media:show

Occurs when an IFrame is shown.

This event is not fired if the IFrame is automatically loaded (Using the autoload property).

Version
1.0.0

Properties

Property Description
id id of the OboNode shown

media:hide

Occurs when an IFrame is hidden - Either by an event or when an OboNode (like a Page) containing an IFrame is navigated away from.

Version
1.0.0

Properties

Property Description
id id of the OboNode hidden
actor Either 'user' or 'viewerClient'

media:setZoom

Occurs when an IFrame with the zoom control enabled is zoomed in or out.

Version
1.0.0

Properties

Property Description
id id of the OboNode where the zoom level has changed
previousZoom The zoom level before the media:setZoom event was fired
zoom The new zoom level

Zoom is stored as a number > 0 representing the zoom percentage of the media. For example, 1 means the media is at 100%, 1.5 represents 150% and so on.

media:resetZoom

Occurs when an IFrame with the zoom control enabled is reset to its original size.

Version
1.0.0

Properties

Property Description
id id of the OboNode where the zoom level has changed
previousZoom The zoom level before the media:resetZoom event was fired
zoom The new zoom level (which will be the starting zoom level when the OboNode was first shown).

Zoom is stored as a number > 0 representing the zoom percentage of the media. For example, 1 means the media is at 100%, 1.5 represents 150% and so on.

LTI

lti:launch

Occurs when an LTI launch was started successfully.

Version
1.0.0

Properties

Property Description
launchId  

lti:replaceResult

Occurs when an LTI replaceResult message is sent to alter the user’s score in LMS (aka Tool Consumer). This event is created regardless of the ReplaceResult being successful.

Version
2.0.0

Properties

Property Description
launchId  
launchKey  
body.lis_outcome_service_url  
body.lis_result_sourcedid  
result.status The status or outcome of sending a score to the LTI (See LTI Status values below)
result.launchId The internal launch id returned
result.scoreSent The LTI score (null or a value 0 to 1) sent to an LTI as a replaceResult.
result.statusDetails Error information (may have a value of type object, otherwise expect null).
result.ltiAssessmentScoreId The internal lti assessment score ID
result.outcomeServiceURL This is the same as body.lis_outcome_service_url
result.gradebookStatus See LTI Gradebook Status values below

lti:pickerLaunch

Occurs when the LTI document picker was launched from a LMS (Tool Consumer).

Version
1.0.0

Properties

Property Description
ltiBody  
ltiConsumerKey  

Additional Information

LTI Status values:

Description Description
success The LTI replaceResult was sent successfully
not_attempted_no_outcome_service_for_launch The LTI did not have an outcome service so no replaceResult was attempted
not_attempted_score_is_null The assessment score was null so no replaceResult was attempted
not_attempted_preview_mode User is in preview mode so no replaceResult was attempted
error_replace_result_failed Fatal error - The replaceResult failed
error_no_assessment_score_found Fatal error - Obojobo was unable to find the assessment score to send.
error_no_secret_for_key Fatal error - There was no secret found for the given key
error_no_launch_found Fatal error - Obojobo was unable to find the LTI launch details
error_launch_expired Fatal error - The LTI launch has expired
error_score_is_invalid Fatal error - The score to be sent was not a 0-1 value.
error_unexpected Fatal error - An unexpected error occurred.

LTI Gradebook Status values:

Description Description
ok_null_score_not_sent The assessment score was null so no score was sent
ok_no_outcome_service The LTI did not have an outcome service so no replaceResult was attempted
ok_gradebook_matches_assessment_score Either the new assessment score was sent successfully or the assessment score being sent matches the last assessment score that was sent
ok_preview_mode User is in preview mode so no replaceResult was attempted
error_newer_assessment_score_unsent A newer score was not sent successfully so the LTI tool consumer does not have the latest score.
error_state_unknown Obojobo was not able to determine the history of what was sent to the LTI tool consumer so Obojobo can’t determine if the tool consumer should be sent a score or if it has the latest score.
error_invalid This is an unexpected state. This state is a fatal error.