GlideUser : Global

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 Minuten Lesedauer
  • 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.

    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());

    Bereichsbezogenes Äquivalent

    Um die getCompanyID () Verwenden Sie für eine Bereichsanwendung die entsprechende Bereichsmethode: getCompanyID () .

    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());

    Bereichsbezogenes Äquivalent

    Um die getDisplayName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getDisplayName().

    GlideUser – getDomainDisplayValue()

    Gibt den Anzeigewert der Sitzungsdomäne des Benutzers zurück.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Anzeigewert der Sitzungsdomäne des Benutzers.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getDomainDisplayValue());

    Bereichsbezogenes Äquivalent

    Es gibt keinen Workaround für bereichsbezogene Anwendungen.

    GlideUser – getDomainID()

    Gibt den Identifier der aktuellen Sitzungsdomäne des Benutzers zurück.

    Der zurückgegebene Identifier hängt vom Domänentyp und der Instantiierung dieser Domäne ab.

    • Wenn der Benutzer in der globalen Domäne konfiguriert ist und die Domänenauswahl nicht zum Wechseln von Domänen verwendet, gibt die Methode NULL zurück.
    • Wenn der Benutzer die Domänenauswahl verwendet, um zur globalen Domäne zu wechseln, gibt die Methode die Zeichenfolge „global“ zurück .
    • Bei allen anderen Domänen gibt die Methode die sys_id dieser Domäne zurück.
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Domänenbezeichner.
    var domain = new GlideRecord('domain');
    domain.get(gs.getUser().getDomainID());
    gs.info(domain.name);

    GlideUser – getEmail()

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

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Zeichenfolge E-Mail-Adresse des Benutzers
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getEmail());

    Bereichsbezogenes Äquivalent

    Um die getEmail()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getEmail().

    GlideUser – getFirstName()

    Gibt den Vornamen des Benutzers zurück.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Objekt/Zeichenfolge Vorname des Anwenders.
    Hinweis:
    Der Datentyp für den zurückgegebenen Wert ist ein Objekt. Die Informationen werden jedoch als Zeichenfolge zurückgegeben.
    var currentUser = gs.getUser(); 
    var userName = currentUser.getFirstName();
    gs.info('User First Name: + userName);
    gs.info('Data type: ' + typeof userName);
    *** Script: User First Name: John
    *** Script: Data type: object

    Bereichsbezogenes Äquivalent

    Um die getFirstName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getFirstName().

    GlideUser – getID

    Gibt die sys_id des aktuellen Benutzers zurück.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge sys_id des Benutzers
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getID());

    Bereichsbezogenes Äquivalent

    Um die getID()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getID().

    GlideUser – getLastName()

    Gibt den Nachnamen des Benutzers zurück.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Objekt/Zeichenfolge Nachname des Anwenders.
    Hinweis:
    Der Datentyp für den zurückgegebenen Wert ist ein Objekt. Die Informationen werden jedoch als Zeichenfolge zurückgegeben.
    var currentUser = gs.getUser(); 
    var userName = currentUser.getLastName();
    gs.info('User Last Name: + userName);
    gs.info('Data type: ' + typeof userName);
    *** Script: User Last Name: Smith
    *** Script: Data type: object

    Bereichsbezogenes Äquivalent

    Um die getLastName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getLastName().

    GlideUser – getMyGroups()

    Gibt einen Iterator zurück, der die Liste aller Gruppen enthält, zu denen der Benutzer gehört. Nur aktive Gruppen werden zurückgegeben.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Iterator Eine Liste von sys_ids für die aktiven Gruppen, zu denen der Benutzer gehört.

    Das folgende Beispiel zeigt, wie eine Liste der Gruppen zurückgegeben wird, denen der Benutzer angehört.

    var groupsArray = gs.getUser().getMyGroups().toArray();
    gs.info(groupsArray[0]);
    Ausgabe:
    cfcbad03d711110050f5edcb9e61038f

    Bereichsbezogenes Äquivalent

    Für diese Methode gibt es kein bereichsbezogenes Äquivalent.

    GlideUser – getName()

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

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Benutzer-ID
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getName());

    Bereichsbezogenes Äquivalent

    Um die getName()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getName().

    GlideUser – getRoles()

    Gibt eine Liste der Rollen zurück, die dem Anwender zugeordnet sind. Enthält explizit gewährte Rollen, geerbte Rollen und Rollen, die durch die Gruppenmitgliedschaft erworben wurden.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Objekt Kommagetrennte Liste der Anwenderrollen.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getRoles());

    Ausgabe:

    admin,hr_fulfiller,itsa_fulfiller,security_admin

    Bereichsbezogenes Äquivalent

    Um die getRoles()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getRoles().

    GlideUser – getUserByID (String id)

    Gibt das Benutzerobjekt zurück, das der übergebenen Benutzer-ID (sys_id in sys_user) oder benutzer_name zugeordnet ist.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Eindeutige ID (sys_id) oder Benutzername des gewünschten Benutzerdatensatzes.
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    Objekt Benutzerobjekt, das der angegebenen sys_id oder dem angegebenen Benutzernamen zugeordnet ist.

    Beispiel mit Benutzername (Benutzername).

    var currentUser = gs.getUser();
    gs.info(currentUser.getFirstName()); // print the first name of the logged in user
    var newUser = currentUser.getUserByID('abel.tuter'); // fetch a different user using the user_name field
    gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user 
    

    Beispiel mit Benutzer-ID (sys_id).

    var currentUser = gs.getUser();
    gs.info(currentUser.getFirstName()); // print the first name of the logged in user
    var newUser = currentUser.getUserByID('62826bf03710200044e0bfc8bcbe5df1'); // fetch Abel Tuter user using sys_id from sys_user record
    gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user 
    

    GlideUser – getUserRoles()

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

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    Objekt/Zeichenfolge Liste der durch Kommas getrennten Rollen, die dem Benutzer explizit zugewiesen wurden.
    Hinweis:
    Der Datentyp für den zurückgegebenen Wert ist ein Objekt. Die Informationen werden jedoch als Zeichenfolge zurückgegeben.
    var currentUser = gs.getUser(); 
    var userRoles = currentUser.getUserRoles();
    gs.info('User Roles: ' + userRoles);
    gs.info('Data type: ' + typeof userRoles);
    *** Script: User Roles: ,admin,security_admin
    *** Script: Data type: object

    Bereichsbezogenes Äquivalent

    Um die getUserRoles()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: getUserRoles().

    GlideUser – hasRole(String role)

    Bestimmt, ob der aktuelle Benutzer die angegebene Rolle hat.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    role Zeichenfolge Zu prüfende Rolle
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Benutzer die Rolle hat.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.hasRole('admin'));

    Bereichsbezogenes Äquivalent

    Um die hasRole()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: hasRole().

    GlideUser: isExplicitMemberOf(String group)

    Bestimmt, ob der aktuelle Anwender ein explizites Mitglied der angegebenen Gruppe ist. Nur aktive Gruppen werden mit dieser Methode ausgewertet.

    Die Methode isMemberOf() gibt für eine übergeordnete Gruppe „true“ zurück, wenn der Benutzer ein Mitglied der untergeordneten Gruppe ist. Verwenden Sie diese Methode, wenn Sie nur für übergeordnete Gruppen „wahr“ zurückgeben möchten.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    group Zeichenfolge Sys_id der zu überprüfenden Anwendergruppe.
    Tabelle : 30. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob der aktuelle Anwender ein explizites Mitglied der angegebenen Gruppe ist.

    Gültige Werte:
    • wahr: Der aktuelle Anwender ist ein explizites Mitglied der angegebenen Gruppe.
    • „falsch“: Der aktuelle Anwender ist kein explizites Mitglied der angegebenen Gruppe.

    Das folgende Beispiel zeigt, wie überprüft wird, ob der aktuelle Anwender ein explizites Mitglied der angegebenen Gruppe ist.

    var isExplMem = gs.getUser().isExplicitMemberOf('b8ef24616fc331003b3c498f5d3ee434');
    gs.info(isExplMem);

    Ausgabe:

    false

    Bereichsbezogenes Äquivalent

    Für diese Methode gibt es kein bereichsbezogenes Äquivalent.

    GlideUser – isMemberOf(String group)

    Bestimmt, ob der aktuelle Benutzer Mitglied der angegebenen Gruppe ist. Nur aktive Gruppen werden mit dieser Methode ausgewertet.

    Diese Methode gibt für eine übergeordnete Gruppe „true“ zurück, wenn der Anwender ein Mitglied der untergeordneten Gruppe ist. Verwenden Sie isExplicitMemberOf(), wenn Sie nur für übergeordnete Gruppen „wahr“ zurückgeben möchten.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    group Zeichenfolge Sys_id der zu überprüfenden Anwendergruppe.
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob der aktuelle Anwender ein Mitglied der angegebenen Gruppe ist.

    Gültige Werte:
    • wahr: Der aktuelle Anwender ist ein Mitglied der angegebenen Gruppe.
    • „falsch“: Der aktuelle Anwender ist kein Mitglied der angegebenen Gruppe.

    Das folgende Beispiel zeigt, wie überprüft wird, ob der aktuelle Anwender ein Mitglied der angegebenen Gruppe ist.

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

    Bereichsbezogenes Äquivalent

    Um die isMemberOf()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: isMemberOf().