---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SkillDeterminationUtils - com escopo

# SkillDeterminationUtils - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A inclusão de script SkillDeterminationUtils 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 no namespace `sn_skill_rule`.

## SkillDeterminationUtils - SkillDeterminationUtils() {#ariaid-title2}

Construtor para criar uma instância de SkillDeterminationUtils.
{#SkillDeterminationUtilsConstructor__table_v2y_sh5_fhb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#SkillDeterminationUtilsConstructor__table_v2y_sh5_fhb}  

    var util = new sn_skill_rule.SkillDeterminationUtils();

## SkillDeterminationUtils -- assignSkillsToWorkItem (habilidades de matriz, GlideRecord now_GR) {#ariaid-title3}

Atribui uma matriz de objetos de habilidade ativos a um item de trabalho.
{#assignSkillsToWorkItem_A_GR__table_cv2_w45_fhb__entry__3}

| 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 do nível de habilidade opcional. |
| now_GR | GlideRecord | GlideRecord do item de trabalho ao qual habilidades serão atribuídas. |
[Tabela 2. Parâmetros]

{#assignSkillsToWorkItem_A_GR__table_cv2_w45_fhb} {#assignSkillsToWorkItem_A_GR__table_dv2_w45_fhb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 3. Retorna]

{#assignSkillsToWorkItem_A_GR__table_dv2_w45_fhb}  
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 os 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 de 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) {#ariaid-title4}

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.
{#determineWorkItemSkills_GR__table_hct_yl5_fhb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| now_GR | GlideRecord | GlideRecord de um item de trabalho de qualquer interação ou extensão da tabela de tarefas. |
[Tabela 4. Parâmetros]

{#determineWorkItemSkills_GR__table_hct_yl5_fhb} {#determineWorkItemSkills_GR__table_ict_yl5_fhb__entry__2}

| 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. * obrigatório: booliano. Verdadeiro se obrigatório, falso caso contrário. * skillLevelName: se a habilidade existir, o nome do nível de habilidade. * skillLevelSysId: se a habilidade existir, o SYS ID do nível de habilidade da tabela Níveis de habilidade \[cmn_skill_level\]. {#determineWorkItemSkills_GR__ul_bwb_5nb_j3b} |
[Tabela 5. Retorna]

{#determineWorkItemSkills_GR__table_ict_yl5_fhb}  
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}]