Es ist möglich, Benutzerprofilspalten (mit Ausnahme der Spalten Benutzername und Der Benutzer befindet sich im Kurskatalog) zu erstellen und diese mit einer eigenen Datenquelle zu bearbeiten. Möglich ist dies wahlweise über die Learn365-API oder über Learn365 Admin Center > Globale Einstellungen > LMS-Konfiguration > Benutzerspalten.
Dieser Artikel beschreibt, wie Sie mit der Learn365-API eine neue benutzerdefinierte Spalte erstellen und vorhandene Benutzerprofilspalten konfigurieren.
HINWEIS
Die Option Benutzerdefinierte Synchronisation wird für jede Spalte einzeln aktiviert. Wenn Benutzerdefinierte Synchronisation für eine bestimmte Spalte aktiviert ist, synchronisiert Learn365 die Daten für diese Spalte nicht mehr mit Microsoft Azure AD. Allerdings können Sie auch weiterhin Daten aus Ihrer Datenquelle per API in dieses Feld eintragen. Hier finden Sie weitere Informationen zum Aktualisieren von benutzerdefinierten und Systemspalten.
Gehen Sie wie folgt vor, um eine neue benutzerdefinierte Spalte per API zu erstellen:
1. Gehen Sie zu https://api.365.systems/, und autorisieren Sie sich mit dem entsprechenden API-Schlüssel. Weitere Informationen zum Autorisierungsvorgang finden Sie hier.
2. Suchen und erweitern Sie den Abschnitt UserFields, suchen Sie die Methode POST /odata/v2/UserFields mit der Beschreibung Creates new user field und wählen Sie dann oben links Try it out aus.
3. Nach Auswahl von Try it out müssen Sie die folgenden Pflichtparameter eingeben:
- "Title": "string". Ersetzen Sie string durch den Namen, den Sie der Spalte geben möchten.
- "Description": "string". Ersetzen Sie string durch eine Beschreibung für die Spalte.
- "Type": "integer" Ersetzen Sie integer durch den Datentyp, den die Spalte erhalten soll.
Der Datentyp kann nach dem Erstellen der Spalte nicht mehr geändert werden. Der Standarddatentyp ist string (zeigt Textinformationen an, zum Beispiel eine Positionsbezeichnung). Weitere mögliche Datentypen sind Boolean (der Wert kann nur Yes oder No sein), number (Zahlenwerte) und date (Datumsformat).
Bei einer API-Anfrage verwenden Sie das folgende Format, um einen Datentyp für eine Spalte festzulegen: String (oder 0), Boolean (oder 1), Number (oder 2) bzw. DateTime (oder 3).
Beispielsweise kann "Type": "integer" auf "Type": "Boolean" oder "Type": "1" umgestellt werden, wobei das Ergebnis dasselbe ist.
TIPP
Sie können die Sichtbarkeit einer Spalte im Bereich „Benutzer“ mithilfe des Parameters "IsVisible" festlegen: Ersetzen Sie Boolean durch true (macht die Spalte im Bereich Benutzer sichtbar) oder false (die Spalte ist nicht sichtbar).
Ein Beispiel für eine API-Anfrage könnte wie folgt aussehen:
{
"Title":"Department Supervisor",
"Description":"Reporting", "IsVisible":true, "Type":"0"
}
4. 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 werden die Ergebnisse der Anfrage angezeigt. Die Spalte wird erstellt, was unter LMS-Konfiguration > Benutzerspalten sowie im Bereich Benutzer überprüft und (mit Ausnahme des Spaltentyps) konfiguriert werden kann.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.