SCORM-Inhaltspakete über die Learn365-API abschließen

Einführung

In diesem Artikel wird beschrieben, wie Sie mit den Learn365-APIs den Fortschritt eines SCORM-Inhaltspakets auf Completed ändern können.

Relevante SCORM-Daten per API abrufen

1. Gehen Sie zu https://api.365.systems/, und autorisieren Sie sich mit dem entsprechenden API-Schlüssel. Weitere Informationen zum Autorisierungsprozess finden Sie in diesem Artikel.

2. Für eine Anfrage zum Ändern des Abschlussstatus eines SCORM-Inhaltspakets müssen Sie die Benutzer-ID, die Registrierungs-ID und die ID des relevanten SCORM-Inhaltspakets abrufen. 

Um diese Daten zu erhalten:

• Suchen Sie den Abschnitt Courses, erweitern Sie ihn, suchen Sie die GET-Methode /odata/v2/Courses mit der Beschreibung Returns the list of Courses und wählen Sie Try it out aus.
   
• Geben Sie im Feld $expand Enrollments, Scorms ein, damit die Antwort Daten zu den Registrierungen der Benutzer und zu SCORM-Inhaltspaketen innerhalb von Kursen enthält.
   
• Wählen Sie Execute, um die Anforderung auszuführen.

3. Gehen Sie zum Responses-Block, um die Ergebnisse einzusehen.

• Die Zahl 2xx (beispielsweise "200") unter Code zeigt an, dass die Anfrage korrekt funktioniert hat. Sie können die Daten aus der Antwort über Download im .JSON-Format auf Ihren Computer herunterladen.
• Im Feld Response body sehen Sie alle Kurse des Tenants, die SCORM-Inhaltspakete enthalten, die zugehörigen Daten zu diesen SCORMs (einschließlich ihrer IDs) sowie Daten zu Benutzern, die in den Kursen registriert sind (einschließlich ihrer Benutzer-ID und Registrierungs-ID). Suchen Sie mit Strg+F nach dem relevanten SCORM oder dem relevanten Benutzer.

4. Rufen Sie die ID eines SCORM-Inhaltspakets neben dem Parameter Id unter Scorms ab.

5. Rufen Sie die ID des Benutzers sowie die ID seiner Registrierung neben den Parametern UserId bzw. Id unter Enrollments ab.

Einen SCORM per API abschließen

Wenn die erforderlichen Daten erfasst sind, können Sie eine Anfrage ausführen, um den Status des relevanten SCORM-Inhaltspakets für die betreffende Benutzerin bzw. den betreffenden Benutzer auf „abgeschlossen“ zu setzen.

• Suchen Sie den Abschnitt Courses, erweitern Sie ihn, suchen Sie die GET-Methode /odata/v2/Courses mit der Beschreibung Returns the list of Courses, und wählen Sie Try it out aus.
   
• Geben Sie im Feld $expand Enrollments, Scorms ein, damit die Antwort Daten zu den Registrierungen der Benutzerinnen und Benutzer sowie zu SCORM-Inhaltspaketen innerhalb von Kursen enthalten kann.
   
• Wählen Sie Execute aus, um die Anfrage auszuführen.

1. Suchen Sie den Abschnitt ScormAttempts, erweitern Sie ihn, suchen Sie die POST-Methode /odata/v2/ScormAttempts mit der Beschreibung Creates new scorm attempt, und wählen Sie Try it out aus.

2. Füllen Sie die Felder aus und beachten Sie dabei die erforderlichen Parameter:

• Id, ein erforderlicher Parameter. Ersetzen Sie guid durch die ID der Benutzerin bzw. des Benutzers.
• ScormId, ein erforderlicher Parameter. Ersetzen Sie guid durch die ID des SCORM-Inhaltspakets.
• EnrollmentId, ein erforderlicher Parameter. Ersetzen Sie guid durch die Registrierungs-ID der Benutzerin bzw. des Benutzers.
• CompletionStatus, in diesem Fall ein erforderlicher Parameter. Ersetzen Sie boolean durch true, um SCORM auf „abgeschlossen“ zu setzen.
• SuccessStatus, in diesem Fall ein erforderlicher Parameter. Ersetzen Sie boolean durch true, um SCORM auf „erfolgreich abgeschlossen“ zu setzen.
• Points, ein optionaler Parameter. Ersetzen Sie integer durch eine ganze Zahl von Punkten, die der Benutzerin bzw. dem Benutzer gutgeschrieben werden sollen. Dies wird in der Spalte Bewertung angezeigt, wenn Sie die Details der Lernenden für ein Inhaltspaket anzeigen.
• Scale, ein optionaler Parameter. Dies ist die finale Bewertung des SCORM. Ersetzen Sie number durch den Dezimalanteil einer nichtnegativen reellen Zahl (z. B. 0,89), den Learn365 mit 100 multipliziert und in einen Prozentsatz umwandelt (0,89 wird zu 89 %). Derselbe Prozentsatz wird in der Spalte Bewertung im Fortschrittsdashboard der Benutzerin bzw. des Benutzers und in der Spalte Scale angezeigt, wenn Sie die Details der Lernenden für ein Inhaltspaket anzeigen.
• Fortschritt, ein optionaler Parameter. Dies wird von SCORM 1.2 nicht unterstützt. Ersetzen Sie number durch den entsprechenden Statusindikator: 1 für nicht gestartet, 2 für fehlgeschlagen, 3 für in Bearbeitung oder 4 für bestanden. Der Fortschritt wird als Prozentsatz in der Spalte Fortschritt im Fortschritts-Dashboard des Benutzers angezeigt.
• AlternateFortschritt, ein optionaler Parameter. Dies sollte verwendet werden, wenn im SCORM nur SCOs vorhanden sind. Ersetzen Sie number durch eine ganze Zahl, die die Anzahl der SCOs im SCORM darstellt. Der Fortschritt wird als Prozentsatz in der Spalte Fortschritt im Fortschritts-Dashboard des Benutzers angezeigt.
• Version, ein optionaler Parameter. Ersetzen Sie integer durch eine ganze Zahl, die der Version des Inhaltspakets entspricht, die Sie für den Benutzer als abgeschlossen festlegen möchten.
• CreatedAt, ein optionaler Parameter. Standardmäßig wird das aktuelle Datum und die aktuelle Uhrzeit verwendet, dies kann jedoch manuell geändert werden.
• ModifiedAt, ein optionaler Parameter. Standardmäßig wird das aktuelle Datum und die aktuelle Uhrzeit verwendet, dies kann jedoch manuell geändert werden.
• StateDetails, ein optionaler Parameter. Hier können Sie Details zum Versuch des Benutzers konfigurieren.

3. Wenn Sie bereit sind, wählen Sie Execute aus, um die Anfrage auszuführen.

4. Gehen Sie zum Block Responses , um die Ergebnisse zu kontrollieren.

• Die Zahl 2xx (beispielsweise „200“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat. Über Download können Sie die Daten aus der Antwort im JSON-Format auf Ihren Computer herunterladen.
• Im Feld Response body sehen Sie Daten zum SCORM-Abschluss. Sie können den Abschluss des SCORM für die Lernende/den Lernenden im Learn365 Admin Center > einen Katalog auswählen > Benutzer und Gruppen > Benutzer > Lernendenfortschritt anzeigen > prüfen: Suchen Sie den relevanten Kurs, der das SCORM enthält, und prüfen Sie den Fortschritt der Lernenden/des Lernenden darin.