Dokumente/SCORM-Integration/Fortschrittsverfolgung

SCORM-Fortschrittsverfolgung

SecureCodingHub meldet den Schulungsfortschritt über SCORM zurück an Ihr LMS. Verfolgen Sie Abschluss, Punkte und Sitzungszeit.

Wie der Fortschritt gemeldet wird

SecureCodingHub implementiert sowohl SCORM 1.2 als auch SCORM 2004 (3. und 4. Edition) Berichtsmodelle, sodass dasselbe Inhaltspaket in jedem LMS läuft, das dem Standard entspricht. Während einer aktiven Sitzung tauscht der Player Laufzeitdaten mit dem LMS über den SCORM-API-Adapter aus, den das LMS beim Start injiziert, und dieser Austausch erzeugt die vier Datenpunkte, die Ihre Administratoren in ihrem Notenbuch oder Abschlussbericht sehen. Die unten aufgeführten Felder sind das kanonische Set, das wir bei jedem Commit schreiben; bestimmte LMS-Anbieter zeigen sie unter verschiedenen Spaltenbeschriftungen, aber die zugrunde liegenden Werte sind identisch.

Wenn ein Lernender die Schulung abschließt, sendet die SCORM-Brücke die folgenden Daten zurück an das LMS:

  • Abschlussstatus (unvollständig → abgeschlossen)
  • Punktzahl (0-100)
  • Sitzungszeit
  • Lesezeichen zum Fortsetzen

Jedes davon wird einem bestimmten SCORM-Datenmodellelement zugeordnet. Der Abschlussstatus schreibt in cmi.completion_status in SCORM 2004 und in cmi.core.lesson_status in SCORM 1.2. Die Punktzahl schreibt in beiden Versionen in cmi.score.raw, mit dem skalierten Äquivalent in cmi.score.scaled nur in 2004 (1.2 hat kein skaliertes Feld). Die Sitzungszeit akkumuliert in cmi.session_time im ISO 8601 Dauerformat, und das Lesezeichen zum Fortsetzen wird in cmi.suspend_data serialisiert. Die Brücke übergibt diese Elemente bei jedem Heartbeat-Tick während einer aktiven Sitzung erneut, sodass eine unterbrochene Sitzung dennoch einen teilweise gemeldeten Status erzeugt, den das LMS anzeigen kann.

Abschlusskriterien

Eine SCORM-Sitzung wird als abgeschlossen markiert, wenn der Lernende jede obligatorische Zuweisung in seiner Organisation beendet hat oder — wenn keine obligatorischen Zuweisungen ausstehen — sobald er einen aufgezeichneten Fortschritt hat. Der Schwellenwert ist heute nicht pro Zuweisung oder pro Paket konfigurierbar; dieselbe Logik wird in jedem von der Plattform generierten SCORM-Paket ausgeliefert.

SCORM 2004 unterscheidet zwischen Abschluss (hat der Lernende die Aktivität beendet) und Erfolg (hat er bestanden). Die Brücke meldet beides: cmi.completion_status spiegelt wider, ob die Aktivität beendet ist, und cmi.success_status spiegelt wider, ob der durchschnittliche Bestehensschwellenwert erreicht wurde. SCORM 1.2 hat keine separate Abschluss-/Erfolgs-Aufteilung — die Brücke schreibt passed oder failed in cmi.core.lesson_status, sobald der Abschluss wahr ist, und sonst incomplete.

Punkteberechnung

Die Punktzahl, die das LMS erhält, wird serverseitig aus dem Übungsfortschritt des Lernenden berechnet. Die interne Punkteskala läuft von 0 bis 160 pro Challenge (Phase 1 + Phase 2, wobei beide Phasen bei einem ersten Versuch ohne Hinweise mit bis zu 100 bewertet werden). Um eine SCORM-freundliche 0–100-Zahl zu erzeugen, mittelt die Brücke die Übungspunkte über die abgeschlossenen Challenges des Lernenden und dividiert durch 1,6, dann begrenzt sie das Ergebnis bei 100. Die Transformation ist fest; es gibt keine Gewichtung pro Paket oder pro Zuweisung in dieser Version.

MetrikWie sie berechnet wird
Rohpunktzahlmin(avg(challengeScores) / 1.6, 100)
Maximalpunktzahl100
Minimalpunktzahl0
Bestehensgrenze70 (hartkodiert im Launcher; nicht pro Paket konfigurierbar)

Fortsetzen / Anhalten

