UserSkillAnalyzer - グローバル

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：8分

    • UserSkillAnalyzer API は、作業アイテムを完了するために必要なスキルに対してユーザースキルを分析するメソッドを提供します。

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

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

    UserSkillAnalyzer - UserSkillAnalyzer()

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

    表 : 1. パラメーター
    名前 タイプ 説明
    なし 
    
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();

    UserSkillAnalyzer - analyzeUserByID(文字列 requiredSkillsJson, 文字列 userID, ブーリアン isSkillLevelEnforced)

    必要なスキルに対してユーザースキルを分析し、インスタンスから収集可能な一致するスキルの数、スキルレベルのギャップ、および資格を設定します。

    タスクを完了するために必要なすべてのスキルとスキルレベルをエージェントが持っているかどうかを検証することで、そのタスクを処理する資格がそのエージェントにあるかどうかを分析します。タスクを処理する資格がエージェントにある場合、API が必要なスキルとユーザーのスキルレベルの間のレベルのギャップを分析し、さらにそれを用いて、レベルのギャップに基づいて最適なエージェントを選択します。また、そのタスクを実行するために必要なスキルレベルをエージェントが持っているスキルと持っていないスキルの合計数も分析します。

    表 : 2. パラメーター
    名前 タイプ 説明
    requiredSkillsJson 文字列 ユーザーと比較するために必要なスキルのリスト。
    各スキルは次の形式の JSON エントリーとして一覧表示されます。
    • sys_id：文字列。スキル [cmn_skill] テーブルからのスキルの Sys ID。
    • is_mandatory：ブール。スキルが必須かどうかを示すフラグ。
    • level：文字列。スキルレベル [cmn_skill_level] テーブルからの Sys ID。
    userID 文字列 ユーザー [sys_user] テーブルのSys ID。
    isSkillLevelEnforced ブーリアン ユーザーがすべての必須スキルに対して最低限のスキルレベルを持っている必要がある場合は true、そうでない場合は false。デフォルト値：false。
    表 : 3. 返される内容
    タイプ 説明
    文字列 次のようなアナライザースキルマップに基づいて、ユーザーに関するすべての必要な情報を含む JSON。
    • sys_id：文字列。ユーザー [sys_user] テーブルのSys ID。
    • is_qualified：ブール。ユーザーが必要なスキルを認定されているかどうかを示すフラグ。
      • ユーザーがすべての必須スキルを持ち、スキルレベルが適用される場合は true。
      • ユーザーが一部の必須スキルを持っていないか、レベル要件を満たしていない場合は false。
    • num_skills：数値。必要なスキルと一致するスキル。
    • num_skills_matching_level：数値。必要なスキルレベルに一致するユーザースキル。
    • total_skill_level_gap：数値。スキルレベルギャップは、ランキングアルゴリズムでスキルレベルの最低要件を満たす最適なユーザーを見つけるのに役立ちます。タスクスキルレベルとユーザースキルレベルの間の全体的なギャップに基づいて計算されます。ユーザーは必須スキルのスキルレベルを持っている必要があります。
    • optional_skill_level_gap：数値。オプションのスキルについてのみスキルレベルのギャップを提供します。合計スキルレベルとオプションのスキルレベルギャップを区別できるようにエンドポイントを支援します。

    不正確なパラメーターまたは不正な形式の JSON が提供された場合はエラー。

    		 
    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
			  {"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSysID = "a8f98bb0eb32010045e1a5115206fe3a";
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();
var result = userSkillAnalyzer.analyzeUserById(JSON.stringify(skills), userSysID, true);
gs.info('Results: ' + result);

    出力：

    Calling user analyzer
*** Script: Results: {"sys_id":"a8f98bb0eb32010045e1a5115206fe3a","is_qualified":false,"num_skills":0,"num_skills_matching_level":0,"total_skill_level_gap":0,"optional_skill_level_gap":0}

    UserSkillAnalyzer - analyzeUserBySkills(文字列 requiredSkillsJson, 文字列 userSkillsJson, ブーリアン isSkillLevelEnforced)

    必要なスキルに対してユーザースキルを分析し、インスタンスから収集可能な一致するスキルの数、スキルレベルのギャップ、および資格を設定します。

    表 : 4. パラメーター
    名前 タイプ 説明
    requiredSkillsJson 文字列 ユーザーの認定の対象として必要なスキルのリスト。
    各スキルは次の形式の JSON エントリーとして一覧表示されます。
    • sys_id：文字列。スキル [cmn_skill] テーブルからのスキルの Sys ID。
    • is_mandatory：ブール。スキルが必須かどうかを示すフラグ。
    • level：文字列。スキルレベル [cmn_skill_level] テーブルからの Sys ID。
    userSkillsJson 文字列 必要なスキルの認定を決定するためのユーザースキルのリスト。
    各スキルは次の形式の JSON エントリーとして一覧表示されます。
    • sys_id：文字列。スキル [cmn_skill] テーブルからのスキルの Sys ID。
    • is_mandatory：ブール。スキルが必須かどうかを示すフラグ。
    • level：文字列。スキルレベル [cmn_skill_level] テーブルからの Sys ID。
    isSkillLevelEnforced ブーリアン ユーザーがすべての必須スキルに対して最低限のスキルレベルを持っている必要がある場合は true、そうでない場合は false。デフォルト値：false。
    表 : 5. 返される内容
    タイプ 説明
    文字列 次のようなアナライザースキルマップに基づいて、ユーザーに関するすべての必要な情報を含む JSON。
    • sys_id：文字列。ユーザー [sys_user] テーブルのSys ID。
    • is_qualified：ブール。ユーザーが必要なスキルを認定されているかどうかを示すフラグ。
      • ユーザーがすべての必須スキルを持ち、スキルレベルが適用される場合は true。
      • ユーザーが一部の必須スキルを持っていないか、レベル要件を満たしていない場合は false。
    • num_skills：数値。必要なスキルと一致するスキル。
    • num_skills_matching_level：数値。必要なスキルレベルに一致するユーザースキル。
    • total_skill_level_gap：数値。スキルレベルギャップは、ランキングアルゴリズムでスキルレベルの最低要件を満たす最適なユーザーを見つけるのに役立ちます。タスクスキルレベルとユーザースキルレベルの間の全体的なギャップに基づいて計算されます。ユーザーは必須スキルのスキルレベルを持っている必要があります。
    • optional_skill_level_gap：数値。オプションのスキルについてのみスキルレベルのギャップを提供します。合計スキルレベルとオプションのスキルレベルギャップを区別できるようにエンドポイントを支援します。

    不正確なパラメーターまたは不正な形式の JSON が提供された場合はエラー。

    		 
    var skills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
				{"sys_id":"48c9fdddc0a8018b04bd8d7914c82c9d", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSkills = [{"sys_id":"48c9f873c0a8018b65c3814608b201e6", "is_mandatory": true, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"},
		    {"sys_id":"k, th", "is_mandatory": false, "level":"4e0ac4d6b3332300290ea943c6a8dc4e"}];
var userSkillAnalyzer = new SNC.UserSkillAnalyzer();
var result = userSkillAnalyzer.analyzeUserBySkills(JSON.stringify(skills), JSON.stringify(userSkills));
gs.info('Results: ' + result);