Haftungsausschluss zur Sandbox-Veröffentlichung: Einige Inhalte in diesem Artikel beschreiben, wie Funktionen verwendet werden, die Ende April 2026 für alle Kunden öffentlich freigegeben werden. Wenn Sie Unterschiede zwischen diesem Artikel und Ihrer Plattform feststellen, schauen Sie zu diesem Zeitpunkt erneut vorbei. Erfahren Sie mehr über den Veröffentlichungszyklus.

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 2GB.
• 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 (Schulung mit Lehrer)- und VILT (virtuelle Schulung mit Lehrer)-Kurse hochladen.

Hochladen von xAPI-Paketen

Sie können ein xAPI-Paket von Ihrem Gerät oder über einen externen Link hochladen.

Wir empfehlen, xAPI-Pakete von der Seite für Schulungsunterlagen hochzuladen, da Sie diese so in mehreren Kursen wiederverwenden können. Sie können xAPI-Pakete auch direkt innerhalb eines Kurses hochladen: siehe Hochladen von xAPI-Inhalten (ehemals Tin Can API).

Hochladen von xAPI-Dateien von der Seite für Schulungsunterlagen

Um auf die Seite für Schulungsunterlage zuzugreifen, melden Sie sich als Superadmin oder Power User an, öffnen Sie das Admin-Menü über das Zahnrad-Symbol oben rechts auf Ihrer Plattform und klicken Sie dann im E-Learning Abschnitt auf Schulungsunterlagen (ehemals Zentrale Ablage).

Wählen Sie im linken Bereich den Ordner aus, in den Sie die Dateien hochladen möchten, und klicken Sie dann auf die + Neu Schaltfläche. Das Dropdown-Menü zeigt zwei Optionen für xAPI:

• xAPI von Datei: Laden Sie ein oder mehrere xAPI-Pakete von Ihrem Gerät hoch, indem Sie die folgenden Schritte befolgen.
• xAPI von URL: Verknüpfen Sie ein xAPI-Paket über eine externe URL. Siehe Hochladen von xAPI-Dateien innerhalb eines Kurses für Anweisungen.

Sie können diesen Upload auch vom Inhaltscenter aus starten: Öffnen Sie das Admin-Menü über das Zahnrad-Symbol oben rechts auf Ihrer Plattform und klicken Sie dann im E-Learning Abschnitt auf Inhaltscenter. Klicken Sie auf die + Neu Schaltfläche und wählen Sie xAPI von Datei.

Um xAPI-Dateien von Ihrem Gerät hochzuladen:

1. Wählen Sie bis zu 20 ZIP-Dateien zum Hochladen aus. Jede Datei kann bis zu 2 GB groß sein.
2. Wenn Sie vom Inhaltscenter hochladen, wählen Sie den Zielordner im rechten Bereich aus.
3. Sobald der Upload startet, erscheint ein Bereich in der oberen rechten Ecke des Bildschirms. Wenn Sie ihn schließen, können Sie ihn durch Klicken auf das Wolken-Symbol (Uploads) oben rechts wieder öffnen. Der Bereich zeigt den Echtzeitstatus für jede Datei.
4. Sie können sich während des Uploads frei innerhalb der Plattform bewegen. Beachten Sie, dass das Aktualisieren der Seite oder das Schließen des Tabs alle laufenden Uploads unterbricht. Der Browser zeigt eine Bestätigungs-Popup an, bevor Sie die Seite verlassen.
5. Um einen bestimmten Upload abzubrechen, klicken Sie auf das X neben der Datei im Bereich. Um alle laufenden Uploads abzubrechen, klicken Sie auf Abbrechen im Bereich.
6. Nach Abschluss des Uploads können Sie auf den Dateinamen klicken, um zur Bearbeitungsseite des Trainingsmaterials zu gelangen, oder auf das Ordnersymbol klicken, um zu dem Ordner zu navigieren, in dem die Datei gespeichert wurde.

Hochladen von xAPI-Dateien innerhalb eines Kurses

Obwohl Sie xAPI-Pakete direkt innerhalb eines Kurses hochladen können, empfehlen wir die Nutzung der Seite für Schulungsunterlagen, da diese den Massen-Upload unterstützt und die Wiederverwendung in mehreren Kursen ermöglicht.

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 automatische Tag-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 die Inhaltstypen, die das Auto-Tagging ermöglichen). 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.

Nachdem der Upload abgeschlossen ist, gelangen Sie auf die Registerkarte Schulungsunterlagen. Klicken Sie auf das Menüsymbol am Ende der Zeile der xAPI-Schulungsunterlage und wählen Sie dann Einstellungen, um die Schulungsunterlage zu konfigurieren. Beachten Sie bei der Einstellung des Ansichtsmodus, dass im Theatermodus die Lernenden ihre Mikrofone nicht benutzen können. Wenn Ihr xAPI-Inhalt den Zugriff auf ein Mikrofon erfordert, empfehlen wir, stattdessen die Option In neuem Fenster anzeigen zu wählen.

Verknüpfen von xAPI-Inhalten als Schulungsunterlage

Als Option zum Hochladen von xAPI-Inhalten von Ihrem Gerät können Sie diese von einer externen URL verlinken. Als erster Schritt müssen Sie eine vordefinierte Liste von Quell-URLs auf der Plattform erstellen. 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 Quell-URLs eingerichtet haben, navigieren Sie zur Seite Schulungsunterlagen. Wählen Sie im linken Bereich den Ordner aus, in den Sie den Inhalt hinzufügen möchten, klicken Sie dann auf die Schaltfläche + Neu und wählen Sie xAPI von URL. Dies können Sie auch im Inhaltszentrum tun. In diesem Fall müssen Sie den Zielordner im ausklappbaren Bereich auswählen.

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 automatische Tag-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 die Inhaltstypen, die das Auto-Tagging ermöglichen). 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.

Sie können xAPI-Inhalte auch innerhalb eines Kurses verlinken: Navigieren Sie zur Registerkarte Schulungsunterlage des entsprechenden Kurses, klicken Sie auf Schulungsunterlage hinzufügen, wählen Sie xAPI (Tin Can) aus, dann die Option Von URL und folgen Sie den gleichen Schritten ab der Auswahl einer URL.

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.
• Wir empfehlen, Ihre xAPI-Schulungsunterlagen auf der Seite Schulungsunterlagen hochzuladen und zu verwalten, wo Sie mehrere Dateien gleichzeitig hochladen und sie in mehreren Kursen wiederverwenden können.