SkillDeterminationUtils : inclus dans le champ d’application

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture
  • L’API SkillDeterminationUtils fournit des méthodes utilitaires pour obtenir ou définir des données de compétences d’élément de travail.

    L’API SkillDeterminationUtils requiert le module d’extension Skill Determination (com.snc.skill_determination) et est fournie dans l’espace de noms sn_skill_rule .

    SkillDeterminationUtils : assignSkillsToWorkItem(Array skills, GlideRecord now_GR)

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

    Tableau 1. 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 2. 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érer 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 d’un élément de travail spécifié, indique si les compétences sont obligatoires et répertorie tous les niveaux de compétence.

    Tableau 3. Paramètres
    Nom Type Description
    now_GR GlideRecord GlideRecord d’un élément de travail à partir de n’importe quelle extension de table d’interaction ou de tâche.
    Tableau 4. Renvoie
    Type Description
    Tableau Un ou plusieurs objets de compétence.
    • skillSysId : chaîne. ID système de la compétence issu de la table Compétences [cmn_skill].
    • skillName : chaîne. Nom de la compétence.
    • obligatoire : booléen. Vrai si obligatoire, faux dans le cas contraire.
    • skillLevelName : si une compétence existe, le nom du niveau de compétence.
    • skillLevelSysId : si une compétence existe, ID système du niveau de compétence issu de la table Niveaux de compétence [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 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}]

    SkillDeterminationUtils - SkillDeterminationUtils()

    Constructeur permettant de créer une instance de SkillDeterminationUtils.

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