GlideUser – Global
Die GlideUser Die API bietet Methoden für den Zugriff auf Informationen zum aktuellen Anwender und zu aktuellen Anwenderrollen.
Mit GlideUser Die API vermeidet die Verwendung der langsameren GlideRecord-Abfragen, um Anwenderinformationen zu erhalten.
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 „object“, 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 „object“, 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 Anwender 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 durch die Gruppenmitgliedschaft erworbene Rollen.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Objekt | Kommagetrennte Liste von 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 – 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.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die 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
GlideUser – getTimeZoneLabelLang(Zeichenfolgensprache)
Gibt die Zeitzonenbezeichnung des aktuellen Anwenders in der angegebenen Sprache zurück.
| 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. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die 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
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 kommagetrennten Rollen, die dem Anwender explizit zugewiesen sind. Hinweis: Der Datentyp für den zurückgegebenen Wert ist „object“, 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(Zeichenfolgengruppe)
Bestimmt, ob der aktuelle Anwender ein explizites Mitglied der angegebenen Gruppe ist. Mit dieser Methode werden nur aktive Gruppen ausgewertet.
Die IsMemberOf() Methode gibt „wahr“ für eine übergeordnete Gruppe zurück, wenn der Anwender Mitglied der untergeordneten Gruppe ist. Verwenden Sie diese Methode, wenn Sie nur „wahr“ für übergeordnete Gruppen 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. Mit dieser Methode werden nur aktive Gruppen ausgewertet.
Diese Methode gibt „wahr“ für eine übergeordnete Gruppe zurück, wenn der Anwender Mitglied der untergeordneten Gruppe ist. Verwenden Sie IsExplicitMemberOf() Wenn Sie nur „wahr“ für übergeordnete Gruppen zurückgeben möchten.
| Name | Typ | Beschreibung |
|---|---|---|
| group | Zeichenfolge | SYS_ID oder Name der zu überprüfenden Gruppe. |
| Typ | Beschreibung |
|---|---|
| Boolean | Kennzeichnung, die angibt, ob der Anwender Mitglied der angegebenen Gruppe ist. Mögliche Werte:
|
Im folgenden Beispiel wird überprüft, ob der aktuelle Anwender Mitglied der Kapazitätsverwaltungsgruppe ist.
var currentUser = gs.getUser();
gs.info(currentUser.isMemberOf('Capacity Mgmt'));
Ausgabe:
false
Bereichsbezogenes Äquivalent
Um die isMemberOf()-Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: isMemberOf().