UserSkillRanking : global

L’API UserSkillRanking fournit des méthodes pour configurer des 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 avez le rôle administrateur.

Consultez la rubrique 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
Aucun

UserSkillRanking : getQualifiedRankedUsers(String requiredSkillsJson, String usersJson, String rankType, Boolean isSkillLevelEnforced)

Fournit une liste d’utilisateurs qualifiés en fonction des compétences et des 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 de caractères. ID système de la compétence de 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 par rapport aux 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 une valeur vide est fournie. NUM_SKILLS : le nombre de compétences mises en correspondance avec les compétences requises. NUM_SKILL_ MATCHING_LEVEL : nombre de compétences de l’utilisateur correspondant au niveau de compétence requis. LEAST_SKILL_ LEVEL_GAP : recherche la compétence de l’utilisateur qui répond le plus aux exigences de niveau de compétence minimal. MOST_SKILL_ LEVEL_GAP : recherche l’utilisateur qui répond le moins aux exigences de niveau de compétences minimales. 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. Par défaut : false.

Tableau 3. Renvoie

Type	Description
Chaîne	Liste des utilisateurs qualifiés au format JSON. Erreur si paramètres inexacts ou JSON mal formé fourni.

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);