GlideUser – Umfang

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Die GlideUser Die API bietet Methoden für den Zugriff auf Informationen zum aktuellen Anwender und zu aktuellen Anwenderrollen.

    Mit GlideUser API vermeidet die Verwendung der langsameren GlideRecord-Abfragen, um Anwenderinformationen abzurufen.

    Bereichsbezogener GlideUser – getCompanyID()

    Gibt die Unternehmens-sys_ID des aktuellen Anwenders zurück

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Zeichenfolge SYS_ID des Unternehmens
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getCompanyID());

    Bereichsbezogener GlideUser – getDisplayName()

    Gibt den Anzeigenamen des aktuellen Anwenders zurück.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Zeichenfolge Anzeigename des Anwenders
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getDisplayName());

    Bereichsbezogener GlideUser – getEmail()

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

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Zeichenfolge E-Mail-Adresse des Anwenders.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getEmail());

    Bereichsbezogener GlideUser – getFirstName()

    Gibt den Vornamen des Anwenders zurück.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Zeichenfolge Vorname des Anwenders.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getFirstName());

    Bereichsbezogener GlideUser – GetId()

    Ruft die sys_ID des aktuellen Anwenders ab.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Zeichenfolge Sys_ID des Anwenders
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getID());

    Bereichsbezogener GlideUser – getLastName()

    Gibt den Nachnamen des Anwenders zurück.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    Zeichenfolge Nachname des Anwenders.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getLastName());

    Bereichsbezogener GlideUser – getName()

    Gibt die Anwender-ID oder den Anmeldenamen des aktuellen Anwenders zurück.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    Zeichenfolge Anwender-ID oder Anmeldename.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getName());

    Bereichsbezogener GlideUser – getPreference(Zeichenfolgenname)

    Ruft den angegebenen Anwendereinstellungswert für den aktuellen Anwender 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'));

    Bereichsbezogener GlideUser – getRoles()

    Gibt eine Liste von Rollen zurück, die explizit gewährte Rollen, geerbte Rollen und von der Gruppenmitgliedschaft erworbene Rollen enthält.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Rückgaben
    Typ Beschreibung
    Array Liste aller für den Anwender 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 Anwenders finden Sie unter User specific language.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    Zeichenfolge Zeitzonenbezeichnung des aktuellen Anwenders.

    Dieses Beispiel zeigt, wie die Zeitzonenbezeichnung des aktuellen Anwenders in seiner bevorzugten Sprache zurückgegeben wird.

    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 Sprache, die für die Zeitzonenbezeichnung verwendet werden soll. Befindet sich in der ID-Spalte der Tabelle „Sprache“ [sys_language].

    Wenn keine gültige Sprache angegeben wird, wird die Zeitzonenbezeichnung auf Englisch zurückgegeben.

    Tabelle : 22. Rückgaben
    Typ Beschreibung
    Zeichenfolge Zeitzonenbezeichnung des aktuellen Anwenders.

    Dieses Beispiel zeigt, wie die Zeitzonenbezeichnung des aktuellen Anwenders in einer angegebenen 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

    Bereichsbezogener GlideUser – getUserRoles()

    Gibt die Liste der Rollen zurück, die dem Anwender explizit gewährt werden.

    Im Gegensatz zu GetRoles() Methode: Diese Methode gibt keine Rollen zurück, die der Anwender erbt, oder Rollen, die er aus der Gruppenmitgliedschaft erworben hat.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 24. Rückgaben
    Typ Beschreibung
    Array Liste der Rollen, die dem Anwender explizit zugewiesen sind.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getUserRoles());

    Bereichsbezogener GlideUser – hasRole (Zeichenfolgenrolle)

    Bestimmt, ob der aktuelle Anwender über die angegebene Rolle verfügt.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Rolle Zeichenfolge 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: Anwender hat die angegebene Rolle.
    • Falsch: Anwender hat nicht die angegebene Rolle.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.hasRole('admin'));

    Bereichsbezogener GlideUser – isMemberOf(Zeichenfolgengruppe)

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

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    Gruppe Zeichenfolge SYS_ID oder Name der zu überprüfenden Gruppe.
    Tabelle : 28. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Anwender Mitglied der angegebenen Gruppe ist.
    Mögliche Werte:
    • Wahr: Anwender ist Mitglied der Gruppe.
    • Falsch: Anwender ist kein Mitglied der Gruppe.

    Im folgenden Beispiel wird überprüft, ob der aktuelle Anwender Mitglied der Kapazitätsmanagementgruppe ist.

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

    Ausgabe:

    false

    Bereichsbezogener GlideUser – savePreference (Zeichenfolgenname, Zeichenfolgenwert)

    Speichert einen Anwendereinstellungswert 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'));