GlideUser – Client

Die GlideUser-API bietet Zugriff auf Informationen über den aktuellen Benutzer und die aktuellen Benutzerrollen. Durch die Verwendung der GlideUser-API müssen keine langsameren GlideRecord-Abfragen verwendet werden, um Benutzerinformationen abzurufen.

Auf die GlideUser-Methoden und -Eigenschaften wird über ein globales Objekt (g_user) zugegriffen, das nur in Client-Skripts verfügbar ist. GlideUser

• Enthält Name und Rolleninformationen zum aktuellen Benutzer.
• Wird normalerweise in Client-Skripts und UI-Richtlinien verwendet, wird jedoch auch in UI Actions gefunden, die auf dem Client ausgeführt werden.
• Kann nicht in Business Rules oder UI Actions verwendet werden, die auf dem Server ausgeführt werden.
• Vermeidet die Notwendigkeit von GlideRecord-Abfragen, um Benutzerinformationen abzurufen.

Sitzungsinformationen zum aktuellen Benutzer und zu den aktuellen Benutzerrollen sind im Client (Webbrowser) enthalten. Alle GlideUser-Methoden außer getClientData() greifen auf die Sitzungsinformationen zu, die standardmäßig verfügbar sind. Die getClientData()-Methode erfordert die Einrichtung auf dem Server und die Verwendung von putClientData(), um Sitzungsinformationen zur Verfügung zu stellen.

Weitere Informationen zur Verwendung von clientseitigen Skripts finden Sie unter Einführung in die clientseitige Skripterstellung.

GlideUser – firstName

Gibt den Vornamen des aktuellen Benutzers zurück.

Tabelle : 1. Feld

Name	Typ	Beschreibung
firstName	Zeichenfolge	Vorname des aktuellen Benutzers.

alert('first name = ' + g_user.firstName);

GlideUser – getClientData(String key)

Gibt einen Client-Wert zurück, der mit setClientData() oder GlideSession -- putClientData() festgelegt wurde.

Sitzungs-Client-Daten sind ein Satz benannter Zeichenfolgen, die auf dem Server mit GlideSession -- putClientData() eingerichtetwerden können. Sie können getClientData() während der Formularladezeit verwenden, um Informationen abzurufen, die das Client-Skript benötigt, um Entscheidungen über das Formular zu treffen. Zum Beispiel, um zu identifizieren, welche Felder sichtbar sein sollen.

Siehe auch GlideForm.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Name der abzurufenden Client-Daten.

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Wet der Clientdaten.

var loginLanguage = g_user.getClientData("loginlanguage");

GlideUser – getFullName()

Gibt den Vor- und Nachnamen des aktuellen Benutzers zurück.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Der vollständige Name des aktuellen Benutzers.

var formalName = g_user.getFullName();

GlideUser – hasRole(String role, Boolean includeDefaults)

Gibt „true“ zurück, wenn der aktuelle Benutzer die angegebene Rolle oder die Administratorrolle hat.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
role	Zeichenfolge	Die zu überprüfende Rolle.
includeDefaults	Boolean	Optional. Kennzeichnung, die angibt, ob Standardrollen wie snc_internal und snc_external in die Anforderung aufgenommen werden sollen. Weitere Informationen zu -Rollen finden Sie unter Exploring user administration. Standardwert: false

Tabelle : 7. Ergebnisse

Typ	Beschreibung
Boolean	Gibt „true“ zurück, wenn der aktuelle Benutzer die angegebene Rolle oder die Administratorrolle hat; anderfalls wird „false“ zurückgegeben.

var isInternal = g_user.hasRole('snc_internal', true);

var isItil = g_user.hasRole('itil');

GlideUser – hasRoleExactly(String role, Boolean includeDefaults)

Bestimmt, ob der aktuelle Benutzer die angegebene Rolle hat.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
includeDefaults	Boolean	Optional. Kennzeichnung, die angibt, ob Standardrollen wie snc_internal und snc_external in die Anforderung aufgenommen werden sollen. Weitere Informationen zu Rollen finden Sie unter Explizite Rollen. Standardwert: false
role	Zeichenfolge	Die zu überprüfende Rolle.

