SkillDeterminationUtils - Com escopo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . SkillDeterminationUtils a inclusão de script fornece métodos de utilitário para obter ou definir dados de habilidade do item de trabalho.

    Esta inclusão de script requer o plug-in Determinação de habilidade (com.snc.skill_determination) e é fornecida em sn_skill_rule namespace.

    SkillDeterminationUtils - SkillDeterminationUtils()

    Construtor para criar uma instância de SkillDeterminationUtils.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    var util = new sn_skill_rule.SkillDeterminationUtils();

    SkillDeterminationUtils - assignSkillsToWorkItem(Habilidades de matriz, GlideRecord now_GR)

    Atribui uma matriz de objetos de habilidade ativos a um item de trabalho.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    habilidades Matriz Matriz de objetos de habilidade ativos a serem atribuídos.
    Skill.skillName Cadeia de caracteres Nome da habilidade.
    Skill.skillSYSID Cadeia de caracteres Sys ID da habilidade.
    habilidade.obrigatória Booliano Verdadeiro se a habilidade for obrigatória, caso contrário, falso.
    Skill.skillLevelName Cadeia de caracteres Nome do nível de habilidade opcional.
    Skill.skillLevelSysId Cadeia de caracteres Sys ID de nível de habilidade opcional.
    Now_GR GlideRecord GlideRecord do item de trabalho ao qual atribuir habilidades.
    Tabela 3. Retornos
    Tipo Descrição
    Nenhum(a)

    Os exemplos abaixo criam um registro de interação usando o nome da tabela (interação) e mostram como atribuir habilidades ao item de trabalho de interação, criando um registro na tabela Habilidades de interação [interaction_m2m_skill].

    Caso de uso 1: Use resultados retornados de determineWorkItemSkills() para atribuir habilidades a um item de trabalho da tabela de interação.

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

    Caso de uso 2: Inserir manualmente a matriz de habilidades. Nesse caso, atribua habilidades DE TI ao item de trabalho Interação.

    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)

    Obtém habilidades para um item de trabalho especificado, indica se as habilidades são obrigatórias e lista todos os níveis de habilidade.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    Now_GR GlideRecord GlideRecord de um item de trabalho de qualquer interação ou extensão de tabela de tarefas.
    Tabela 5. Retornos
    Tipo Descrição
    Matriz Um ou mais objetos de habilidade.
    • SkillSysId: Cadeia de caracteres. Sys ID da habilidade da tabela Habilidades [cmn_skill].
    • SkillName: Cadeia de caracteres. Nome da habilidade.
    • Booliano. Verdadeiro se obrigatório, falso caso contrário.
    • Skill LevelName: Se a habilidade existir, o nome do nível de habilidade.
    • Skill LevelSysId: Se houver habilidade, o SYS ID do nível de habilidade da tabela Níveis de habilidade [cmn_skill_level].

    O script a seguir cria um registro de interação, obtém habilidades para o item de trabalho de interação e indica se as habilidades são obrigatórias.

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

    Saída:

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