GlideUser : Global
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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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]);
cfcbad03d711110050f5edcb9e61038fBereichsbezogenes Äquivalent
Für diese Methode gibt es kein bereichsbezogenes Äquivalent.
GlideUser – getName()
Gibt die Benutzer-ID oder den Anmeldenamen des aktuellen Benutzers zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| id | Zeichenfolge | Eindeutige ID (sys_id) oder Benutzername des gewünschten Benutzerdatensatzes. |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| role | Zeichenfolge | Zu prüfende Rolle |
| 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.
| Name | Typ | Beschreibung |
|---|---|---|
| group | Zeichenfolge | Sys_id der zu überprüfenden Anwendergruppe. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob der aktuelle Anwender ein explizites Mitglied der angegebenen Gruppe ist. Gültige Werte:
|
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.
| Name | Typ | Beschreibung |
|---|---|---|
| group | Zeichenfolge | Sys_id der zu überprüfenden Anwendergruppe. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob der aktuelle Anwender ein Mitglied der angegebenen Gruppe ist. Gültige Werte:
|
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().