---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UserSkillRanking : global

# UserSkillRanking : global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

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](https://www.servicenow.com/docs/access?context=assign-work-based-on-skills&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

## UserSkillRanking : UserSkillRanking() {#ariaid-title2}

Instancie un objet UserSkillRanking.
{#SR-UserSkillRanking__table_shf_4b1_whb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#SR-UserSkillRanking__table_shf_4b1_whb}

## UserSkillRanking : getQualifiedRankedUsers(String requiredSkillsJson, String usersJson, String rankType, Boolean isSkillLevelEnforced) {#ariaid-title3}

Fournit une liste d'utilisateurs qualifiés en fonction des compétences et des niveaux obligatoires correspondants si le paramètre `isSkillLevelEnforced` est vrai).
{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb__entry__3}

| 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\]. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_qrj_c5w_33b} |
| 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. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_rw2_byz_vhb} |
| 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 2. Paramètres]

{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb} {#SR-getQualifiedRankedUsers_S_S_S_B__table_mcv_g1s_lhb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Liste des utilisateurs qualifiés au format JSON. Erreur si paramètres inexacts ou JSON mal formé fourni. |
[Tableau 3. Renvoie]

{#SR-getQualifiedRankedUsers_S_S_S_B__table_mcv_g1s_lhb}  

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