Dateien hochladen und Inhaltspakete über die Learn365-API erstellen

Einführung

Das Hochladen von SCORM- und AICC-Inhaltspaketen auf Learn365 kann entweder im Learn365 Admin Center oder direkt über die Endpunkte der Learn365-API erfolgen. Dieser Artikel beschreibt, wie man eine ZIP-Datei hochlädt und später mithilfe von Learn365-APIs ein Inhaltspaket auf Basis dieser ZIP-Datei erstellt.

ZIP-Datei per API hochladen, um ein Inhaltspaket zu erstellen

Zum Hochladen eines ZIP-Pakets in den Learn365-Inhaltspaketspeicher gehen Sie wie folgt vor:

1. Navigieren Sie zur Learn365 API,lassen Sie sich autorisieren und wählen Sie im Abschnitt Scorms den POST-Endpunkt /scorms/upload mit der Beschreibung Upload zip package to storageaus.

2. Wählen Sie oben links Try it out aus und wählen Sie im Feld Upload File eine zip-Datei von Ihrem Computer aus. Wenn Sie bereit sind, wählen Sie Execute aus, um den Befehl auszuführen.

3. Scrollen Sie zum Block Responses hinunter, um die Ergebnisse zu prüfen:

• Die Zahl 2xx (beispielsweise „200“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• Im Feld Response body sehen Sie ein neu hochgeladenes zip-Paket und seine Details. Stellen Sie sicher, dass unter Success true angezeigt wird, um zu bestätigen, dass die zip-Datei erfolgreich hochgeladen wurde. Kopieren Sie den Parameter Location , da Sie diesen benötigen, um ein Inhaltspaket über die API zu erstellen

Inhaltspaket per API erstellen

Nachdem Sie eine ZIP-Datei per API auf Learn365 hochgeladen haben, kann diese Datei als Basis für die Erstellung eines Inhaltspakets verwendet werden, das von Learn365 erkannt wird. Führen Sie zu diesem Zweck die folgenden Schritte durch:

1. Wählen Sie im Abschnitt Scorms den POST-Endpunkt /odata/v2/Scorms mit Creates a SCORM. aus beschreibung.

2. Wählen Sie oben links Try it out aus und geben Sie im Feld Edit Value die Parameter an. Einige Parameter sind obligatorisch, andere optional. Einige Pflichtangaben können der Antwort des Endpunkts entnommen werden, der zum Hochladen der ZIP-Datei verwendet wurde (dies ist im vorangehenden Abschnitt beschrieben).

 

Obligatorische Parameter sind:

• "Title": Geben Sie Ihrem SCORM einen Namen.
• "Configuration": Take this data from the response of the endpoint used to upload the zip file under the DefaultConfiguration parameter.

• "ContentType": Geben Sie entweder 1 (für SCORM packages) oder 2 (für AICC packages) ein.

• "Ort": Fügen Sie den Ort der zuvor hochgeladenen Zip-Datei ein. Den Ort erhalten Sie zusammen mit anderen Paketparametern (wie FileName) in der Antwort auf POST /scorms/upload.

   

  

   

3. Wenn Sie bereit sind, wählen Sie Execute aus, um den Befehl auszuführen.

Nachstehend ein Beispiel für den API-Request-Body zum Erstellen eines SCORM, ausgefüllt mit den Daten aus der Antwort der hochgeladenen ZIP-Datei. Der API-Anfragetext enthält obligatorische und optionale Parameter.

4. Gehen Sie zum Block Responses , um die Ergebnisse zu überprüfen:

• Die Zahl 2xx (z. B. 200) unter Code zeigt an, dass die Anfrage korrekt ausgeführt wurde.
• Im Feld Response body werden ein neu erstelltes Inhaltspaket und dessen Details angezeigt. Stellen Sie sicher, dass unter Success der Wert true angezeigt wird. Hierdurch wird bestätigt, dass das Inhaltspaket erfolgreich erstellt wurde.
• Über die Option Download können Sie die Ergebnisse im JSON-Format auf Ihrem Computer speichern.

Das Inhaltspaket wurde erfolgreich über die Learn365-API erstellt und wird im Inhaltspaketspeicher im Learn365 Admin Center angezeigt.