---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UserSkillRanking - 전역

# UserSkillRanking - 전역 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

UserSkillRanking API는 올바른 사용자를 선택하고 일치하는 기술 수 및 기술 수준 격차에 따라 자격을 갖춘 사용자의 정렬된 목록을 가져오는 옵션을 구성하는 메서드를 제공합니다.

이 API에는 관리자 역할이 있는 경우 활성화할 수 있는 플러그인(com.snc.skills_management)이 필요합니다 기술 관리 .

[기술 및 기술 수준에 따라 사용자 자격 부여 및 순위 지정](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}

UserSkillRanking 개체를 인스턴스화합니다.
{#SR-UserSkillRanking__table_shf_4b1_whb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#SR-UserSkillRanking__table_shf_4b1_whb}

## UserSkillRanking - getQualifiedRankedUsers(문자열 requiredSkillsJson, 문자열 usersJson, 문자열 rankType, 부울 isSkillLevelEnforced) {#ariaid-title3}

`isSkillLevelEnforced` 매개변수가 true인 경우 일치하는 필수 기술 및 수준을 기반으로 자격을 갖춘 사용자 목록을 제공합니다.
{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| requiredSkillsJson | 문자열 | 사용자에게 자격을 부여하는 데 필요한 기술 목록입니다. 각 기술은 다음 형식으로 JSON 항목으로 나열됩니다. * sys_id: 문자열. 기술 \[cmn_skill\] 테이블의 기술 시스템 ID입니다. * is_mandatory: 부울. 기술이 필수인지 여부를 나타내는 플래그입니다. * level: 문자열. 기술 수준 \[cmn_skill_level\] 테이블의 시스템 ID입니다. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_qrj_c5w_33b} |
| usersJson | 문자열 | 필요한 기술에 대해 자격을 갖추sys_user 사용자를 나타내는 테이블의 사용자 시스템 ID 목록(JSON 형식)입니다. |
| rankType | 문자열 | 순위 유형에 따라 자격을 갖춘 사용자를 정렬할 수 있습니다. 가능한 값은 일치하는 기술 수 및 기술 수준 격차를 기준으로 자격을 갖춘 사용자의 정렬된 목록을 제공하는 비교기입니다. * NO_RANKING(기본값) - 빈 값이 제공된 경우 사용됩니다. * NUM_SKILLS - 필요한 기술과 일치하는 기술의 수입니다. * NUM_SKILL_ MATCHING_LEVEL - 필요한 기술 수준과 일치하는 사용자 기술 수입니다. * LEAST_SKILL_ LEVEL_GAP -- 최소 기술 수준 요구 사항을 가장 근접하게 충족하는 사용자 기술을 찾습니다. * MOST_SKILL_ LEVEL_GAP -- 최소 기술 수준 요구 사항을 충족하지 못하는 사용자를 찾습니다. * BEST_OPTIMUM_ USER -- 모든 기술 수준에 맞는 최적의 사용자를 찾습니다. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_rw2_byz_vhb} |
| isSkillLevelEnforced | 부울 | 사용자가 필요한 모든 필수 기술에 대한 최소 기술 수준을 가져야 하면 True, 그렇지 않으면 False입니다. 기본값: false. |
[표 2. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | 자격을 갖춘 사용자 목록을 JSON으로 지정합니다. 매개변수가 부정확하거나 잘못된 형식의 JSON이 제공된 경우 오류가 발생합니다. |
[표 3. 반환]

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