--- 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 --- # UserSkillAnalyzer - Global # UserSkillAnalyzer - Global {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura A API UserSkillAnalyzer fornece métodos para analisar as habilidades do usuário em relação às habilidades necessárias para concluir itens de trabalho. Esta API requer o plug-in Gestão de habilidades (com.snc.skills_management), que você pode ativar se tiver a função de administrador. Consulte [Como qualificar e classificar usuários com base em habilidades e níveis de habilidade](https://www.servicenow.com/docs/access?context=assign-work-based-on-skills&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). ## UserSkillAnalyzer - UserSkillAnalyzer() {#ariaid-title2} Instancia um novo objeto UserSkillAnalyzer. {#USA-UserSkillAnalyzer__table_shf_4b1_whb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | Nenhum | | | [Tabela 1. Parâmetros] {#USA-UserSkillAnalyzer__table_shf_4b1_whb} var userSkillAnalyzer = new SNC.UserSkillAnalyzer(); ## UserSkillAnalyzer - analiseUserByID (cadeia de caracteres requiredSkillsJson, cadeia de caracteres userID, booliano isSkillLevelEnforced) {#ariaid-title3} Analisa as habilidades do usuário em relação às habilidades necessárias e define o número de habilidades correspondentes, lacuna de nível de habilidade e qualificação que podem ser coletadas de uma instância. Analisa se um agente está qualificado para trabalhar em uma tarefa, verificando se o agente tem as habilidades e os níveis de habilidade necessários para concluir a tarefa. Se um agente estiver qualificado para trabalhar em uma tarefa, a API analisará a lacuna de nível entre as habilidades necessárias e o nível de habilidade do usuário, que pode ser usado pela aplicação para escolher o melhor agente com base na lacuna de nível. Ele também analisa o número total de habilidades com e sem níveis de habilidade que o agente tem para executar essa tarefa. {#USA-analyzeUserById_S_S_B__table_qps_bzr_lhb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | RequiredSkillsJSON | Cadeia de caracteres | Lista de habilidades necessárias para comparar com o usuário. Cada habilidade é listada como uma entrada JSON no seguinte formato: * sys_id: cadeia de caracteres. SYS ID da habilidade da tabela Habilidades \[cmn_skill\]. * is_mandatory: booliano. Sinalizador que indica se a habilidade é obrigatória. * nível: cadeia de caracteres. SYS ID da tabela Níveis de habilidade \[cmn_skill_level\]. {#USA-analyzeUserById_S_S_B__ul_q2f_xsw_33b} | | userID | Cadeia de caracteres | SYS ID da tabela Usuário \[sys_user\]. | | isSkillLevelEnforced | Booliano | Verdadeiro se o usuário precisar ter um nível mínimo de habilidade para todas as habilidades obrigatórias necessárias; caso contrário, falso. Padrão: falso. | [Tabela 2. Parâmetros] {#USA-analyzeUserById_S_S_B__table_qps_bzr_lhb} {#USA-analyzeUserById_S_S_B__table_kct_qrw_33b__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | JSON que contém todas as informações necessárias sobre o usuário com base no mapa de habilidades do analisador da seguinte forma: * sys_id: cadeia de caracteres. SYS ID da tabela Usuário \[sys_user\]. * is_qualified: booliano. Sinalizador que indica se o usuário está qualificado para as habilidades necessárias. * Verdadeiro se o usuário tiver todas as habilidades obrigatórias e o nível de habilidade for imposto. * Falso se o usuário não tiver todas as habilidades obrigatórias ou não atender aos requisitos de nível. {#USA-analyzeUserById_S_S_B__ul_ql2_rhq_g3b} * num_skills: número. Habilidades correspondentes às habilidades necessárias. * num_skills_matching_level: número. Habilidades do usuário correspondentes ao nível de habilidade necessário. * total_skill_level_gap: número. A lacuna de nível de habilidade ajuda o algoritmo de classificação a encontrar o usuário ideal que atende aos requisitos mínimos de nível de habilidade. Calculado com base na lacuna geral entre o nível de habilidade da tarefa e o nível de habilidade do usuário. O usuário deve ter o nível de habilidade necessário para as habilidades obrigatórias. * opcional_skill_level_gap: número. Fornece lacuna de nível de habilidade somente para habilidades opcionais. Auxilia os endpoints a distinguir entre o nível de habilidade total e a lacuna de nível de habilidade opcional. {#USA-analyzeUserById_S_S_B__ul_q1n_msd_f3b} Erro se forem fornecidos parâmetros imprecisos ou JSON malformado. | [Tabela 3. Retorna] {#USA-analyzeUserById_S_S_B__table_kct_qrw_33b} var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}, {"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}]; var userSysID = "a8f98bb0eb32010045e1a5115206fe3a"; var userSkillAnalyzer = new SNC.UserSkillAnalyzer(); var result = userSkillAnalyzer.analyzeUserById(JSON.stringify(skills), userSysID, true); gs.info('Results: ' + result); Saída: Calling user analyzer *** Script: Results: {"sys_id":"a8f98bb0eb32010045e1a5115206fe3a","is_qualified":false,"num_skills":0,"num_skills_matching_level":0,"total_skill_level_gap":0,"optional_skill_level_gap":0} ## UserSkillAnalyzer - analiseUserBySkills (cadeia de caracteres "needSkillsJson", cadeia de caracteres "userSkillsJson", booliano isSkillLevelEnforced) {#ariaid-title4} Analisa as habilidades do usuário em relação às habilidades necessárias e define o número de habilidades correspondentes, lacuna de nível de habilidade e qualificação que podem ser coletadas de uma instância. {#USA-analyzeUserBySkills_S_S_B__table_crq_fzr_lhb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | RequiredSkillsJson | Cadeia de caracteres | Lista de habilidades necessárias para qualificar os usuários. Cada habilidade é listada como uma entrada JSON no seguinte formato: * sys_id: cadeia de caracteres. SYS ID da habilidade da tabela Habilidades \[cmn_skill\]. * is_mandatory: booliano. Sinalizador que indica se a habilidade é obrigatória. * nível: cadeia de caracteres. SYS ID da tabela Níveis de habilidade \[cmn_skill_level\]. {#USA-analyzeUserBySkills_S_S_B__ul_imx_vsw_33b} | | userSkillsJSON | Cadeia de caracteres | Lista de habilidades do usuário para determinar a qualificação das habilidades necessárias. Cada habilidade é listada como uma entrada JSON no seguinte formato: * sys_id: cadeia de caracteres. SYS ID da habilidade da tabela Habilidades \[cmn_skill\]. * is_mandatory: booliano. Sinalizador que indica se a habilidade é obrigatória. * nível: cadeia de caracteres. SYS ID da tabela Níveis de habilidade \[cmn_skill_level\]. {#USA-analyzeUserBySkills_S_S_B__ul_kj3_h1c_j3b} | | isSkillLevelEnforced | Booliano | Verdadeiro se o usuário precisar ter o nível mínimo de habilidade para todas as habilidades obrigatórias necessárias; caso contrário, falso. Padrão: falso. | [Tabela 4. Parâmetros] {#USA-analyzeUserBySkills_S_S_B__table_crq_fzr_lhb} {#USA-analyzeUserBySkills_S_S_B__table_vdx_prw_33b__entry__2} | Tipo | Descrição | |-|-| | Cadeia de caracteres | JSON que contém todas as informações necessárias sobre o usuário com base no mapa de habilidades do analisador da seguinte forma: * sys_id: cadeia de caracteres. SYS ID da tabela Usuário \[sys_user\]. * is_qualified: booliano. Sinalizador que indica se o usuário está qualificado para as habilidades necessárias. * Verdadeiro se o usuário tiver todas as habilidades obrigatórias e o nível de habilidade for imposto. * Falso se o usuário não tiver todas as habilidades obrigatórias ou não atender aos requisitos de nível. {#USA-analyzeUserBySkills_S_S_B__ul_ql2_rhq_g3b} * num_skills: número. Habilidades correspondentes às habilidades necessárias. * num_skills_matching_level: número. Habilidades do usuário correspondentes ao nível de habilidade necessário. * total_skill_level_gap: número. A lacuna de nível de habilidade ajuda o algoritmo de classificação a encontrar o usuário ideal que atende aos requisitos mínimos de nível de habilidade. Calculado com base na lacuna geral entre o nível de habilidade da tarefa e o nível de habilidade do usuário. O usuário deve ter o nível de habilidade necessário para as habilidades obrigatórias. * opcional_skill_level_gap: número. Fornece lacuna de nível de habilidade somente para habilidades opcionais. Auxilia os endpoints a distinguir entre o nível de habilidade total e a lacuna de nível de habilidade opcional. {#USA-analyzeUserBySkills_S_S_B__ul_q1n_msd_f3b} Erro se forem fornecidos parâmetros imprecisos ou JSON malformado. | [Tabela 5. Retorna] {#USA-analyzeUserBySkills_S_S_B__table_vdx_prw_33b} var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}, {"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}]; var userSkills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}, {"sys_id":"k, th", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}]; var userSkillAnalyzer = new SNC.UserSkillAnalyzer(); var result = userSkillAnalyzer.analyzeUserBySkills(JSON.stringify(skills), JSON.stringify(userSkills)); gs.info('Results: ' + result);