System Status
  1. Hilfecenter
  2. REST API, Power BI und Power Automate
  3. Erstellen und löschen über API

SCORM-Inhaltspaket per API an einen Kurs oder ein Lernmodul anhängen

Avatar

Sie können ein SCORM-Inhaltspaket an einen Learn365-Kurs oder ein Lernobjekt in einem Learn365-Kurs anhängen. Dies geschieht wahlweise im Learn365 Admin Center oder direkt über die Endpunkte in der Learn365-API.

Dieser Artikel beschreibt, wie Sie ein SCORM-Inhaltspaket über Postman an einen Kurs in Learn365 anhängen bzw. mithilfe der Learn365-API in Swagger an ein Lernmodul anhängen.

 

In diesem Artikel

 

SCORM-Inhaltspaket an einen Kurs anhängen

HINWEIS

Das Anhängen eines SCORM-Inhaltspakets an einen Kurs kann nicht in Swagger durchgeführt werden. Stattdessen müssen Sie diese Anfrage in Postman, einem Power Automate-Ablauf oder programmiert aufrufen. Im Anhang dieses Artikels finden Sie:

  • eine Postman-Sammlung mit einer Anfrage, die ein SCORM-Paket an einen Kurs anhängt
  • einen Power Automate-Ablauf, der ein SCORM-Paket an einen Kurs anhängt

Nachdem Sie ein SCORM-Paket im Learn365 Admin Center oder mit der Learn365-API erstellt haben, setzen Sie die folgende HTTP-Anfrage in Postman ab:

/odata/v2/Courses(COURSE_ID)/Scorms/$ref
Der Textteil muss dabei wie folgt aussehen:
{ \"@odata.id\" :\"https://api.365.systems/odata/v2/Scorms(SCORM_ID)\"}
Hierbei wird „SCORM_ID“ durch die ID des SCORM-Pakets ersetzt, das Sie dem Kurs hinzufügen möchten.

 

HINWEIS

Damit das SCORM-Inhaltspaket als Lernobjekt dem Learn365-Kurs direkt hinzugefügt werden kann, müssen Sie die korrekte Kurs-ID, die SCORM-ID und den Vollzugriffsschlüssel für die Learn365-API angeben.

 

SCORM-Inhaltspaket an ein Lernmodul anhängen

Das Hinzufügen eines SCORM-Inhaltspakets zu einem Lernmodul innerhalb eines Kurses erfolgt in Swagger. Hierzu führen Sie die folgenden Schritte aus:

 

1. Nach erfolgreicher Autorisierung suchen Sie den Abschnitt LearningModules.

Erweitern Sie ihn und suchen Sie die Anfrage POST /odata/v2/LearningModules mit der Beschreibung Creates Learning Module.

 

 

2. Wählen Sie oben rechts Try it out aus. Füllen Sie im Feld Edit Value die Pflichtfelder sowie die gewünschten optionalen Felder aus.

Die Anfrage muss den nachstehenden Anfragetext aufweisen. Die Parameter CourseId, Title, LearningModuleId, SCORM_ID und Id müssen ausgefüllt sein (sie sind im untenstehenden Skript rot markiert). Der Parameter SCORM_TITLE ist optional, aber wir empfehlen, ihn anzugeben, um Ihrem SCORM-Paket einen Titel zu geben (der Parameter ist orangefarben hervorgehoben).

 

{
  "CourseId": "COURSE_ID",
  "Title": "LEARNING_MODULE_TITLE",
  "Description": null,
  "Publishing": {
  "IsEnabled": true
},
  "Order": 0,
  "HasPrerequisite": false,
  "Configuration": {
    "LearningModuleId": "00000000-0000-0000-0000-000000000000",
    "Items": "[{\"ScormId\":\"SCORM_ID\",\"ItemType\":2,\"PackageType\":0,\"Id\":\"00000000-0000-0000-0000-000000000000\",\"Title\":\"SCORM_TITLE\",\"IsAvailable\":null,\"IsDeleted\":null}]"
  }
}

 

 

Sie können API-Endpunkte zum Abrufen der relevanten Daten verwenden:
  1. Die CourseId können Sie über den API-Endpunkt GET ​/odata​/v2​/Courses abrufen (dieser gibt die Liste der Kurse zurück).
  2. Die Daten für Title und LearningModuleId des Lernmoduls können Sie mithilfe des API-Endpunkts GET /odata/v2/LearningModules abrufen (dieser gibt die Liste der Lernmodule zurück).
  3. Die Daten für SCORM_ID und Id schließlich können Sie mithilfe des API-Endpunkts GET /odata/v2/Scorms abrufen (dieser gibt die Liste der SCORM-Inhaltspakete zurück).

 

TIPP

Wenn der Parameter „Order“ auf 0 festgelegt wird, wird das angehängte SCORM-Inhaltspaket zum ersten Element auf der Liste der Lernobjekte des Kurses. Sie können die Lernobjekte im Learn365 Admin Center neu sortieren oder die Standardeinstellung (0) auf die entsprechende ganze Zahl umstellen, um die Position des Inhaltspakets unter den Lernobjekten des Lernmoduls zu bestimmen.

 

3. Wenn Sie startklar sind, klicken Sie auf die blaue Schaltfläche Execute. Scrollen Sie dann zum Block Response herunter, um die Ergebnisse zu kontrollieren:

  • Die Zahl 2xx (beispielsweise „200“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
  • Im Feld Response body werden die Details zum erfolgreichen Hinzufügen des SCORM-Inhaltspakets zum Lernmodul angezeigt.

 

 

Das SCORM-Paket selbst wird im Feld Inhalt des Kurses angezeigt.

 

 

HINWEIS

Das Hinzufügen des SCORM-Pakets zu einem Lernmodul ermöglicht eine breitere Palette von Berichten zum Kursinhalt.

 

War dieser Beitrag hilfreich?
2 von 3 fanden dies hilfreich

Kommentare

Zu diesem Beitrag können keine Kommentare hinterlassen werden.