UserSkillRanking : global

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • L’API UserSkillRanking fournit des méthodes pour configurer les options permettant de choisir le bon utilisateur et d’obtenir une liste triée d’utilisateurs qualifiés en fonction du nombre de compétences correspondantes et de l’écart de niveau de compétence.

    Cette API nécessite le module d’extension Gestion des compétences (com.snc.skills_management), que vous pouvez activer si vous disposez du rôle administrateur.

    Consultez Qualifier et classer les utilisateurs en fonction des compétences et des niveaux de compétence.

    UserSkillRanking : UserSkillRanking()

    Instancie un objet UserSkillRanking.

    Tableau 1. Paramètres
    Nom Type Description
    Néant

    UserSkillRanking : getQualifiedRankedUsers(Chaîne requiredSkillsJson, Chaîne usersJson, Chaîne rankType, Booléen isSkillLevelEnforced)

    Fournit une liste d’utilisateurs qualifiés en fonction des compétences et niveaux obligatoires correspondants si le paramètre isSkillLevelEnforced est vrai.

    Tableau 2. Paramètres
    Nom Type Description
    requisSkillsJson Chaîne Liste des compétences requises pour qualifier les utilisateurs.
    Chaque compétence est répertoriée en tant qu’entrée JSON au format suivant :
    • sys_id : chaîne. ID système de la compétence dans la table Compétences [cmn_skill].
    • is_mandatory : Booléen. Marqueur indiquant si la compétence est obligatoire.
    • niveau : chaîne. ID système de la table Niveaux de compétences [cmn_skill_level].
    usersJson Chaîne Liste des ID système des utilisateurs de sys_user table (au format JSON) représentant les utilisateurs à qualifier en fonction des compétences requises.
    rankType Chaîne

    Permet de trier les utilisateurs qualifiés en fonction du type de classement. Les valeurs possibles sont des comparateurs pour fournir une liste triée d’utilisateurs qualifiés en fonction du nombre de compétences correspondantes et de l’écart de niveau de compétences :

    • NO_RANKING (par défaut) : utilisé si la valeur fournie est vide.
    • NUM_SKILLS : le nombre de compétences mises en correspondance avec les compétences requises.
    • NUM_SKILL_ MATCHING_LEVEL : nombre de compétences utilisateur correspondant au niveau de compétence requis.
    • LEAST_SKILL_ LEVEL_GAP : trouve la compétence de l’utilisateur qui correspond le mieux aux exigences de niveau de compétence minimal.
    • MOST_SKILL_ LEVEL_GAP : trouve l’utilisateur qui répond le moins aux exigences de niveau de compétence minimum.
    • BEST_OPTIMUM_ UTILISATEUR : trouve l’utilisateur optimal pour tous les niveaux de compétence.
    isSkillLevelEnforced Booléen Vrai si l’utilisateur doit avoir un niveau de compétence minimum pour toutes les compétences obligatoires requises, faux dans les autres cas. Valeur par défaut : faux.
    Tableau 3. Renvoie
    Type Description
    Chaîne Liste des utilisateurs qualifiés au format JSON.

    Erreur en cas de paramètres inexacts ou de JSON mal formé.

    		 
    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
				{"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4eS"}];
var users = ["a8f98bb0eb32010045e1a5115206fe3a", "62826bf03710200044e0bfc8bcbe5df1"];
var userSkillRanking = new SNC.UserSkillRanking();
var qualifiedUsers = userSkillRanking.getQualifiedRankedUsers(JSON.stringify(skills), JSON.stringify(users), "BEST_OPTIMUM_USER", true);