Benutzer per API einem Kurskatalog hinzufügen

Benutzer können über das Learn365 Admin Center oder die Learn365-API zu einem Kurskatalog eingeladen werden.

In diesem Artikel beschreiben wir, wie Sie einen Benutzer über die Learn365-API zu einem Kurskatalog hinzufügen.

Gehen Sie wie folgt vor, um einen Benutzer über die Learn365-API einem Kurskatalog hinzuzufügen:

1. Gehen Sie zu https://api.365.systems/, und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.

2. Suchen Sie den Abschnitt CourseCatalogs, erweitern Sie ihn und wählen Sie darin den Endpunkt POST /odata/v2/CourseCatalogs({id})/Users mit der Beschreibung Add user to the Course Catalog aus. Dann klicken Sie oben rechts auf Try it out.

3. Nach Auswahl von Try it out müssen Sie die Parameter eingeben:

• id: Hier geben Sie die ID des Kurskatalogs ein, dem Sie einen Benutzer hinzufügen möchten.
• Feld Edit Value : Hier müssen Sie die nachstehenden Pflichtparameter eingeben. Sie können diese Informationen in Azure Active Directory (Azure AD) ermitteln, indem Sie unter Benutzer den betreffenden Benutzer auswählen.

{
"LoginName": "string", (ersetzen Sie string durch den Benutzerprinzipalnamen aus Azure AD).
"DirectoryObjectId": "string", (ersetzen Sie string durch die Objekt-ID). Dieser Parameter ist erforderlich, falls im Azure AD der Organisation Benutzer mit identischen Anmeldenamen vorhanden sein können, beispielsweise wenn ein Benutzer gelöscht und erneut erstellt wurde oder es Benutzer mit den gleichen Vor- und Nachnamen gibt.
}

Weitere Parameter sind optional.

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

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.
• Im Feld Response body wird das Ergebnis der Anfrage angezeigt: Die Person wird dem Zielkatalog hinzugefügt und in der zugehörigen Liste Benutzer mit den Daten aus dem Azure AD der Organisation angezeigt (sofern für die Person vorhanden).

Dem Benutzer wird der Zugriff auf die Startseiten aller Kurse und Schulungspläne im Katalog gewährt, damit beim Navigieren im Katalog keine Zugriffsverweigerung durch SharePoint erfolgt.