GlideUser – Client

Die GlideUser Die API stellt Methoden bereit, die auf Informationen zum aktuellen Anwender und zu aktuellen Anwenderrollen zugreifen. Durch die Verwendung dieser API wird vermieden, dass die langsameren GlideRecord-Abfragen zum Abrufen von Anwenderinformationen verwendet werden müssen.

GlideUser Auf Methoden und Eigenschaften wird über ein globales Objekt zugegriffen ( G_user ), die 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 Sie auf die Sitzungsinformationen zu, die standardmäßig verfügbar sind. Die GetClientData() Die Methode erfordert das Setup auf dem Server und die Verwendung von PutClientData() Methode, um Sitzungsinformationen verfügbar zu machen.

Informationen zur Verwendung clientseitiger Skripts finden Sie unter Einführung in clientseitiges Skripting .

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 festgelegt wurde SetClientData() Oder GlideSession -- putClientData() .

Sitzungs-Client-Daten sind eine Reihe benannter Zeichenfolgen, die auf dem Server mit eingerichtet werden können GlideSession -- putClientData() . Sie können verwenden GetClientData() Während des Ladevorgangs des Formulars, um Informationen zu erhalten, die das Clientskript 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. Rückgaben

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 (Zeichenfolgenschlüssel, Zeichenfolgenwert)

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

Siehe auch GlideForm .

Tabelle : 15. Parameter

Name	Typ	Beschreibung
key	Zeichenfolge	Name der Clientdaten, die als Schlüssel gespeichert werden sollen.
Wert	Anzahl	Wert, der dem Schlüssel zugewiesen werden soll.

Tabelle : 16. Rückgaben

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

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