---
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


---

# UserSkillRanking - Global

# UserSkillRanking - Global {#ariaid-title1}

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

A API UserSkillRanking fornece métodos para configurar opções para escolher o usuário certo e obter uma lista classificada de usuários qualificados com base no número de habilidades correspondentes e na lacuna de nível de habilidade.

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).

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

Instancia um objeto UserSkillRanking.
{#SR-UserSkillRanking__table_shf_4b1_whb__entry__3}

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

{#SR-UserSkillRanking__table_shf_4b1_whb}

## UserSkillRanking - getQualifiedRankedUsers(cadeia de caracteres requiredSkillsJson, cadeia de caracteres usersJson, cadeia de caracteres rankType, booliano isSkillLevelEnforced) {#ariaid-title3}

Fornece uma lista de usuários qualificados com base nas habilidades e níveis obrigatórios correspondentes se o parâmetro `isSkillLevelEnforced` for verdadeiro).
{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| RequiredSkillsJson | Cadeia de caracteres | Lista de habilidades necessárias para qualificar 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\]. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_qrj_c5w_33b} |
| usuáriosJSON | Cadeia de caracteres | Lista de SYS IDs de usuário da tabela sys_user (no formato JSON) que representam usuários a serem qualificados em relação às habilidades necessárias. |
| classificaçãoTipo | Cadeia de caracteres | Habilita a classificação de usuários qualificados com base no tipo de classificação. Os valores possíveis são comparadores para fornecer uma lista classificada de usuários qualificados com base no número de habilidades correspondentes e na lacuna de nível de habilidade: * NO_RANKING (padrão) -- Usado se for fornecido um valor vazio. * NUM_SKILLS -- número de habilidades correspondentes às habilidades necessárias. * NUM_SKILL_ MATCHING_LEVEL -- número de habilidades do usuário que correspondem ao nível de habilidade necessário. * LAST_SKILL_ LEVEL_GAP: encontra a habilidade do usuário que mais atende aos requisitos mínimos de nível de habilidade. * MOST_SKILL_ LEVEL_GAP: encontra o usuário que menos atende aos requisitos mínimos de nível de habilidade. * BEST_OPTIMUM_ USER: encontra o usuário ideal para todos os níveis de habilidade. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_rw2_byz_vhb} |
| 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 2. Parâmetros]

{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb} {#SR-getQualifiedRankedUsers_S_S_S_B__table_mcv_g1s_lhb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Lista de usuários qualificados como JSON. Erro se forem fornecidos parâmetros imprecisos ou JSON malformado. |
[Tabela 3. Retorna]

{#SR-getQualifiedRankedUsers_S_S_S_B__table_mcv_g1s_lhb}  

    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
    				{"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4eS"}];
    var users = ["a8f98bb0eb32010045e1a5115206fe3a", "62826bf03710200044e0bfc8bcbe5df1"];
    var userSkillRanking = new SNC.UserSkillRanking();
    var qualifiedUsers = userSkillRanking.getQualifiedRankedUsers(JSON.stringify(skills), JSON.stringify(users), "BEST_OPTIMUM_USER", true);