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

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UserSkillRanking - 전역

# UserSkillRanking - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](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=australia&pubname=australia-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` 매개변수가 예일 경우 일치하는 필수 기술 및 수준을 기준으로 자격을 갖춘 사용자 목록을 제공합니다.
{#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} |
| 사용자 JSON | 문자열 | 필수 기술에 대해 자격을 갖추sys_user 사용자를 나타내는 테이블의 사용자 시스템 ID 목록(JSON 형식)입니다. |
| 순위 유형 | 문자열 | 순위 유형을 기준으로 자격을 갖춘 사용자를 정렬할 수 있습니다. 가능한 값은 일치하는 기술 수와 기술 수준 격차를 기준으로 정렬된 적격 사용자 목록을 제공하기 위한 비교기입니다. * NO_RANKING(기본값) - 빈 값이 제공된 경우 사용됩니다. * NUM_SKILLS - 필수 기술과 일치하는 기술의 수입니다. * NUM_SKILL_ MATCHING_LEVEL - 필수 기술 수준과 일치하는 사용자 기술 수입니다. * LEAST_SKILL_ LEVEL_GAP - 최소 기술 수준 요구 사항을 가장 근접하게 충족하는 사용자 기술을 찾습니다. * MOST_SKILL_ LEVEL_GAP -- 최소 기술 수준 요구 사항을 최소한으로 충족하는 사용자를 찾습니다. * 사용자 BEST_OPTIMUM_ -- 모든 기술 수준에 최적의 사용자를 찾습니다. {#SR-getQualifiedRankedUsers_S_S_S_B__ul_rw2_byz_vhb} |
| isSkillLevelEnforced | 부울 | 사용자가 모든 필수 기술에 대한 최소 기술 수준을 갖추어야 하는 경우 예, 그렇지 않으면 아니오입니다. 기본값: 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);