GlideUser : client

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 4 minutes de lecture

    • L’API GlideUser fournit des méthodes qui permettent d’accéder aux informations relatives à l’utilisateur actuel et aux rôles d’utilisateur actuels. L’utilisation de cette API évite d’avoir à utiliser les requêtes GlideRecord plus lentes pour obtenir des informations sur l’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 de session relatives à l’utilisateur actuel et aux 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 des scripts côté client, voir Présentation des scripts côté client.

    GlideUser : firstName

    Prénom de l’utilisateur actuel.

    Tableau 1. Champ
    Nom Type Description
    prénom Chaîne Prénom de l’utilisateur actuel. 
    alert('first name = ' + g_user.firstName);

    GlideUser : getClientData(clé de chaîne)

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

    Les données 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 du client. 
    var loginLanguage = g_user.getClientData("loginlanguage");

    GlideUser : getFullName()

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

    Tableau 4. Paramètres
    Nom Type Description
    Aucun
    Tableau 5. Renvoie
    Type Description
    Chaîne Nom complet de l’utilisateur actuel. 
    var formalName = g_user.getFullName();

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

    Renvoie la valeur true si l’utilisateur actuel a le rôle spécifié ou le rôle admin.

    Tableau 6. Paramètres
    Nom Type Description
    role Chaîne Rôle à vérifier.
    includeDefaults (includeDefaults) Booléen Facultatif. Marqueur indiquant s’il faut inclure les 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 à Exploring user administration.

    Valeur par défaut : false
    Tableau 7. Renvoie
    Type Description
    Booléen Renvoie la valeur true si l’utilisateur actuel a le rôle spécifié ou le rôle admin ; sinon, 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 possède le rôle spécifié.

    Tableau 8. Paramètres
    Nom Type Description
    includeDefaults (includeDefaults) Booléen Facultatif. Marqueur indiquant s’il faut inclure les rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour en savoir plus sur les rôles, consultez

    Rôles explicites.

    Valeur par défaut : false
    role Chaîne Rôle à vérifier.
    Tableau 9. Renvoie
    Type Description
    Booléen Renvoie la valeur true 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 true si l’utilisateur actuel a au moins un des rôles spécifiés ou s’il 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 (includeDefaults) Booléen Facultatif. Marqueur indiquant s’il faut inclure les 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 à Exploring user administration.

    Valeur par défaut : false
    Tableau 11. Renvoie
    Type Description
    Booléen Renvoie la valeur true 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(Boolean includeDefaults)

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

    Tableau 12. Paramètres
    Nom Type Description
    includeDefaults (includeDefaults) Booléen Facultatif. Marqueur indiquant s’il faut inclure les 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 à Exploring user administration.

    Valeur par défaut : false
    Tableau 13. Renvoie
    Type Description
    Booléen Renvoie la valeur true si l’utilisateur actuel a au moins un rôle. 
    var yesRole = g_user.hasRoles();
    var yesRole = g_user.hasRoles(true);

    GlideUser : lastName

    Nom de famille de l’utilisateur actuel.

    Tableau 14. Champ
    Nom Type Description
    nom de famille 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

    Le 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 l’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);