Benutzerdefinierte Spalten für den Bereich „Benutzer“ über die Learn365-API erstellen

Es ist möglich, Benutzerprofilspalten (mit Ausnahme der Spalten Benutzername und Der Benutzer befindet sich im Kurskatalog Spalten) zu erstellen und diese mit einer eigenen Datenquelle zu bearbeiten – entweder über die Learn365-API oder über das Learn365 Admin Center > Alle Kataloge > Globale Einstellungen > LMS-Konfiguration > Spalten auf der Benutzerseite.

Dieser Artikel beschreibt, wie Sie mit der Learn365-API eine neue benutzerdefinierte Spalte erstellen und vorhandene Benutzerprofilspalten konfigurieren.

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 Sie den Abschnitt UserFields, erweitern Sie ihn, suchen Sie die POST-Methode /odata/v2/UserFields mit der Beschreibung Creates new user field und wählen Sie dann oben links Try it out aus.

3. Nachdem Sie Try it out ausgewählt haben, können Sie die folgenden erforderlichen Parameter festlegen:

• "Title": "string" Ersetzen Sie string durch den Namen, den die Spalte haben soll. 
• "Description": "string" Ersetzen Sie string durch die Beschreibung, die die Spalte haben soll.
• "Type": "integer" Ersetzen Sie integer durch den Datentyp, den die Spalte haben soll.

Der Datentyp kann nach dem Erstellen der Spalte nicht mehr geändert werden. Der Standarddatentyp ist string (zeigt Textinformationen an, z. B. eine Position). Weitere mögliche Datentypen sind: Boolean (der Wert kann nur entweder Yes oder No sein), number (Zahlenwerte), 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), DateTime (oder 3).

Beispielsweise kann "Type": "integer" als "Type": "Boolean" oder "Type": "1" festgelegt werden, wobei das Ergebnis dasselbe ist.

Ein Beispiel für eine API-Anfrage könnte wie folgt aussehen:

{
"Title":"Abteilungsbetreuer",
"Description":"Bericht",
"IsVisible":true,
"Type":"0"
}

4.  Wählen Sie die Schaltfläche Execute, um den Befehl auszuführen.

5. Gehen Sie zum Block Antworten, um die Ergebnisse zu überprüfen:

• Die Zahl 2xx (beispielsweise „201“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• In dem Feld Response body werden die Ergebnisse der Anfrage angezeigt. Die Spalte wird erstellt, und kann (mit Ausnahme des Spaltentyps) in the Learn365 Admin Center > Alle Kataloge > Globale Einstellungen > LMS-Konfiguration > Spalten auf der Benutzerseite und im Benutzer Panel überprüft und konfiguriert werden.