xAPI in Learning Manager

Letzte Aktualisierung: 2024-01-30

Was ist xAPI?

Die Experience API (xAPI) ist eine E-Learning-Softwarespezifikation, die es ermöglicht, dass Lerninhalte und Lernsysteme so miteinander kommunizieren, dass alle Arten von Lernerfahrungen aufgezeichnet und verfolgt werden. Lernerfahrungen werden in einem Learning Record Store (LRS) aufgezeichnet. LRS können in traditionellen Lernmanagementsystemen (LMS) oder eigenständig existieren.

Weitere Informationen zu xAPI finden Sie unter: https://github.com/adlnet/xAPI-Spec.

Wie unterstützt Learning Manager xAPI?

Learning Manager hat einen integrierten Learning Record Store. Dieser LRS kann xAPI-Anweisungen von Inhalten akzeptieren, die in Learning Manager gehostet wurden. Er akzeptiert sogar xAPI-Anweisungen von Drittanbietern. Diese xAPI-Anweisungen werden in Learning Manager gespeichert und können dann außerhalb von Learning Manager exportiert werden, um sie in einem beliebigen Data Warehousing-System eines Drittanbieters zu visualisieren.

Wann verwendet man xAPI?

In zunehmendem Maße müssen Lernerfahrungen des Endbenutzers erfasst werden, die sich über mehrere Systeme erstrecken. Es ist außerdem erforderlich, die genaue Interaktion des Teilnehmers mit den Schulungsinhalten zu verfolgen. Dies geht über „Start“, „Wird ausgeführt“ und „Abschluss“ hinaus (das sind die einzigen von SCORM erfassten Attribute).

Verwenden von xAPI im Lern-Manager

Anwendung einrichten

  1. Melden Sie sich als Integrationsadministrator an. Auswählen Anwendungen > Registrieren.

  2. Registrieren Sie eine neue Anwendung.

  3. Definieren Sie den Umfang für die Anwendung.

    • Wenn Administratorrolle – Lese- und Schreibzugriff für xAPI aktiviert ist, kann der Administrator xAPI-Anweisungen und -Dokumente veröffentlichen und abrufen.
    • Wenn Teilnehmerrolle – Lese- und Schreibzugriff für xAPI aktiviert ist, kann der Administrator xAPI-Anweisungen und -Dokumente veröffentlichen und abrufen.
  4. Speichern Sie die Änderungen. Sie erhalten Ihre Entwickler-ID und Ihr Geheimnis.

Endpunkte:

Klicken Sie auf den folgenden Link, um das xAPI-Swagger-Dokument anzuzeigen:

https://learningmanagereu.adobe.com/docs/primeapi/xapi/

Hinweis: Die in Learning Manager unterstützte xAPI-Version ist 1.0.3.

API-Authentifizierung

Learning Manager xAPI verwenden das OAuth 2.0-Framework zum Authentifizieren und Autorisieren Ihrer Clientanwendungen. Nachdem Sie die Anwendung registriert haben, können Sie clientId und clientSecret abrufen. Die Get-URL wird im Browser verwendet, da sie die Learning Manager-Benutzer mit ihren vorkonfigurierten Konten wie SSO oder Adobe ID authentifiziert.

GET https://learningmanager.adobe.com/oauth/o/authorize?client_id=<Enter your clientId>&redirect_uri=<Enter a url to redirect to>&state=<Any String data>&scope=<admin:xapi or learner:xapi>&response_type=CODE.

Verfolgen von xAPI-Anweisungen als Learning Manager LO

Als Autor können Sie nun ein xAPI-Modul auswählen, während Sie Kurse zur Überwachung der Benutzererfahrung außerhalb von Learning Manager erstellen. Sie können diese Funktion beispielsweise verwenden, um die Aktivitäten von Benutzern auf einer Plattform eines Drittanbieters zu bewerten, die für die Kursnutzung verwendet wird.

  1. Beim Erstellen eines Aktivitätsmodul in der Typ​Option wählen Sie im Popupmenü xAPI-basiertes Modul.

  2. Sie werden aufgefordert, einen IRI bereitzustellen. Wenn nicht angegeben, generiert Learning Manager automatisch einen.

    Der IRI für eine Aktivität ist für ein Konto eindeutig. Das bedeutet, dass zwei Module im Learning Manager nicht denselben IRI haben können. In folgenden Fällen wird ein neuer IRI generiert:

    • Wenn ein Kurs mit dem xAPI-Modul kontoübergreifend freigegeben wird.
    • Wenn eine Zertifizierung mit dem xAPI-Modul wiederholt wird.

    Jede xAPI-Anweisung mit dem genannten IRI wird im obigen Modul verfolgt und in den Learning Manager-Berichten widergespiegelt.

  3. Um die automatisch generierte IRI zu kopieren, besuchen Sie die Seite „Aktivitätsmodul“ erneut.

  4. Veröffentlichen Sie das Modul.

Zu beachtende Punkte:

  • Der Lern-Manager unterstützt derzeit nur mbox als Bezeichner. Andere Bezeichner wie mboz_sha1, openid, account werden nicht unterstützt.

  • Die stateId und profileId ist eine UUID, wenn sie mit dem Lern-Manager verwendet werden.

  • Die PUT-Anforderung überschreibt das Dokument nicht für xAPIs-Agenten/Profile, Aktivitäten/Profile und Aktivitäten/Status.

  • Nicht identifizierte Gruppen werden in Actor nicht unterstützt.

  • Der Parameter "related_activities" wird in der GET-Anweisung nicht unterstützt.

  • Die Parameter „format=ids' & 'format=canonical“ werden in GET-Anweisungen nicht unterstützt.

  • Durch die Annullierung der xAPI-Anweisung werden keine Aktionen rückgängig gemacht, die im Lern-Manager aufgetreten sind, als die Anweisung veröffentlicht wurde.

Berichte erstellen

xAPI-Berichte können als Excel-Berichte generiert werden. Öffnen Sie als Administrator Berichte > Excel-Berichte > xAPI-Aktivitätsbericht.

Der heruntergeladene Bericht ruft alle Informationen ab, die vom Teilnehmer und Administrator für eine Anweisung veröffentlicht wurden.

Dieselben Berichte können über FTP- und Box-Connectors für jede Integration von Drittanbietern erstellt/geplant werden. Führen Sie die folgenden Schritte aus:

Melden Sie sich als Integrationsadministrator an > Öffnen Sie den FTP/Box-Connector > Wählen Sie im linken Bereich den Bericht „xAPI-Aktivität“. > Wählen Sie, einen Bericht zu planen/zu generieren.

  • Wenn in der xAPI-Anweisung nur die vorläufige Punktzahl ohne die Höchstpunktzahl gesendet wird, zeigt LT die Quizpunktzahl nicht an.

  • Um die prozentuale Punktzahl in Learning Manager zu erhalten, werden skalierte Punktzahlen über xAPI gesendet.

Beispielbericht

xAPI-Beispielbericht.

Auf dieser Seite