Kurse und Schulungspläne per API erstellen

Manche Benutzer bevorzugen zum Erstellen von Kursen oder Schulungsplänen die Verwendung der Learn365-API anstelle der im Learn365 Admin Center gebotenen Funktionalität.

Dieser Artikel enthält Empfehlungen zum Erstellen von Kursen mithilfe der Learn365-API.

Gehen Sie wie folgt vor, um einen Kurs zu erstellen:

Zum Verwenden der Learn365-API müssen Sie mit dem entsprechenden API-Schlüssel auf https://api.365.systems autorisiert sein. Ausführliche Informationen finden Sie in diesem Artikel.

1. Erweitern Sie auf https://api.365.systems den Abschnitt Courses.

2. Wählen Sie den Endpunkt POST /odata/v2/Courses zum Erstellen neuer Kurse und Schulungspläne aus und klicken Sie auf Try it out.

3. Geben Sie im geöffneten Abschnitt Parameters unter Edit Value die erforderlichen Parameterwerte ein, um eine Schulung zu erstellen. Dabei werden Pflichtparameter und optionale Parameter unterschieden. Optionale Parameter können auch nach dem Erstellen des Kurses oder Schulungsplans durch Bearbeiten im Learn365 Admin Center noch hinzugefügt werden.

Die Standarddaten für die Werte können folgende Typen aufweisen:

• guid: eine eindeutige ID
• string: jede endliche Abfolge von Zeichen (Buchstaben, Ziffern, Symbole, Interpunktionszeichen usw.)
• integer: Ganzzahl
• boolean: Variable mit dem Wert „true“ (wahr) oder „false“ (falsch)

Obligatorische Parameter sind:

• CourseCatalogId. Die eindeutige ID des Katalogs, in dem dieser neue Kurs hinzugefügt wird.
• UICulture. Die Websitesprache. Diese sollte aus der Liste der von SharePoint unterstützten Sprachen hinzugefügt werden. Verwenden Sie die Gebietsschema-ID aus der Spalte „LCID“ in der Tabelle mit den von SharePoint unterstützten Sprachen. Beispiel: „en-us“ für „Englisch (Vereinigte Staaten)“. Bei Verwendung eines anderen Gebietsschemaformats schlägt die Erstellung fehl.
• Title. Hier geben Sie Ihrem Kurs einen Titel.
• Description. Hier geben Sie eine Kurzbeschreibung für Ihren Kurs an.
• CourseType. Hier geben Sie den Schulungstyp an:
  • 1 für einen E-Learning-Kurs
  • 3 für eine veranstaltungsbasierte Schulung
  • 4 für einen Schulungsplan

Wenn dieser Parameter nicht konfiguriert oder auf 0 festgelegt ist, wird der Schulungstyp nicht festgelegt. Er kann im Nachhinein nicht mehr konfiguriert werden.

Wichtige optionale Parameter:

• TeacherLogins. Hier geben Sie die Namen der Benutzer an, die Sie als Kursadministratoren zuweisen möchten.
• TrainerLogins. Hier geben Sie diejenigen der im Feld TeacherLogins aufgeführten Benutzer an, die als Ansprechpartner auf der Startseite der Schulung angezeigt werden sollen. Wenn Sie hier einen Benutzer angeben, der nicht bereits im Feld TeacherLogins aufgeführt ist, wird dieser nicht als Ansprechpartner auf der Startseite der Schulung angezeigt.
• VisitorLogins. Wenn die Option Zielgruppenadressierung für die Schulung aktiviert ist, legen Sie hier die Benutzer fest, die zur Zielgruppe gehören sollen. Wenn die Option Zielgruppenadressierung für die Schulung deaktiviert ist, werden keine Benutzer als Zielgruppe festgelegt.

4. Klicken Sie auf Execute, um die Anfrage auszuführen und eine Schulung zu erstellen.

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

• Die Zahl 2xx (beispielsweise „202“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• Über die Option Download können Sie die Ergebnisse im JSON-Format auf Ihrem Gerät speichern.
• Im Feld Response body wird die neu erstellte Schulung mit den festgelegten Parametern angezeigt. Der Kurs erscheint auch auf der Seite Schulungsmanagement im Learn365 Admin Center. Hier können Sie seine Einstellungen anzeigen und verwalten.