Tabelle : 9. Ergebnisse

Typ	Beschreibung
Boolean	Gibt „true“ zurück, wenn der aktuelle Benutzer die angegebene Rolle hat.

var isInternal = g_user.hasRoleExactly('snc_internal', true);

var isItil = g_user.hasRoleExactly('itil');

GlideUser – hasRoleFromList(String roles, Boolean includeDefaults)

Gibt „true“ zurück, wenn der aktuelle Benutzer mindestens eine der angegebenen Rollen oder die Administratorrolle hat.

Tabelle : 10. Parameter

Name	Typ	Beschreibung
roles	Zeichenfolge	Kommagetrennte Liste der zu überprüfenden Rollen.
includeDefaults	Boolean	Optional. Kennzeichnung, die angibt, ob Standardrollen wie snc_internal und snc_external in die Anforderung aufgenommen werden sollen. Weitere Informationen zu -Rollen finden Sie unter Exploring user administration. Standardwert: false

Tabelle : 11. Ergebnisse

Typ	Beschreibung
Boolean	Gibt „true“ zurück, wenn der aktuelle Benutzer eine Rolle in der Liste oder die Administratorrolle hat.

var isOK = g_user.hasRoleFromList("itil, maint");

var isOK = g_user.hasRoleFromList("itil, maint, snc_internal", true);

GlideUser – hasRoles(Boolean includeDefaults)

Gibt „true“ zurück, wenn der aktuelle Benutzer eine Rolle hat.

Tabelle : 12. Parameter

Name	Typ	Beschreibung
includeDefaults	Boolean	Optional. Kennzeichnung, die angibt, ob Standardrollen wie snc_internal und snc_external in die Anforderung aufgenommen werden sollen. Weitere Informationen zu -Rollen finden Sie unter Exploring user administration. Standardwert: false

Tabelle : 13. Ergebnisse

Typ	Beschreibung
Boolean	Gibt „true“ zurück, wenn der aktuelle Benutzer mindestens eine Rolle hat.

var yesRole = g_user.hasRoles();

var yesRole = g_user.hasRoles(true);

GlideUser – lastName

Der Nachname des aktuellen Benutzers.

Tabelle : 14. Feld

Name	Typ	Beschreibung
lastName	Zeichenfolge	Nachname des aktuellen Benutzers

alert('last name = ' + g_user.lastName);

GlideUser – setClientData(String key, String value)

Legt einen Clientwert fest, den Sie mit getClientData()abrufen können.

Siehe auch GlideForm.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Name der Client-Daten, die als Schlüssel gespeichert werden sollen.
Wert	Nummer	Wert, der dem Schlüssel zugewiesen werden soll.

Tabelle : 16. Ergebnisse

Typ	Beschreibung
Keine

function onSubmit() {
	
	if (!g_user.getClientData('keyName')) {
		var now_GR = new GlideRecord('incident');
		now_GR.addActiveQuery();
		now_GR.setLimit(1);
		now_GR.query(cb);
		return false;
	}
	return true;
}

function cb(now_GR) {
	// <insert glide operation >
	g_user.setClientData('keyName', now_GR.getValue('<number>'));
	g_form.submit();	
}

GlideUser – userName

Diese Eigenschaft ist der Benutzername des aktuellen Benutzers, z. B. gsmith02. Es ist nicht der Name des Benutzers, zum Beispiel „George Smith“.

Tabelle : 17. Feld

Name	Typ	Beschreibung
userName	Zeichenfolge	Benutzername des aktuellen Benutzers.

var userName = g_user.userName;
   alert('Current user = ' + userName);

GlideUser – userID

Gibt die sys_id des aktuellen Benutzers zurück.

Tabelle : 18. Feld

Name	Typ	Beschreibung
userID	Zeichenfolge	sys_id des aktuellen Benutzers.

var userID = g_user.userID;
   alert('Current user ID = ' + userID);