GlideUser : client

L’API GlideUser fournit des méthodes qui accèdent aux informations sur l’utilisateur actuel et les rôles d’utilisateur actuels. L’utilisation de cette API évite d’avoir à utiliser les requêtes GlideRecord plus lentes pour obtenir des informations utilisateur.

Les méthodes et propriétés GlideUser sont accessibles via un objet global (g_user) qui n’est disponible que dans les scripts clients.

Cette API :

• Contient des informations sur le nom et le rôle de l’utilisateur actuel.
• est généralement utilisé dans les scripts clients et les politiques d’interface utilisateur, mais se trouve également dans les actions d’interface utilisateur qui s’exécutent sur le client.
• ne peut pas être utilisé dans les règles métier ou les actions d’interface utilisateur qui s’exécutent sur le serveur.

Les informations sur l’utilisateur actuel et les rôles d’utilisateur actuels sont contenues dans le client (navigateur Web). Toutes les méthodes GlideUser , à l’exception de getClientData(), accèdent aux informations de session qui sont disponibles par défaut. La méthode getClientData() nécessite une configuration sur le serveur et l’utilisation de la méthode putClientData() pour rendre les informations de session disponibles.

Pour plus d’informations sur l’utilisation de scripts côté client, voir Introduction au scripting côté client.

GlideUser : firstName

Le prénom de l’utilisateur actuel.

Tableau 1. Champ

Nom	Type	Description
firstName	Chaîne	Prénom de l’utilisateur actuel.

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

GlideUser : getClientData(clé de chaîne)

Renvoie une valeur cliente définie à l’aide de setClientData() ou GlideSession -- putClientData().

Les données du client de session sont un ensemble de chaînes nommées qui peuvent être configurées sur le serveur à l’aide de GlideSession -- putClientData(). Vous pouvez utiliser getClientData() pendant le temps de chargement du formulaire pour obtenir les informations dont le script client a besoin pour prendre des décisions concernant le formulaire. Par exemple, pour identifier les champs qui doivent être visibles.

Voir aussi GlideForm.

Tableau 2. Paramètres

Nom	Type	Description
clé	Chaîne	Nom des données client à récupérer.

Tableau 3. Renvoie

Type	Description
Chaîne	Valeur des données client.

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

GlideUser : getFullName()

Renvoie le prénom et le nom de famille de l’utilisateur actuel.

Tableau 4. Paramètres

Nom	Type	Description
Aucun

Tableau 5. Renvoie

Type	Description
Chaîne	Le nom complet de l’utilisateur actuel.

var formalName = g_user.getFullName();

GlideUser : hasRole(Rôle de chaîne, booléen includeDefaults)

Renvoie la valeur vrai si l’utilisateur actuel possède le rôle spécifié ou le rôle administrateur.

Tableau 6. Paramètres

Nom	Type	Description
rôle	Chaîne	Rôle à vérifier.
includeDefaults	Booléen	Facultatif. Marqueur indiquant s’il faut inclure des rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour en savoir plus sur les rôles, reportez-vous à la section Exploring user administration. Valeur par défaut : false

Tableau 7. Renvoie

Type	Description
Booléen	Renvoie la valeur vrai si l’utilisateur actuel possède le rôle spécifié ou le rôle administrateur ; sinon, cela renvoie la valeur faux.

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

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

GlideUser : hasRoleExactly(Rôle de chaîne, booléen includeDefaults)

Détermine si l’utilisateur actuel dispose du rôle spécifié.

Tableau 8. Paramètres

Nom	Type	Description
includeDefaults	Booléen	Facultatif. Marqueur indiquant s’il faut inclure des rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour plus d’informations sur les rôles, voir Rôles explicites. Valeur par défaut : false
rôle	Chaîne	Rôle à vérifier.

Tableau 9. Renvoie

Type	Description
Booléen	Renvoie la valeur vrai si l’utilisateur actuel possède le rôle spécifié.

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

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

GlideUser : hasRoleFromList(Rôles de chaîne, booléen includeDefaults)

Renvoie la valeur vrai si l’utilisateur actuel possède au moins l’un des rôles spécifiés ou a le rôle administrateur.

Tableau 10. Paramètres

Nom	Type	Description
roles	Chaîne	Liste de rôles séparés par des virgules à vérifier
includeDefaults	Booléen	Facultatif. Marqueur indiquant s’il faut inclure des rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour en savoir plus sur les rôles, reportez-vous à la section Exploring user administration. Valeur par défaut : false

Tableau 11. Renvoie

Type	Description
Booléen	Renvoie la valeur vrai si l’utilisateur actuel a un rôle dans la liste ou le rôle administrateur.

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

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

GlideUser : hasRoles(booléen includeDefaults)

Renvoie la valeur vrai si l’utilisateur actuel dispose d’un rôle.

Tableau 12. Paramètres

Nom	Type	Description
includeDefaults	Booléen	Facultatif. Marqueur indiquant s’il faut inclure des rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour en savoir plus sur les rôles, reportez-vous à la section Exploring user administration. Valeur par défaut : false

Tableau 13. Renvoie

Type	Description
Booléen	Renvoie la valeur vrai si l’utilisateur actuel a au moins un rôle.

var yesRole = g_user.hasRoles();

var yesRole = g_user.hasRoles(true);

GlideUser : lastName

Le nom de famille de l’utilisateur actuel.

Tableau 14. Champ

Nom	Type	Description
lastName	Chaîne	Nom de famille de l’utilisateur actuel.

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

GlideUser : setClientData(clé de chaîne, valeur de chaîne)

Définit une valeur client que vous pouvez récupérer à l’aide de getClientData().

Voir aussi GlideForm.

Tableau 15. Paramètres

Nom	Type	Description
clé	Chaîne	Nom des données client à stocker en tant que clé.
valide	Numéro	Valeur à affecter à la clé.

Tableau 16. Renvoie

Type	Description
Néant

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

Nom d’utilisateur de l’utilisateur actuel, par exemple gsmith02. Ce n’est pas le nom de l’utilisateur, par exemple George Smith.

Tableau 17. Champ

Nom	Type	Description
userName	Chaîne	Nom d’utilisateur de l’utilisateur actuel.

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

GlideUser : userID

Renvoie le sys_id de l’utilisateur actuel.

Tableau 18. Champ

Nom	Type	Description
userID	Chaîne	Sys_id de l’utilisateur actuel.

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