GlideUser : Bereichsbezogen

Die GlideUser -API bietet Methoden für den Zugriff auf Informationen zum aktuellen Anwender und den aktuellen Anwenderrollen.

Durch die Verwendung der GlideUser -API müssen Sie nicht die langsameren GlideRecord-Abfragen verwenden, um Benutzerinformationen abzurufen.

Scoped GlideUser – getCompanyID()

Gibt die sys_id des Unternehmens des aktuellen Benutzers zurück.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	sys_id des Unternehmens

var currentUser = gs.getUser(); 
gs.info(currentUser.getCompanyID());

Scoped GlideUser – getDisplayName()

Gibt den Anzeigenamen des aktuellen Benutzers zurück.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Anzeigename des Benutzers

var currentUser = gs.getUser(); 
gs.info(currentUser.getDisplayName());

Scoped GlideUser – getEmail()

Gibt die E-Mail-Adresse des Benutzers zurück.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Zeichenfolge	E-Mail-Adresse des Anwenders.

var currentUser = gs.getUser(); 
gs.info(currentUser.getEmail());

Scoped GlideUser – getFirstName()

Gibt den Vornamen des Benutzers zurück.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Vorname des Anwenders.

var currentUser = gs.getUser(); 
gs.info(currentUser.getFirstName());

Scoped GlideUser – getID()

Ruft die sys_id des aktuellen Benutzers ab.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Zeichenfolge	sys_id des Anwenders.

var currentUser = gs.getUser(); 
gs.info(currentUser.getID());

Scoped GlideUser – getLastName()

Gibt den Nachnamen des Benutzers zurück.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Nachname des Anwenders.

var currentUser = gs.getUser(); 
gs.info(currentUser.getLastName());

Scoped GlideUser – getName()

Gibt die Benutzer-ID oder den Anmeldenamen des aktuellen Benutzers zurück.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Anwender-ID oder Anmeldename.

var currentUser = gs.getUser(); 
gs.info(currentUser.getName());

Scoped GlideUser – getPreference(String name)

Ruft den angegebenen Benutzereinstellungswert für den aktuellen Benutzer ab.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Name der Einstellung.

Tabelle : 16. Rückgaben

Typ	Beschreibung
Zeichenfolge	Einstellungswert.

var currentUser = gs.getUser(); 
currentUser.savePreference(­'myPref','red'); 
gs.info(currentUser.getPreference(­'myPref'));

Scoped GlideUser – getRoles()

Gibt eine Liste von Rollen zurück, die folgende Rollen enthält: die explizit gewährten Rollen, geerbte Rollen und Rollen, die durch die Gruppenmitgliedschaft erworben wurden.

Tabelle : 17. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 18. Ergebnisse

Typ	Beschreibung
Array	Liste aller für den Benutzer verfügbaren Rollen

var currentUser = gs.getUser(); 
gs.info(currentUser.getRoles());

Bereichsbezogener GlideUser – getTimeZoneLabel()

Gibt die Zeitzonenbezeichnung des aktuellen Anwenders in der bevorzugten Sprache des aktuellen Anwenders zurück.

Weitere Informationen zum Festlegen der bevorzugten Sprache eines Benutzers finden Sie unter User specific language.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 20. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Zeitzonenbezeichnung des aktuellen Anwenders.

In diesem Beispiel wird gezeigt, wie Sie die Zeitzonenbezeichnung des aktuellen Anwenders in der bevorzugten Sprache zurückgeben.

gs.info(gs.getUser().getTimeZoneLabel());

Ausgabe:

Europe/Dublin

Bereichsbezogener GlideUser – getTimeZoneLabelLang(Zeichenfolgensprache)

Gibt die Zeitzonenbezeichnung des aktuellen Anwenders in der angegebenen Sprache zurück.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
language	Zeichenfolge	Für die Zeitzonenbezeichnung zu verwendende Sprache. Befindet sich in der Spalte „ID“ der Sprachentabelle [sys_language]. Wenn keine gültige Sprache angegeben ist, wird die Zeitzonenbezeichnung in Englisch zurückgegeben.

Tabelle : 22. Ausgabe

Typ	Beschreibung
Zeichenfolge	Zeitzonenbezeichnung des aktuellen Anwenders.

In diesem Beispiel wird gezeigt, wie die Zeitzonenbezeichnung des aktuellen Anwenders in einer bestimmten Sprache zurückgegeben wird.

gs.info(gs.getUser().getTimeZoneLabelLang("es")); //Spanish
gs.info(gs.getUser().getTimeZoneLabelLang("ja")); //Japanese
gs.info(gs.getUser().getTimeZoneLabelLang("jksjsjks")); //invalid

Ausgabe:

Europa/Dublín
ヨーロッパ/ダブリン
Europe/Dublin

Scoped GlideUser – getUserRoles()

Gibt die Liste der Rollen zurück, die dem Benutzer explizit gewährt wurden.

Im Gegensatz zur getRoles()-Methode gibt diese Methode keine Rollen zurück, die der Benutzer erbt, oder Rollen, die aus der Gruppenmitgliedschaft erworben wurden.

Tabelle : 23. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 24. Ergebnisse

Typ	Beschreibung
Array	Liste der Rollen, die dem Benutzer explizit zugewiesen wurden.

var currentUser = gs.getUser(); 
gs.info(currentUser.getUserRoles());

Scoped GlideUser – hasRole(String role)

Bestimmt, ob der aktuelle Benutzer die angegebene Rolle hat.

Tabelle : 25. Parameter

Name	Typ	Beschreibung
role	Zeichenfolge	Die zu überprüfende Rolle.

Tabelle : 26. Rückgaben

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der Anwender über die angegebene Rolle verfügt. Mögliche Werte: „wahr“: Der Anwender hat die angegebene Rolle. „falsch“: Der Anwender verfügt nicht über die angegebene Rolle.

var currentUser = gs.getUser(); 
gs.info(currentUser.hasRole('admin'));

Scoped GlideUser – isMemberOf(String group)

Bestimmt, ob der aktuelle Benutzer Mitglied der angegebenen Gruppe ist.

Tabelle : 27. Parameter

Name	Typ	Beschreibung
group	Zeichenfolge	Sys_id oder Name der zu überprüfenden Gruppe.

Tabelle : 28. Rückgaben

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der Anwender ein Mitglied der angegebenen Gruppe ist. Mögliche Werte: wahr: Anwender ist ein Mitglied der Gruppe. „falsch“: Der Anwender ist kein Mitglied der Gruppe.

Im folgenden Beispiel wird überprüft, ob der aktuelle Benutzer ein Mitglied der Kapazitätsmanagement-Gruppe ist.

var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf('Capacity Mgmt'));

Ausgabe:

false

Scoped GlideUser – savePreference(String name, String value)

Speichert einen Benutzereinstellungswert in der Datenbank.

Tabelle : 29. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Zu speichernde Einstellung.
Wert	Zeichenfolge	Einstellungswert.

Tabelle : 30. Rückgaben

Typ	Beschreibung
Keine

var currentUser = gs.getUser(); 
currentUser.savePreference('myPref','red'); 
gs.info(currentUser.getPreference('myPref'));