---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

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) が必要です。admin ロールを持っている場合はアクティブ化できます。

スキル [とスキルレベルに基づいてユーザーの認定とランク付け](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` パラメーターが true の場合、一致する必須スキルとレベルに基づいて認定ユーザーのリストを提供します。
{#SR-getQualifiedRankedUsers_S_S_S_B__table_lcv_g1s_lhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| requiredSkillsJson | 文字列 | ユーザーの認定に必要なスキルのリスト。 各スキルは、次の形式の JSON エントリとしてリストされます。 * sys_id:文字列。スキル \[cmn_skill\] テーブルのスキルの Sys ID。 * is_mandatory:ブーリアン。スキルが必須かどうかを示すフラグ。 * level:文字列。スキルレベル \[cmn_skill_level\] テーブルの Sys ID。 {#SR-getQualifiedRankedUsers_S_S_S_B__ul_qrj_c5w_33b} |
| ユーザーの JSON | 文字列 | 必要なスキルに対して認定されているユーザーを表す、テーブルsys_userユーザー Sys 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 | ブーリアン | ユーザーが必要なすべての必須スキルの最小スキルレベルを持っている必要がある場合は 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);