Learner Activity Instance
Learner Activity Instance
Introduction
A Learner Activity Instance represents a specific learner’s interaction with a defined activity (often from xAPI data). For example, if the learner “viewed” a resource or “completed” a simulation, this record describes the verb, timestamps, and any success metrics.
Key highlights:
Verbs: Align with xAPI or custom actions like “accessed,” “analyzed,” “created.”
Parent & Grouping: Each instance can show its hierarchical relationship (e.g., it happened in Module 2, part of Curriculum X).
Scoring: For quick tasks or immediate feedback, you can track raw, scaled, or min/max scores.
Properties
NextActivityInstanceId / PreviousActivityInstanceId
(Optional) Helps chain together multiple activity instances if you need a sequence or flow.
ActivityDefinitionId
References the “Learning Activity Definition” that defines what this instance is about, such as a video or a quiz item.
ContactId
The learner who performed the activity.
ConnectedContactId
(Optional) Another learner or user who collaborated, e.g., in a group scenario.
VerbId / VerbName
Identifiers for what the learner did (e.g., “http://adlnet.gov/expapi/verbs/completed” and display “completed”).
StartTime / EndTime
Timestamps for when the learner began and finished the activity, helpful in measuring duration.
DurationSeconds
(Optional) A numeric measure of how long the learner spent. The system can compute this if you don’t provide an explicit EndTime.
FirstParentId, SecondParentId, FirstGroupingId, SecondGroupingId
Show the hierarchical or grouping context for the activity. For instance, the “parent” might be a module, while the “grouping” might be a big certification program.
ScoreResponse
If the activity was something that could be scored quickly, store the response text.
ScoreSuccess
A checkbox indicating if the learner succeeded or passed the activity.
ScoreScaled, ScoreRaw, ScoreMin, ScoreMax
Various numeric fields letting you track performance, such as a scaled score (0–1) or raw points.
XAPIStatementId
Links to the Learner XAPIStatement if the full statement is captured, ensuring a full audit trail.
CreatedDate
System-managed date/time of record creation.
ModifiedDate
Automatically updated date/time whenever any property changes.
Example
“John Doe” (Contact #123) “completed” (VerbName) the “Interactive Simulation: Customer Journey,” recorded with StartTime = 2:00 PM, EndTime = 2:20 PM, so DurationSeconds = 1200. The instance sets ScoreScaled = 0.9 and ScoreSuccess = true, meaning John performed well above the threshold.
Use Case
In a corporate training environment with heavy xAPI usage, every click or module completion is recorded as a Learner Activity Instance. Some are short “viewed” verbs, others are “completed” or “passed.” The system aggregates these records to see which resources are most popular or to identify who might need more support if they repeatedly fail.
Last updated