GlideUser : client

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • 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
    key 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
    key Chaîne Nom des données client à stocker en tant que clé.
    valide Numéro Valeur à affecter à la clé.
    Tableau 16. Renvoie
    Type Description
    Aucun 
    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);