UserSkillRanking - Global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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.

    UserSkillRanking - UserSkillRanking()

    Instancia um objeto UserSkillRanking.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum

    UserSkillRanking - getQualifiedRankedUsers(cadeia de caracteres requiredSkillsJson, cadeia de caracteres usersJson, cadeia de caracteres rankType, booliano isSkillLevelEnforced)

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

    Tabela 2. Parâmetros
    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].
    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.
    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 3. Retornos
    Tipo Descrição
    Cadeia de caracteres Lista de usuários qualificados como JSON.

    Erro se forem fornecidos parâmetros imprecisos ou JSON malformado.

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