SkillDeterminationUtils : inclus dans le champ d’application

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture
  • L’include de script SkillDeterminationUtils fournit des méthodes utilitaires pour obtenir ou définir des données de compétences d’élément 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
    Aucun
    var util = new sn_skill_rule.SkillDeterminationUtils();

    SkillDeterminationUtils : assignSkillsToWorkItem(Array skills, GlideRecord now_GR)

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

    Tableau 2. Paramètres
    Nom Type Description
    compétences Tableau Tableau d’objets de compétences actifs à 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 auquel affecter des compétences.
    Tableau 3. Renvoie
    Type Description
    Aucun

    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 retournés de determineWorkItemSkills() pour affecter des compétences à un élément de travail à partir de la table d’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érer manuellement un tableau de compétences. Dans ce cas, affectez des compétences informatiques à l’élément de travail d’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écifié, 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 de la table Compétences [cmn_skill].
    • skillName : chaîne de caractères. Nom de la compétence.
    • obligatoire : booléen. Vrai si obligatoire, faux dans les autres cas.
    • skillLevelName : si une compétence existe, nom du niveau de compétence.
    • skillLevelSysId : si une compétence existe, ID système du niveau de compétence de la table Niveaux de compétence [cmn_skill_level].

    Le script suivant crée un enregistrement d’interaction, obtient des compétences pour l’élément de travail d’interaction et indique si ces 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}]