GlideUser – Client

Die GlideUser- API stellt Methoden bereit, die auf Informationen über den aktuellen Anwender und die aktuellen Anwenderrollen zugreifen. Mit dieser API müssen Sie nicht die langsameren GlideRecord-Abfragen verwenden, um Benutzerinformationen abzurufen.

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

Diese API:

• 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.

Sitzungsinformationen zum aktuellen Benutzer und zu den aktuellen Benutzerrollen sind im Client (Webbrowser) enthalten. Alle GlideUser- Methoden außer getClientData() greifen auf die standardmäßig verfügbaren Sitzungsinformationen zu. Die Methode getClientData() erfordert ein Setup auf dem Server und die Verwendung der MethodeputClientData(), um Sitzungsinformationen verfügbar zu machen.

Informationen zur Verwendung clientseitiger Skripts finden Sie unter Einführung in clientseitige Skripterstellung.

GlideUser – firstName

Der Vorname des aktuellen Anwenders.

Tabelle : 1. Feld

Name	Typ	Beschreibung
firstName	Zeichenfolge	Vorname des aktuellen Benutzers.

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

GlideUser – getClientData(Zeichenfolgenschlüssel)

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

Sitzungsclientdaten sind ein Satz benannter Zeichenfolgen, die auf dem Server mit GlideSession --putClientData() eingerichtetwerden können. Sie können getClientData() während der Ladezeit des Formulars 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 Anwender über die angegebene Rolle verfügt.

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, Zeichenfolgenwert)

Legt einen Client-Wert 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

Der Anwendername des aktuellen Anwenders, 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 Anwenders.

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