Eine Liste gelöschter Kurse und Schulungspläne über die Learn365-API abrufen

Wenn Kurse und Schulungspläne gelöscht werden, werden sie auf der Seite Training Management der Kurskataloge nicht mehr angezeigt. Ihre Daten und zugehörigen Schulungsdatensätze bleiben jedoch in Learn365 erhalten, sodass sie über Learn365-API-Endpunkte abgerufen werden können.

Dieser Artikel beschreibt, wie Sie über die API Informationen zu gelöschten Kursen und Schulungsplänen abrufen.

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

2. Erweitern Sie den Abschnitt Courses und suchen Sie die GET-Methode /odata/v2/Courses/IncludedDeleted mit der Beschreibung Returns the list of Courses including courses which have been deleted.

3. Wählen Sie oben links Try it out aus, um die Felder zu aktivieren.

Wenn für die Felder keine Abfrageoptionsparameter verwendet werden, enthält die Antwort Daten zu allen vorhandenen und gelöschten Kursen und Schulungsplänen des Tenants.

4. Damit die Antwort nur gelöschte Kurse und Schulungspläne des Tenants enthält, geben Sie IsDeleted eq truein das Feld $filter ein.

Sie können weitere Abfrageoptionsparameter verwenden, um die in der Antwort zurückgegebenen Daten zu steuern. Geben Sie das Wort add nach dem ersten Parameter und vor dem zweiten Parameter ein.

Um beispielsweise Informationen zu allen gelöschten Schulungen eines bestimmten Typs (d. h. E-Learning, Veranstaltungsbasierte Schulung oder Schulungsplan) zurückzugeben, können Sie CourseType eq 'number' zum Feld $filter hinzufügen. Ersetzen Sie das Wort number im zweiten Parameter je nach Schulungstyp durch eine der folgenden Zahlen:

• 1 – für E-Learning-Kurse.
• 3 – für Veranstaltungsbasierte Schulungen.
• 4 – für Schulungspläne.

Ein Beispiel für die gesetzten Parameter im Feld $filter ist IsDeleted eq true and CourseType eq '4'. In diesem Fall enthält die Antwort nur gelöschte Schulungspläne des Tenants.

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

6. Gehen Sie zum Block Responses, um die Ergebnisse zu kontrollieren:

• Die Zahl 2xx (zum Beispiel „200“) unter Code zeigt an, dass die Anfrage korrekt ausgeführt wurde.
• Im Feld Response body sehen Sie gelöschte Kurse und Schulungspläne des Tenant sowie deren Daten entsprechend den festgelegten Abfrageoptionen.
• Verwenden Sie Ctrl+F, um nach der URL eines bestimmten Kurses oder Schulungsplans zu suchen, falls erforderlich.

• Über die Option Download können Sie die Ergebnisse der API-Anfrage im .JSON-Format auf Ihrem Computer speichern.