Manche Benutzer bevorzugen zum Erstellen von Kursen oder Schulungsplänen die Verwendung der Learn365-API anstelle der Funktionalität des Learn365 Admin Center.
Dieser Artikel enthält Empfehlungen zum Erstellen von Kursen mithilfe der Learn365-API.
Gehen Sie wie folgt vor, um einen Kurs zu erstellen:
Um die Learn365-API verwenden zu können, müssen Sie aufhttps://api.365.systems mit dem entsprechenden API-Schlüssel autorisiertsein. For details, seethis article.
1. Erweitern Sie in https://api.365.systems denAbschnitt Courses.
2. Wählen Sie den Endpunkt POST/odata/v2/Courses aus, mit dem neue Kurse und Schulungspläne erstellt werden, und wählen SieTry it out aus.
3. Geben Sie im geöffneten Abschnitt Parameters unterEdit 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 hinzugefügt werden, indem Sie die Schulung im Learn365 Admin Center bearbeiten.
Die Standarddaten für die Werte können folgende Typen aufweisen:
- guid. eine eindeutige ID
- Zeichenkette. jede endliche Abfolge von Zeichen (Buchstaben, Ziffern, Symbole, Interpunktionszeichen usw.)
- Ganzzahl. Ganzzahl
- Boolean. Eine„Wahr oder Falsch“-Variable.
Obligatorische Parameter sind:
- CourseCatalogId. Die eindeutige ID des Katalogs, zu dem dieser neue Kurs hinzugefügt wird.
- UICulture. Die Websitesprache, die aus der Liste der von SharePoint unterstützten Sprachen hinzugefügt werden sollte. 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.
- Titel. Hier geben Sie Ihrem Kurs einen Titel.
- Beschreibung. 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.
HINWEIS
Geben Sie für einen Kurs vom Typ „Veranstaltungsbasierte Schulung“ den Parameter CourseSessionEnrollmentType an, um den Registrierungstyp zu konfigurieren:
- 1 steht für den Registrierungstyp Einzelne Gruppe oder eigenständige Sitzung .
- 2 steht für den Registrierungstyp Mehrere Gruppen oder eigenständige Sitzungen.
- 3 steht für den Registrierungstyp Alle Gruppen und eigenständigen Sitzungen .
TIPP
- Veranstaltungsbasierte Schulung ist in der Antwort als ClassRoom gekennzeichnet.
- Wenn Sie Ihren Kurs beim Erstellen per API direkt veröffentlichen möchten, geben Sie den folgenden Parameter an:
"PublishingSettings": {"IsEnabled": true}
Wichtige optionale Parameter sind:
- TeacherLogins. Geben Sie die Benutzernamen 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 Training Audience Targeting aktiviert ist, legen Sie hier die Benutzer fest, die zur Zielgruppe gehören sollen. Wenn die Option Training Audience Targeting deaktiviert ist, werden keine Benutzer als Zielgruppe festgelegt.
BEISPIEL
Anfragen zum Erstellen einer Schulung mit den erforderlichen Parametern und festgelegtem Veröffentlichungsstatus.
E-Learning-Kurs erstellen
{
"CourseCatalogId": "d4d0b82f-e67f-46d7-a142-fc347a520973",
"UICulture": "en-us",
"Title": "Business Analysis, part 2",
"Description": "Der Kurs ist auf erfahrene Business Analysten ausgerichtet.",
"CourseType": "1",
"PublishingSettings": {"IsEnabled": true}
}
Kurs des Typs „Veranstaltungsbasierte Schulung“ erstellen
{
"CourseCatalogId": "d4d0b82f-e67f-46d7-a142-fc347a520973",
"UICulture": "fr-fr",
"Title": "Analyse commerciale, partie 4",
"Description": "Le cours richtet sich an erfahrene Business Analysten.",
"CourseType": "3",
"CourseSessionEnrollmentType": "3",
"PublishingSettings": {"IsEnabled": true}
}
Schulungsplan erstellen
{
"CourseCatalogId": "d4d0b82f-e67f-46d7-a142-fc347a520973",
"UICulture": "de-de",
"Title": "Geschäftsanalyse",
"Description": "Der Ausbildungsplan ist auf erfahrene Business Analysten ausgerichtet.",
"CourseType": "4",
"PublishingSettings": {"IsEnabled": true}
}
4. Wählen Sie Execute aus, um die Anfrage auszuführen und eine Schulung. zu erstellen
5. Gehen Sie zum Block Responses , 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 wird im Learn365 Admin Center > wählen Sie einen Katalog aus > Training Management angezeigt, wo Sie die Einstellungen einsehen und verwalten können.
HINWEIS
Um die erfolgreiche Bereitstellung der Schulung zu gewährleisten, empfehlen wir Ihnen, etwas zu warten, bevor Sie Lernobjekte hinzufügen und die Einstellungen eines neu erstellten Kurses oder Schulungsplans konfigurieren. Mithilfe der Learn365 API können Sie den Status der Schulungserstellung überprüfen.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.