SkillDeterminationUtils : dans le champ d’application

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture
  • L’include de script SkillDeterminationUtils fournit des méthodes utilitaires permettant d’obtenir ou de définir des données de compétences d’éléments de travail.

    Cet include de script nécessite le module d’extension Skill Determination (com.snc.skill_determination) et est fourni dans l’espace de noms sn_skill_rule .

    SkillDeterminationUtils : SkillDeterminationUtils()

    Constructeur permettant de créer une instance de SkillDeterminationUtils.

    Tableau 1. Paramètres
    Nom Type Description
    Néant
    var util = new sn_skill_rule.SkillDeterminationUtils();

    SkillDeterminationUtils : assignSkillsToWorkItem(Array skills, GlideRecord now_GR)

    Affecte un tableau d’objets de compétence actifs à un élément de travail.

    Tableau 2. Paramètres
    Nom Type Description
    compétences Tableau Tableau d’objets de compétences actives à affecter.
    skill.skillName Chaîne Nom de la compétence.
    skill.skillSysId Chaîne ID système de la compétence.
    compétence.obligatoire Booléen Vrai si la compétence est obligatoire, faux dans les autres cas.
    skill.skillLevelName Chaîne Nom du niveau de compétence facultatif.
    skill.skillLevelSysId Chaîne ID système du niveau de compétence facultatif.
    now_GR GlideRecord GlideRecord de l’élément de travail sur lequel affecter des compétences.
    Tableau 3. Renvoie
    Type Description
    Néant

    Les exemples ci-dessous créent un enregistrement d’interaction à l’aide du nom de table (interaction) et montrent comment affecter des compétences à l’élément de travail d’interaction, en créant un enregistrement dans la table Compétences d’interaction [interaction_m2m_skill].

    Cas d’utilisation 1 : utilisez les résultats renvoyés par determineWorkItemSkills() pour affecter des compétences à un élément de travail à partir de la table Interaction.

    // Create an interaction record
    var now_GR = new GlideRecord('interaction');
    now_GR.insert();
    
    var util = new sn_skill_rule.SkillDeterminationUtils();
    
    // Get interaction skills interaction 
    // and specify if any are mandatory
    var result = util.determineWorkItemSkills(now_GR);
    
    // Assign skills determined by result and 
    // assign them to the interaction work item
    util.assignSkillsToWorkItem(result, now_GR);

    Cas d’utilisation 2 : insérez manuellement un tableau de compétences. Dans ce cas, affectez des compétences informatiques à l’élément de travail Interaction.

    var now_GR = new GlideRecord('interaction');
    now_GR.insert();
    
    var util = new sn_skill_rule.SkillDeterminationUtils();
    
    var skills = [{"skillSysId":"2eb1c2029f100200a3bc1471367fcfe4", "skillName":"IT", "mandatory":true, "skillLevelName":"", "skillLevelSysId":null}];
    
    util.assignSkillsToWorkItem(skills, now_GR);

    SkillDeterminationUtils : determineWorkItemSkills(GlideRecord now_GR)

    Obtient les compétences pour un élément de travail spécifique, indique si les compétences sont obligatoires et répertorie tous les niveaux de compétence.

    Tableau 4. Paramètres
    Nom Type Description
    now_GR GlideRecord GlideRecord d’un élément de travail à partir de n’importe quelle interaction ou extension de table de tâches.
    Tableau 5. Renvoie
    Type Description
    Tableau Un ou plusieurs objets de compétence.
    • skillSysId : chaîne. ID système de la compétence dans la table Compétences [cmn_skill].
    • skillName : chaîne. Nom de la compétence.
    • mandatory : booléen. Vrai si obligatoire, faux dans les autres cas.
    • skillLevelName : si la compétence existe, nom du niveau de compétence.
    • skillLevelSysId : si la compétence existe, ID système du niveau de compétence de la table Niveaux de compétences [cmn_skill_level].

    Le script suivant crée un enregistrement d’interaction, obtient les compétences pour l’élément de travail d’interaction et indique si les compétences sont obligatoires.

    // Create an interaction record
    var now_GR = new GlideRecord('interaction');
    now_GR.insert();
    
    var util = new sn_skill_rule.SkillDeterminationUtils();
    
    var result = util.determineWorkItemSkills(now_GR);
    gs.info(JSON.stringify(result));

    Sortie :

    [{"skillSysId":"6c0f025c7f672300a8b1bdc8adfa917f",
    "skillName":"Premier Support Certified",
    "mandatory":false,"skillLevelName":"",
    "skillLevelSysId":null}]