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
| Property Name | Description |
|---|---|
| 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.