UserSkillRanking :グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

    • UserSkillRanking API には、適切なユーザーを選択し、一致するスキルの数とスキルレベルのギャップに基づいて適格ユーザーのソート済みリストを取得するためのオプションを構成するメソッドが用意されています。

    この API には スキル管理 プラグイン (com.snc.skills_management) が必要です。admin ロールを持っている場合はアクティブ化できます。

    スキル とスキルレベルに基づいてユーザーの認定とランク付けを参照してください。

    UserSkillRanking:UserSkillRanking()

    UserSkillRanking オブジェクトをインスタンス化します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし

    UserSkillRanking:getQualifiedRankedUsers(文字列 requiredSkillsJson, 文字列 usersJson, 文字列 rankType, ブール値 isSkillLevelEnforced)

    isSkillLevelEnforced パラメーターが true の場合、一致する必須スキルとレベルに基づいて認定ユーザーのリストを提供します。

    表 : 2. パラメーター
    名前 タイプ 説明
    requiredSkillsJson 文字列 ユーザーの認定に必要なスキルのリスト。
    各スキルは、次の形式の JSON エントリとしてリストされます。
    • sys_id:文字列。スキル [cmn_skill] テーブルのスキルの Sys ID。
    • is_mandatory:ブーリアン。スキルが必須かどうかを示すフラグ。
    • level:文字列。スキルレベル [cmn_skill_level] テーブルの Sys ID。
    ユーザーの JSON 文字列 必要なスキルに対して認定されているユーザーを表す、テーブルsys_userユーザー Sys ID のリスト (JSON 形式)。
    ランクタイプ 文字列

    ランク付けタイプに基づいて適格なユーザーをソートできるようにします。可能な値は、一致するスキルの数とスキルレベルのギャップに基づいて適格なユーザーのソート済みリストを提供するためのコンパレーターです。

    • NO_RANKING (デフォルト):空の値が指定された場合に使用されます。
    • NUM_SKILLS:必要なスキルに一致するスキルの数。
    • NUM_SKILL_ MATCHING_LEVEL:必要なスキルレベルに一致するユーザースキルの数。
    • LEAST_SKILL_ LEVEL_GAP:最小スキルレベル要件に最も近いユーザースキルを検索します。
    • MOST_SKILL_ LEVEL_GAP:最小スキルレベル要件を最も満たしていないユーザーを検索します。
    • BEST_OPTIMUM_ユーザー:すべてのスキルレベルに最適なユーザーを検索します。
    isSkillLevelEnforced ブーリアン ユーザーが必要なすべての必須スキルの最小スキルレベルを持っている必要がある場合は true、それ以外の場合は false。デフォルト値：false。
    表 : 3. 返される内容
    タイプ 説明
    文字列 認定ユーザーのリスト (JSON 形式)。

    指定されたパラメーターが不正確であるか、JSON の形式が正しくない場合はエラー。

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