UserSkillRanking - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . UserSkillRanking A API 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 Gestão de habilidades plug-in (com.snc.skills_management), que você pode ativar se tiver a função de administrador.

    Consulte Qualifique e classifique 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 ususJson, cadeia de caracteres rankType, booliano isSkillLevelEnforced)

    Fornece uma lista de usuários qualificados com base nas habilidades e níveis obrigatórios correspondentes, se IsSkillLevelEnforçado o parâmetro é 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].
    UsadoJson 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.
    RankType 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 um valor vazio for fornecido.
    • NÚMERO_SKILLS - Número de habilidades correspondentes às habilidades necessárias.
    • NÚMERO_SKILL_ MATCHING_LEVEL - Número de habilidades do usuário correspondentes ao nível de habilidade necessário.
    • LEAST_SKILL_ LEVEL_GAP - Encontra a habilidade do usuário que atende mais aos requisitos de nível mínimo 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.
    IsSkillLevelEnforçado 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 3. Retornos
    Tipo Descrição
    Cadeia de caracteres Lista de usuários qualificados como JSON.

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

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