GlideUser : client

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • L’API GlideUser permet d’accéder à des informations sur l’utilisateur actuel et les rôles d’utilisateur actuels. L’utilisation de l’API GlideUser é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. GlideUser (en anglais seulement)
    • 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.
    • évite d’avoir recours à des requêtes GlideRecord pour obtenir des informations utilisateur.

    Les informations de session 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 putClientData() pour rendre les informations de session disponibles.

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

    GlideUser : firstName

    Renvoie le 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 client 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 des 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 famille 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(String role, Boolean includeDefaults)

    Renvoie la valeur true si l’utilisateur actuel dispose du rôle spécifié ou du rôle administrateur.

    Tableau 6. Paramètres
    Nom Type Description
    role Chaîne Rôle à vérifier.
    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 dispose du rôle spécifié ou du rôle administrateur ; sinon, renvoie la valeur false. 
    var isInternal = g_user.hasRole('snc_internal', true);
    var isItil = g_user.hasRole('itil');

    GlideUser – hasRoleExactly(String role, Boolean includeDefaults)

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

    Tableau 8. Paramètres
    Nom Type Description
    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 plus d’informations 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 dispose du rôle spécifié. 
    var isInternal = g_user.hasRoleExactly('snc_internal', true);
    var isItil = g_user.hasRoleExactly('itil');

    GlideUser – hasRoleFromList(String roles, Boolean includeDefaults)

    Renvoie la valeur true si l’utilisateur actuel dispose d’au moins un des rôles spécifiés ou s’il dispose du rôle administrateur.

    Tableau 10. Paramètres
    Nom Type Description
    roles Chaîne Liste de rôles à vérifier séparés par des virgules
    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 dispose d’un rôle dans la liste ou du 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 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 dispose d’au moins un rôle. 
    var yesRole = g_user.hasRoles();
    var yesRole = g_user.hasRoles(true);

    GlideUser : lastName

    Nom 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
    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

    Cette propriété est 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 les 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);