UserSkillAnalyzer : global

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

    • Analyse les compétences de l’utilisateur par rapport aux compétences requises pour terminer les éléments de travail.

    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 Qualifier et classer les utilisateurs en fonction de leurs compétences et de leurs niveaux de compétence.

    UserSkillAnalyzer : analyzeUserByID(String requiredSkillsJson, String userID, Boolean isSkillLevelEnforced)

    Analyse les compétences des utilisateurs par rapport aux compétences requises et définit le nombre de compétences correspondantes, l’écart de niveau de compétence et la qualification qui peuvent être collectés à partir d’une instance.

    Analyse si un agent est qualifié pour travailler sur une tâche en vérifiant si l’agent possède les compétences et les niveaux de compétence requis pour accomplir la tâche. Si un agent est qualifié pour travailler sur une tâche, l’API analyse l’écart de niveau entre les compétences requises et le niveau de compétence de l’utilisateur, qui peut ensuite être utilisé par l’application pour choisir le meilleur agent en fonction de l’écart de niveau. Il analyse également le nombre total de compétences avec et sans niveaux de compétences dont dispose l’agent pour exécuter cette tâche.

    Tableau 1. Paramètres
    Nom Type Description
    requiredSkillsJson (en anglais seulement) Chaîne Liste des compétences requises à comparer avec l’utilisateur.
    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 issue de la table Compétences [cmn_skill].
    • is_mandatory : booléen. Marqueur indiquant si la compétence est obligatoire.
    • level : chaîne de caractères. ID système de la table Niveaux de compétences [cmn_skill_level].
    userID Chaîne ID système de la table Utilisateur [sys_user].
    isSkillLevelEnforced (en anglais seulement) 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 : false.
    Tableau 2. Renvoie
    Type Description
    Chaîne JSON qui contient toutes les informations requises sur l’utilisateur en fonction de la carte des compétences de l’analyseur comme suit :
    • sys_id : chaîne de caractères. ID système de la table Utilisateur [sys_user].
    • is_qualified : booléen. Marqueur indiquant si l’utilisateur est qualifié pour les compétences requises.
      • Vrai si l’utilisateur possède toutes les compétences obligatoires et que le niveau de compétence est appliqué.
      • Faux si l’utilisateur ne possède pas toutes les compétences obligatoires ou ne répond pas aux exigences de niveau.
    • num_skills : Nombre. Compétences correspondantes par rapport aux compétences requises.
    • num_skills_matching_level : Nombre. Compétences de l’utilisateur correspondant au niveau de compétence requis.
    • total_skill_level_gap : Nombre. L’écart de niveau de compétence aide l’algorithme de classement à trouver l’utilisateur optimal répondant aux exigences de niveau de compétence minimales. Calculé sur la base de l’écart global entre le niveau de compétence de la tâche et le niveau de compétence de l’utilisateur. L’utilisateur doit avoir le niveau de compétence requis pour les compétences obligatoires.
    • optional_skill_level_gap : Nombre. Fournit un écart de niveau de compétence pour les compétences facultatives uniquement. Aide les points de terminaison à faire la distinction entre le niveau de compétence total et l’écart de niveau de compétence facultatif.

    Erreur si paramètres inexacts ou JSON fourni de manière incorrecte.

    		 
    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
			  {"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSysID = "a8f98bb0eb32010045e1a5115206fe3a";
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();
var result = userSkillAnalyzer.analyzeUserById(JSON.stringify(skills), userSysID, true);
gs.info('Results: ' + result);

    Sortie :

    Calling user analyzer
*** Script: Results: {"sys_id":"a8f98bb0eb32010045e1a5115206fe3a","is_qualified":false,"num_skills":0,"num_skills_matching_level":0,"total_skill_level_gap":0,"optional_skill_level_gap":0}

    UserSkillAnalyzer : analyzeUserBySkills(String requiredSkillsJson, String userSkillsJson, Boolean isSkillLevelEnforced)

    Analyse les compétences des utilisateurs par rapport aux compétences requises et définit le nombre de compétences correspondantes, l’écart de niveau de compétence et la qualification qui peuvent être collectés à partir d’une instance.

    Tableau 3. Paramètres
    Nom Type Description
    requiredSkillsJson (en anglais seulement) 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 issue de la table Compétences [cmn_skill].
    • is_mandatory : booléen. Marqueur indiquant si la compétence est obligatoire.
    • level : chaîne de caractères. ID système de la table Niveaux de compétences [cmn_skill_level].
    userSkillsJson Chaîne Liste des compétences de l’utilisateur pour déterminer la qualification pour les compétences requises.
    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 issue de la table Compétences [cmn_skill].
    • is_mandatory : booléen. Marqueur indiquant si la compétence est obligatoire.
    • level : chaîne de caractères. ID système de la table Niveaux de compétences [cmn_skill_level].
    isSkillLevelEnforced (en anglais seulement) 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 : false.
    Tableau 4. Renvoie
    Type Description
    Chaîne JSON qui contient toutes les informations requises sur l’utilisateur en fonction de la carte des compétences de l’analyseur comme suit :
    • sys_id : chaîne de caractères. ID système de la table Utilisateur [sys_user].
    • is_qualified : booléen. Marqueur indiquant si l’utilisateur est qualifié pour les compétences requises.
      • Vrai si l’utilisateur possède toutes les compétences obligatoires et que le niveau de compétence est appliqué.
      • Faux si l’utilisateur ne possède pas toutes les compétences obligatoires ou ne répond pas aux exigences de niveau.
    • num_skills : Nombre. Compétences correspondantes par rapport aux compétences requises.
    • num_skills_matching_level : Nombre. Compétences de l’utilisateur correspondant au niveau de compétence requis.
    • total_skill_level_gap : Nombre. L’écart de niveau de compétence aide l’algorithme de classement à trouver l’utilisateur optimal répondant aux exigences de niveau de compétence minimales. Calculé sur la base de l’écart global entre le niveau de compétence de la tâche et le niveau de compétence de l’utilisateur. L’utilisateur doit avoir le niveau de compétence requis pour les compétences obligatoires.
    • optional_skill_level_gap : Nombre. Fournit un écart de niveau de compétence pour les compétences facultatives uniquement. Aide les points de terminaison à faire la distinction entre le niveau de compétence total et l’écart de niveau de compétence facultatif.

    Erreur si paramètres inexacts ou JSON fourni de manière incorrecte.

    		 
    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
				{"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSkills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
		    {"sys_id":"k, th", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();
var result = userSkillAnalyzer.analyzeUserBySkills(JSON.stringify(skills), JSON.stringify(userSkills));
gs.info('Results: ' + result);

    UserSkillAnalyzer - UserSkillAnalyzer()

    Instancie un nouvel objet UserSkillAnalyzer.

    Tableau 5. Paramètres
    Nom Type Description
    Néant 
    
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();