UserSkillRanking : global

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 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(String requiredSkillsJson, String usersJson, String rankType, Boolean 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
    requiredSkillsJson 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 d’utilisateurs de sys_user table (au format JSON) représentant les utilisateurs à qualifier en fonction des compétences requises.
    Type de classement 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étence :

    • NO_RANKING (par défaut) : utilisé si la valeur fournie est vide.
    • NUM_SKILLS : 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 : recherche 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 minimal.
    • 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);