Dateien über die API hochladen und Inhaltspakete erstellen

Einführung

Das Hochladen von SCORM- und AICC-Inhaltspaketen auf Learn365 kann entweder im Learn365 Admin Center oder direkt über 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 unter dem Abschnitt Scorms den Endpunkt POST /scorms/upload mit der Beschreibung Upload zip package to storage aus.

 

2. Wählen Sie oben links Try it out 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 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 ein neu hochgeladenes ZIP-Paket und dessen Details angezeigt. Stellen Sie sicher, dass unter Success der Wert true angezeigt wird. Hierdurch wird bestätigt, dass die ZIP-Datei erfolgreich hochgeladen wurde.

 

 

 

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 unter dem Abschnitt Scorms den Endpunkt POST /odata/v2/Scorms mit der Beschreibung Creates a SCORM aus.

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": Hier geben Sie Ihrem SCORM-Paket einen Namen.
• "Configuration": Die hier erforderlichen Angaben entnehmen Sie der Antwort des Endpunkts, der zum Hochladen der ZIP-Datei verwendet wurde. Sie finden sie unter dem Parameter DefaultConfiguration.

 

 

 

• "ContentType": Hier geben Sie entweder Scorm oder Aicc ein.
• "Location": Hier geben Sie den Speicherort der hochgeladenen ZIP-Datei an.
  

   

  

   

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

Nachstehend sehen Sie ein Beispiel für den API-Anfragetext, um ein SCORM-Paket zu erstellen, in das die Daten aus der Antwort der hochgeladenen ZIP-Datei eingetragen werden. Der API-Anfragetext enthält obligatorische und optionale Parameter.

 

 

4. Gehen Sie zum Block Response, 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 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.