Den Veröffentlichungsstatus eines Lernobjekts über die Learn365 API ändern

Einführung

Sie können Learn365 API-Endpunkte verwenden, um den Status von Lernmodulen und Quiz von „veröffentlicht“ auf „nicht veröffentlicht“ zu ändern – oder umgekehrt. So können Sie Inhalte für Lernende verfügbar oder nicht verfügbar machen, wenn sie einen Kurs absolvieren. Alternativ können Sie ein Lernobjekt (ein Lernmodul oder ein Quiz) direkt im Learn365 Admin Center bearbeiten, indem Sie dessen Veröffentlichungseinstellungen konfigurieren.

In diesem Artikel wird beschrieben, wie Sie Learn365 APIs verwenden können, um den Veröffentlichungsstatus von Lernmodulen und Quizzen eines Kurses zu ändern.

Voraussetzungen 

Um den Veröffentlichungsstatus von Lernmodulen und Quiz zu ändern, müssen Sie die relevanten Lernobjektdaten abrufen und anschließend eine Anfrage ausführen, um die Daten zu aktualisieren.

Für die Aktualisierungsanfrage müssen Sie einige Parameter eingeben, die Sie wie folgt erhalten können:

1. Gehen Sie zu https://api.365.systems/ und melden Sie sich mit dem entsprechenden API-Schlüssel an. Weitere Informationen zum Autorisierungsprozess finden Sie in diesem Artikel.

2. Suchen Sie in der Liste der Abschnitte der Learn365 API den passenden Abschnitt für das Lernobjekt, dessen Veröffentlichungsstatus Sie ändern möchten: LearningModules oder Quizzes.

3. Suchen Sie die entsprechende GET-Anfrage, mit der Sie die erforderlichen Parameter des betreffenden Lernobjekts abrufen:

• Suchen Sie für Lernmodule die GET-Methode /odata/v2/LearningModules mit der Returns the list of Learning Modules Beschreibung.
   
• Suchen Sie für Quizze die GET-Methode /odata/v2/Quizzes mit der Returns the list of Quizzes Beschreibung.

4. Erweitern Sie die entsprechende GET-Anfrage und wählen Sie Try it out aus.

5. Geben Sie im Feld $expand der entsprechenden GET-Methode den folgenden Wert ein, um die relevanten Datentypen in die Antwort einzuschließen:

• Geben Sie für Lernmodule Configuration, Publishing ein. Die Antwort enthält die Veröffentlichungseinstellungen der Lernmodule des Tenant sowie Daten zu den Elementen innerhalb der Lernmodule.
   
• Geben Sie für QuizzeA0Courses. ein Die Antwort enthält eine Liste der Kurse, in denen das Quiz verwendet wird.

Wenn Sie die ID oder den Titel eines Lernobjekts haben, können Sie die Antwort so eingrenzen, dass sie nur Daten zum relevanten Objekt enthält. Geben Sie dazu im Feld $filter Id eq item ID oder Title eq 'item title' ein, z. B. Id eq 90796418-a6e5-446c-96e5-00733621f771 oder entsprechend Title eq 'Phishing awareness guidelines'.

6. Wählen Sie Execute aus, um die Anfrage auszuführen.

7. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren:

• Die Zahl 2xx (zum Beispiel 200) unter Code zeigt an, dass die Anfrage korrekt ausgeführt wurde. Sie können die Daten aus der Antwort über Download im .JSON-Format auf Ihren Computer herunterladen.
• Im Feld Response body sehen Sie Daten zu den Lernobjekten im gesamten Tenant. Suchen Sie das entsprechende Lernobjekt mit Strg+F.

Jetzt haben wir die Daten, die zum Aktualisieren des relevanten Lernobjekts erforderlich sind.

Veröffentlichungsstatus eines Lernobjekts aktualisieren

Lernmodul

1. Suchen Sie den Abschnitt LearningModules, klappen Sie ihn auf, suchen Sie die PUT-Methode /odata/v2/LearningModules({Id}) mit der Beschreibung Updates Learning Module  und wählen Sie Try it out aus.

2. Füllen Sie die Felder aus und beachten Sie dabei die Pflichtparameter:

• key:Id, ein erforderlicher Parameter. Geben Sie hier die ID des Lernmoduls ein, für das Sie die Veröffentlichungseinstellungen aktualisieren möchten.
   
• Geben Sie im Feld Wert bearbeiten die Daten des Lernmoduls ein, die Sie im vorherigen Abschnitt ermittelt haben. Das folgende Beispiel zeigt nur das erwartete Format der Daten. Denken Sie daran, beim Ausfüllen der Parameter Ihre eigenen Daten zu verwenden. Achten Sie besonders auf den Parameter IsEnabled, denn true veröffentlicht das Lernmodul und false hebt die Veröffentlichung auf. 

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

4. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren.

• Die Zahl 2xx (zum Beispiel 200) unter Code zeigt an, dass die Anfrage korrekt ausgeführt wurde. 

• Sie können die Ergebnisse im Learn365 Admin Center > wählen Sie einen Katalog > Schulungsverwaltung > wählen Sie den Kurs, der das relevante Lernmodul enthält > prüfen Sie den Veröffentlichungsstatus des Lernmoduls in der Spalte Veröffentlicht (Ja für veröffentlicht, Nein für nicht veröffentlicht).

   

  

Quiz

1. Suchen Sie den Abschnitt Quizzes, klappen Sie ihn auf, suchen Sie die PUT-Methode /odata/v2/Quizzes({Id}) mit der Beschreibung Updates a Quiz und klicken Sie auf Try it out.

2. Füllen Sie die Felder aus und beachten Sie dabei die Pflichtparameter:

• key:Id, einerforderlicher Parameter. Geben Sie hier die ID des Quiz ein, für das Sie die Veröffentlichungseinstellungen aktualisieren möchten.

• Geben Sie im Feld Wert bearbeiten die Daten des Quiz ein, die Sie im vorherigen Abschnitt ermittelt haben. Das folgende Beispiel zeigt nur das erwartete Format der Daten. Denken Sie daran, beim Ausfüllen der Parameter Ihre eigenen Daten zu verwenden. Achten Sie besonders auf den Parameter IsEnabled, da true das Quiz veröffentlicht und false es unveröffentlicht macht. 

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

4. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren.

• Die Zahl 2xx (zum Beispiel 200) unter Code zeigt an, dass die Anfrage korrekt ausgeführt wurde. 
• Sie können die Ergebnisse im Learn365 Admin Center > wählen Sie einen Katalog > Inhalt > Quizzes > wählen Sie das entsprechende Quiz > prüfen Sie den Veröffentlichungsstatus des Quiz in der Spalte Veröffentlicht (Ja für veröffentlicht, Nein für nicht veröffentlicht).