---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

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

[「スキルとスキルレベルに基づくユーザーの認定とランク付け](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\] テーブルからのスキルの Sys ID。 * is_mandatory：ブール。スキルが必須かどうかを示すフラグ。 * level：文字列。スキルレベル \[cmn_skill_level\] テーブルからの Sys ID。 {#SR-getQualifiedRankedUsers_S_S_S_B__ul_qrj_c5w_33b} |
| usersJson | 文字列 | 必須スキルに対して認定されるユーザーを表す、sys_user テーブルから取得されたユーザーのSys 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);