Learn365 ermöglicht die Registrierung von Benutzern für Kurse und Schulungspläne sowohl über die Learn365 Admin Center Funktionalität als auch über die Learn365-API. Dieser Artikel beschreibt die Registrierung für einen Schulungsplan über die Learn365-API.
Gehen Sie wie folgt vor, um einen Benutzer für einen Schulungsplan zu registrieren:
1. Navigieren Sie zu https:/api.365.systems/ und autorisieren Sie sich mit dem entsprechenden API-Schlüssel. Weitere Informationen zum Autorisierungsvorgang finden Sie hier.
HINWEIS
Um einen Benutzer für einen Schulungsplan zu registrieren, wird derselbe API-Endpunkt wie für die Registrierung in E-Learning- und Veranstaltungsbasierte Schulung-Kursen verwendet.
2. Wählen Sie im Bereich Courses den POST-Endpunkt /odata/v2/Courses({Id})/Enroll aus und wählen Sie Try it out.
3. Nachdem Sie auf Try it out geklickt haben, werden zwei Felder angezeigt. Sie müssen die Pflichtparameter ausfüllen:
- key:Id wo Sie die ID des Schulungsplans eingeben müssen, für den Sie einen Benutzer oder eine Gruppe registrieren möchten, und
- userLoginName unter Edit Value, wo Sie den string in "userLoginName": "string" durch den Anmeldenamen des Benutzers oder die ID der benutzerdefinierten Benutzergruppe ersetzen müssen, die Sie für einen Kurs registrieren möchten.
Bitte löschen Sie den "courseSessionId": "string", "courseSessionIds": ["guid"], Teil aus dem Anfragetext, wenn Sie einen Benutzer für einen Schulungsplan registrieren, damit die Anfrage erfolgreich ausgeführt werden kann.
Ein Beispiel für eine API-Anfrage zur Registrierung eines Benutzers für einen Schulungsplan:
{ "userLoginName": "i:0#.f|membership|kayb@lms365preview.onmicrosoft.com", "ignoreMaxAttendees": true, "ignoreEnrollmentFlow": true }
4. Wenn Sie bereit sind, wählen Sie die Schaltfläche Execute aus, um die Anfrage auszuführen.
5. Gehen Sie zum Block Responses , um die Ergebnisse zu kontrollieren:
- Die Zahl 2xx (beispielsweise „201“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
- Im Feld Response body sehen Sie die Details der Registrierung in der Antwort auf die Anfrage. Der Benutzer wird für den Schulungsplan und für alle Kurse dieses Schulungsplans registriert. Dies kann über Learn365 Admin Center > einen Katalog auswählen > Training Management > den entsprechenden Schulungsplan auswählen > Manage people überprüft werden.
HINWEIS
Die Antwort enthält die folgenden wichtigen Informationen:
- „Roles“ – Unterscheidet sich je nachdem, ob der Benutzer beim Registrieren für den Schulungsplan über die API die Rolle „Kursadministrator“ hat oder nicht.
Wenn einem Benutzer in einem Schulungsplan keine Administratorrolle zugewiesen ist, wird in der Antwort für diesen Benutzer nur die Rolle Lernender angezeigt. Wenn ein als Schulungsplan-Administrator zugewiesener Benutzer über die API für diesen Schulungsplan registriert wird, zeigt die API-Antwort zwei Rollen für diesen Benutzer an: Lernender (Learner) und Teacher (admin).
- „RegistrationStatus“ – Unterscheidet sich je nach dem für den Schulungsplan konfigurierten Registrierungsflow. Er kann bei Schulungsplänen mit dem Registrierungsflow Automatic Approval aktiv sein oder bei Schulungsplänen mit den Registrierungsflows Administrator oder Line Manager Approval Awaiting sein. Der Status kann über die Funktion Learn365 Admin Center functionally von Awaiting zu Active geändert werden, oder mit der Hilfe der API-Endpunkte POST/odata/v2/Enrollments({Id})/Approve bzw. POST/odata/v2/Enrollments({Id})/Reject.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.