Einführung
Die xAPI-API (ehemals Tin Can API) ist eine E-Learning-Softwarespezifikation. Mit dieser Art von Software können Lerninhalte und Lernsysteme so miteinander kommunizieren, dass alle Arten von Lernerfahrungen aufgezeichnet werden, die dann in einem Learning Record Store (LRS) gespeichert werden. Ein LRS kann innerhalb herkömmlicher Lernmanagementsysteme oder eigenständig vorhanden sein.
Anforderungen und Einschränkungen
- Docebo unterstützt den Tin Can Standard 1.0.
- Die maximale Dateigröße beträgt 1024MB.
- Der Inhalt der xAPI (Tin Can API) muss als ZIP-Paket hochgeladen werden.
- Docebo LRS arbeitet paarweise mit Docebo Learn zusammen. Um die von den Benutzern abgeschlossenen Aktivitäten mit dem Kursfortschritt verknüpfen zu können, müssen sie die in der xAPI-Anweisung übergebene Aktivitäts-ID erkennen. Damit der LRS diese Aktivitäts-IDs erkennt, laden Sie xAPI-Pakete mit einem geeigneten tincan.xml-Deskriptor hoch.
- Sie können xAPI/TinCan-Inhalte in E-Learning-, ILT (Instructor-Led Training)- und VILT (Virtual Instructor-Led Training)-Kurse hochladen.
Hochladen von xAPI-Paketen
Sie können ein xAPI-Paket von Ihrem Gerät oder über einen externen Link hochladen. Melden Sie sich zunächst als Superadmin oder als Lehrer bei Ihrer Plattform an.
Suchen Sie im Admin-Menü (das Zahnradsymbol in der oberen rechten Ecke Ihrer Plattform) das Element Kursverwaltung im Abschnitt E-Learning. Suchen Sie nach dem Kurs, für den Sie die xAPI-Schulungsunterlagen hochladen möchten, klicken Sie auf seine Beschreibung und wechseln Sie dann zur Registerkarte Schulungsunterlagen.
Wählen Sie hier die Schaltfläche Schulungsunterlagen hinzufügen und dann xAPI (Tin Can) aus dem Dropdown-Menü aus.
Auf der Upload-Seite gibt es drei Registerkarten: xAPI (Tin Can), Zusatzinfo und Erweiterte Sicherheit. Wählen Sie auf der Registerkarte Tin Can die Option Datei hochladen aus, um die xAPI-Datei (Tin Can API-Datei) von Ihrem Gerät auszuwählen, und legen Sie fest, ob Sie alle Aktivitäten im Paket verfolgen möchten. Wenn diese Option aktiviert ist (dies ist die Standardeinstellung), verfolgt die Plattform alle Aktivitäten, einschließlich Unteraktivitäten. Auf diese Weise wird beim Abschließen des ersten Moduls der Tin Can-Schulungsunterlage (beachten Sie, dass eine Tin Can-Schulungsunterlage aus mehreren Modulen besteht) die gesamte Tin Can als abgeschlossen markiert. Wenn die Option Alle Aktivitäten verfolgen nicht ausgewählt ist, werden nur die Hauptaktivitäten des Pakets verfolgt, und alle Module müssen abgeschlossen sein, damit die Tin Can als abgeschlossen markiert wird.
Die Plattform identifiziert Tin Can-Inhalte als abgeschlossen, wenn die Lernenden auf die Schaltfläche Schließen (auch Beenden oder Senden genannt) klicken. Das Nichtbetätigen dieser Schaltfläche kann dazu führen, dass der Lernfortschritt nicht vom Tin Can-Paket an die Plattform gesendet und der Tin Can-Inhalt nicht als abgeschlossen markiert wird. Aus diesem Grund ist es sehr empfehlenswert, einen Abschlussbildschirm in Ihre Tin Can-Pakete aufzunehmen, der angezeigt wird, wenn das Tin Can-Paket bestätigt, dass Nachverfolgungsdaten übertragen wurden, um die Schaltfläche Schließen auf diesem Bildschirm anzuzeigen.
Während die Datei hochgeladen wird, wechseln Sie zur Registerkarte Zusatzinfo, um eine kurze Beschreibung für Ihre Datei einzugeben und eine Miniaturansicht auszuwählen. Sie können den Titel oder die Miniaturansicht der Schulungsunterlage später nach Bedarf ändern.
Sie können Ihren Schulungsunterlagen auch Tags hinzufügen, um die Durchsuchbarkeit in der globalen Suche Ihrer Plattform zu verbessern. Wenn die Auto-Tagging-Funktion in Ihrer Plattform aktiviert ist, können einige Tags automatisch basierend auf dem Inhalt Ihrer Schulungsunterlage automatisch generiert werden, wie sie von Ihrer Plattform mithilfe künstlicher Intelligenz verstanden wird (beachten Sie, dass dies nur für englische, spanische, französische, deutsche, italienische und portugiesische Inhalte funktioniert). Sie können Tags jederzeit bearbeiten oder entfernen, mit einer Begrenzung von 15 Tags pro Schulungsunterlage und 32 Zeichen pro Tag (erfahren Sie mehr über Tag-fähige Inhaltstypen). Bitte beachten Sie, dass die künstliche Intelligenz der Plattform aus Sicherheitsgründen nicht auf private Inhalte (d.h. Inhalte, für deren Zugriff eine Authentifizierung erforderlich ist) zugreift und daher nur für öffentliche Inhalte automatisch Tags generieren kann. Beim Hochladen privater Inhalte empfehlen wir Ihnen, Tags manuell hinzuzufügen.
Bitte beachten: Die automatische Tagging-Funktion kann auf Probleme stoßen, wenn xAPI-Schulungsunterlagen verarbeitet werden, die durch die Verwendung bestimmter Authoring-Tools erstellt wurden, die Textinhalte direkt in Programmierdateien einbetten und Bilder so komprimieren, dass ihre Qualität keine optische Zeichenerkennung (OCR) zulässt.
Wir arbeiten derzeit daran, dieser Einschränkung entgegenzuwirken, indem wir mit einigen großen Anbietern von Authoring-Tools zusammenarbeiten.
Wenn Sie fertig sind, klicken Sie auf Änderungen speichern. Wenn das Dateiformat korrekt ist, wird das xAPI-Paket als Kursunterlage hochgeladen und oben links auf Ihrem Bildschirm wird eine Meldung angezeigt.
Verknüpfen von xAPI-Inhalten als Schulungsunterlage
Als Option zum Hochladen von xAPI-Inhalten in einen Kurs können Sie diese von einer externen URL aus verlinken. In einem ersten Schritt müssen Sie auf der Plattform eine vordefinierte Liste von Quell-URLs erstellen. Dieser Schritt stellt sicher, dass die Plattform die Inhalte für Lernende abspielen kann. Rufen Sie dazu das Admin-Menü auf und wählen Sie dann die Option Erweiterte Einstellungen im Abschnitt Einstellungen. Greifen Sie dann auf die Registerkarte E-Learning zu.
Fügen Sie im Textfeld des Bereichs Externer xAPI (Tin Can)-Inhalt die URL der Schulungsunterlage hinzu. Sie können bis zu 20 URLs hinzufügen.
Um weitere URLs zu unterstützen, verwenden Sie eine Wildcard-Domain. Geben Sie beispielsweise http://www.domain.com/*
ein, ohne den Dateinamen oder die Erweiterung des Inhalts anzugeben, und fügen Sie ein Sternchen (*) am Ende der URL hinzu. Wenn Sie einem Kurs Schulungsunterlagen hinzufügen, können Sie dann den Namen und die Erweiterung der Datei für die einzelnen Schulungsunterlagen angeben (z.B., file_name_1.zip
nach der Domain). Beachten Sie bitte, dass Wildcard-Domains manuell hinzugefügt werden müssen, es ist nicht möglich, sie über die API hinzuzufügen.
Dadurch zählt die von Ihnen eingegebene Domain als eine der 20 erlaubten URLs, aber Sie können mehr als 20 externe xAPI-Inhalte hinzufügen.
Klicken Sie auf Hinzufügen, um die Domain zu bestätigen. Es erscheint dann in der Liste unten.
Um einer URL ein Salt-Secret hinzuzufügen, klicken Sie auf das Schlosssymbol am Ende der Zeile der URL. Geben Sie dann das Salt-Secret ein, bestätigen Sie es und drücken Sie das Häkchen.
Wenn Sie das Salt-Secret nicht hinzufügen, wird der Inhalt von dem Drittanbieter wie normaler, von Ihrer Plattform gestarteter xAPI-Inhalt behandelt. Durch die Bereitstellung des Salt-Secrets wird jedoch eine Prüfsumme generiert, die den Start des Inhalts bestätigt, sodass der Drittanbieter die Authentizität des Inhalts bestätigen kann.
Wenn Sie fertig sind, drücken Sie Speichern.
Nachdem Sie die URLs hinzufügen, kehren Sie zur Registerkarte Schulungsunterlagen. Wählen Sie dann xAPI (Tin Can) aus dem Dropdown-Menü Schulungsunterlagen hinzufügen aus. Markieren Sie auf der Upload-Seite die Option Von URL. Wählen Sie dann eine URL aus dem Dropdown-Menü URL auswählen aus. Hier finden Sie alle URLs, die Sie im vorherigen Schritt hinzugefügt haben.
Wenn Sie eine Wildcard-Domain auswählen, die den Namen und die Erweiterung der Datei nicht enthält, wird das Feld Zusätzlicher Pfad unter dem Feld URL auswählen angezeigt, sodass Sie den Namen und die Erweiterung der Schulungsunterlage eingeben können.
Bitte beachten: Sie können den Ordner oder den Unterordner, in dem sich Ihre Datei befindet, entweder im Feld URL auswählen oder im Feld Zusätzlicher Pfad hinzufügen, was Ihnen eine beträchtliche Flexibilität beim Hochladen Ihrer xAPI-Schulungsunterlagen verschafft.
Geben Sie einen Titel und eine Beschreibung für den Inhalt in die entsprechenden Textfelder ein. Entscheiden Sie anschließend, ob Sie alle Aktivitäten im Paket verfolgen möchten. Wenn Sie diese Option aktivieren (dies ist die Standardeinstellung), verfolgt die Plattform alle Aktivitäten, einschließlich Unteraktivitäten. Wenn Sie die Option deaktivieren, werden nur die Hauptaktivitäten des Pakets verfolgt.
Wechseln sie zur Registerkarte Zusatzinfo. Geben Sie eine kurze Beschreibung für Ihre Datei ein und wählen Sie ein Miniaturbild aus. Sie können Ihre Schulungsunterlagen auch Tags hinzufügen, um die Durchsuchbarkeit in der globalen Suche Ihrer Plattform zu verbessern. Wenn die Auto-Tagging-Funktion in Ihrer Plattform aktiviert ist, können einige Tags automatisch basierend auf dem Inhalt Ihrer Schulungsunterlage automatisch generiert werden, wie sie von Ihrer Plattform mithilfe künstlicher Intelligenz verstanden wird (beachten Sie, dass dies nur für englische, spanische, französische, deutsche, italienische und portugiesische Inhalte funktioniert). Sie können Tags jederzeit bearbeiten oder entfernen, mit einem Limit von 15 Tags pro Schulungsunterlage (erfahren Sie mehr über Tag-fähige Inhaltstypen). Bitte beachten Sie, dass die künstliche Intelligenz der Plattform aus Sicherheitsgründen nicht auf private Inhalte (d.h. Inhalte, für deren Zugriff eine Authentifizierung erforderlich ist) zugreift und daher nur für öffentliche Inhalte automatisch Tags generieren kann. Beim Hochladen privater Inhalte empfehlen wir Ihnen, Tags manuell hinzuzufügen.
Wechseln Sie zuletzt zur Registerkarte Erweiterte Sicherheit, wählen Sie die Option zum Hinzufügen eines OAuth-Codes zur Start-URL und wählen Sie dann den OAuth-Client aus dem entsprechenden Dropdown-Menü aus. Drücken Sie dann Änderungen speichern, um Ihre Schulungsunterlagen zu erstellen.
Verwalten der Schulungsunterlage-Einstellungen
Nachdem die Schulungsunterlage hochgeladen wurde, können Sie ihre Einstellungen wie im Artikel Verwalten von Einstellungen und Voraussetzungen für Schulungsunterlagen beschrieben verwalten.
Bewährte Verfahren
- Wenn Sie Ihr xAPI-Paket (Tin Can) aus der Ferne verfolgen möchten, müssen Sie das Paket direkt auf Ihre Plattform hochladen. Ihre Docebo-Plattform unterstützt kein vollständig anonymes Tracking. Wenn Sie xAPI (Tin Can)-Anweisungen an unsere Plattform senden möchten, können Sie dies über das folgende Linkformat tun:
https://www.lmsaddress.com/tcapi/
. Darüber hinaus müssen Benutzer über eine gültige E-Mail-Adresse verfügen, die mit ihrem Konto verknüpft ist, damit die Plattform Tracking-Daten für xAPI-Schulungsunterlagen speichern kann. Sie können zwar xAPI-Pakete (Tin Can) direkt in die zentrale Ablage hochladen, wir empfehlen jedoch, sie direkt in einen Kurs hochzuladen. Sie können sie bei Bedarf nach dem Hochladen in den Kurs in die zentrale Ablage verschieben. - Der einzige Ort, an dem xAPI-Inhalte aktualisiert werden können, ist über die zentrale Ablage.