Wenn ein Lernender die Sitzung vor Abschluss schließt:

  • Aktuelle Position wird als Lesezeichen gespeichert
  • Nächster Start setzt vom Lesezeichen fort
  • Sitzungs-Heartbeat hält die Sitzung während aktiver Nutzung am Leben

Das vollständige Lesezeichen — welches Thema der Lernende hatte, welche Challenge, welche Phase, welche Hinweise er aufgedeckt hatte — liegt serverseitig auf dem SecureCodingHub-Sitzungseintrag, nicht innerhalb des SCORM-Pakets. Was die Brücke tatsächlich in cmi.suspend_data ablegt, ist ein kleiner JSON-Umschlag, der nur die SecureCodingHub-Sitzungs-ID enthält (zum Beispiel {"sid":"..."}); beim Fortsetzen liest die Brücke diese ID zurück, ruft den SecureCodingHub-Sitzungsendpunkt auf und verwendet den serverseitigen Zustand, um den Player neu zu hydratisieren. Das LMS hält daher nie Challenge-Inhalte, Antwortverlauf oder Hinweiszustand.

SCORM erzwingt eine 64KB-Obergrenze für cmi.suspend_data in der 1.2-Spezifikation und effektiv das gleiche Limit in vielen 2004-Implementierungen. Da die Brücke nur eine Sitzungs-ID zurück an das LMS schreibt, bleibt die Suspend-Nutzlast deutlich unter einem Kilobyte, unabhängig davon, wie lang die Zuweisung ist oder wie oft der Lernende anhält und fortsetzt.

Heartbeat

Während der Lernende den SCORM-Player geöffnet hat, sendet der Launcher alle 60 Sekunden einen Heartbeat an das SecureCodingHub-Backend bei POST /api/sch/scorm/heartbeat, der die Sitzungs-ID, das aktuelle Lesezeichen und die akkumulierte Sitzungszeit enthält. Derselbe Tick übergibt das SCORM-Datenmodell auf der LMS-Seite erneut, sodass Abschluss, Punkte, Sitzungszeit und Suspend-Daten synchronisiert bleiben, ohne auf explizite Speicherereignisse warten zu müssen.

EinstellungWert
IntervallAlle 60 Sekunden während einer aktiven Sitzung
EndpointPOST /api/sch/scorm/heartbeat
Nutzlast{"sessionId":"…","lmsBookmark":"…","sessionTime":"…"}
ZweckVerhindert das Timeout der LMS-Sitzung und aktualisiert Abschluss / Punkte / Suspend-Daten auf beiden Seiten

Fortschritt anzeigen

Administratoren können SCORM-Sitzungen einsehen von:

1

SecureCodingHub-Administrator-Panel → SCORMAktive Sitzungen

2

LMS-Notenbuch / Abschlussberichte

Die SecureCodingHub-Administratoransicht ist die Quelle der Wahrheit für feingranulare Analytik: Versuche pro Challenge, Hinweisnutzung, Zeit pro Aufgabe und die spezifischen Abhilfemaßnahmen, die der Lernende gewählt hat. Das LMS-Notenbuch sieht die SCORM-Zusammenfassung — Abschluss, Punkte, Sitzungszeit — und ist die richtige Oberfläche für Compliance-Berichte und Zertifikatsausstellung, aber es hat keine Sichtbarkeit für die zugrunde liegenden Schritt-für-Schritt-Daten. Die meisten Administratoren verwenden beide Ansichten zusammen: das LMS für die Berichterstattung "hat der Lernende beendet und bestanden" und das SecureCodingHub-Dashboard für Entscheidungen "wo kämpft die Kohorte und was sollten wir anpassen". Für den tieferen Analytik-Workflow und wie man Administratorrollenberechtigungen im Dashboard einrichtet, siehe unsere Administrator-Dashboard-Dokumentation und den Begleiter Rollen- und Berechtigungsanleitung.

xAPI-Emission steht auf der Roadmap und ist heute nicht verfügbar. Wenn es ausgeliefert wird, kann SecureCodingHub dieselben Ereignisse pro Challenge (Hinweisaufdeckungen, falsche Versuche, Challenge-Übergänge) zusätzlich zu den SCORM-Commits an einen Learning Record Store senden. Bis dahin ist das SCORM-Commit-Set die einzige sofort verfügbare LMS-Oberfläche, und das SecureCodingHub-Administrator-Dashboard ist der einzige Ort, an dem die Granularität pro Ereignis zu sehen ist.

Separate Verfolgung: Der SCORM-Fortschritt ist vom nativen SecureCodingHub-Fortschritt getrennt. Für die detaillierteste Analytik verwenden Sie das SecureCodingHub-Administrator-Dashboard.