Was dieser API-Endpunkt macht

Die Import Course Completion API bietet unterschiedliche Informationen, je nachdem, ob es sich um einen Articulate 360-Kurs oder um einen importierten Inhaltskurs eines Drittanbieters handelt. Bei allen Kursen sehen Administratoren, wann Benutzer für den Kurs angemeldet waren. Der Kurs wird den Bibliotheken der Lernenden hinzugefügt und als abgeschlossen markiert. Wenn er gestartet wird, beginnt er von vorne. Importierte Kurse enthalten keine Berichtsdaten auf Fragenebene.

In Kursen von Drittanbietern wird beim Import kein Quizergebnis angezeigt. Dies kann dazu führen, dass ein Kurs mit einem nicht bestandenen Quizergebnis als abgeschlossen markiert wird, auch wenn das Quiz eine Teilnahmevoraussetzung ist. Wenn Sie das Quiz nach dem Import abschließen, wird ein neues Quizergebnis aufgezeichnet.

Wenn Articulate 360-Kursabschlüsse importiert werden und es eine Quizanforderung gibt, wird diese auf eine Punktzahl von 100% gesetzt, die sich in der Bibliothek des Lernenden widerspiegelt. Die Lernenden sehen die Seite mit den Quizergebnissen, wenn sie sich das Quiz ansehen, und können das Quiz, sofern zulässig, erneut bearbeiten. Ihr Versuch wird im Aktivitätsbericht mit einem neuen Quizergebnis aufgezeichnet, der Status des Kurses und die Quizpunktzahl von 100% bleiben jedoch erhalten.

• Endpunkte
• Abschlussdaten importieren

Endpunkte

• POST /courses/{courseId}/users/{userId}/completions- Importiert Abschlussdaten für ein einzelnes Kurs-/Benutzerpaar in Rise.

Abschlussdaten importieren

POST /courses/{courseId}/users/{userId}/completions

Hinweise:

• Der Abschlussnachweis ist mit der aktuell veröffentlichten Version des Kurses verknüpft
• Die Datumsparameter werden in den Spalten Dauer verschiedener Berichte wiedergegeben (d. h. die Dauer eines importierten Abschlusses wird als Differenz zwischen startedAt und berechnetcompletedAt). Die Aktualisierung von Berichtsansichten in Reach 360 kann bis zu 5 Minuten dauern.
• Mehrere Aufrufe an diesen Endpunkt mit demselben courseId und überschreiben userId die in früheren Aufrufen angegebenen Datumsparameter (d. h. dieser Endpunkt erstellt nur einen einzigen Abschlussdatensatz für ein bestimmtes Kurs- und Benutzerpaar, unabhängig davon, wie oft er aufgerufen wird)
• Der Benutzer muss vor der Anfrage nicht für den Kurs angemeldet sein. In diesem Fall wird eine neue Teilnehmerregistrierung erstellt. Wenn sie jedoch angemeldet sind, wird die bestehende Anmeldung verwendet.

Anforderungsparameter (JSON)

• completedAt(ISO-8601-Datum, erforderlich) — wann der Benutzer den Kurs abgeschlossen hat
• startedAt(ISO-8601-Datum, erforderlich) — wann der Benutzer den Kurs gestartet hat

Erfolgreiche Antwort

202 „Akzeptiert“

Endpunktspezifische Fehlercodes:

• course_not_found
• course_not_published
• user_not_found