--- 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 --- # UserSkillAnalyzer: グローバル # UserSkillAnalyzer: グローバル {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分 UserSkillAnalyzer 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)を参照してください。 ## UserSkillAnalyzer:UserSkillAnalyzer() {#ariaid-title2} 新しい UserSkillAnalyzer オブジェクトをインスタンス化します。 {#USA-UserSkillAnalyzer__table_shf_4b1_whb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | なし | | | [表 : 1. パラメーター] {#USA-UserSkillAnalyzer__table_shf_4b1_whb} var userSkillAnalyzer = new SNC.UserSkillAnalyzer(); ## UserSkillAnalyzer - analyzeUserByID(文字列 requiredSkillsJson, 文字列 userID, ブール値 isSkillLevelEnforced) {#ariaid-title3} 必要なスキルに対してユーザーのスキルを分析し、インスタンスから収集できる一致するスキル、スキルレベルギャップ、および資格の数を設定します。 エージェントがタスクを完了するために必要なスキルとスキルレベルを持っているかどうかを検証することで、エージェントがタスクを処理する資格があるかどうかを分析します。エージェントがタスクを処理する資格がある場合、API は必要なスキルとユーザーのスキルレベルとの間のレベルギャップを分析し、アプリケーションでさらにこれを使用して、レベルギャップに基づいて最適なエージェントを選択できます。また、エージェントがそのタスクを実行するために必要なスキルレベルありスキルとスキルなしスキルの合計数も分析します。 {#USA-analyzeUserById_S_S_B__table_qps_bzr_lhb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | requiredSkillsJson | 文字列 | ユーザーと比較するために必要なスキルのリスト。 各スキルは、次の形式の JSON エントリとしてリストされます。 * sys_id:文字列。スキル \[cmn_skill\] テーブルのスキルの Sys ID。 * is_mandatory:ブーリアン。スキルが必須かどうかを示すフラグ。 * level:文字列。スキルレベル \[cmn_skill_level\] テーブルの Sys ID。 {#USA-analyzeUserById_S_S_B__ul_q2f_xsw_33b} | | userID | 文字列 | ユーザー \[sys_user\] テーブルの Sys ID。 | | isSkillLevelEnforced | ブーリアン | 必要なすべての必須スキルの最小スキルレベルを持つ必要がある場合は true、それ以外の場合は false。デフォルト値：false。 | [表 : 2. パラメーター] {#USA-analyzeUserById_S_S_B__table_qps_bzr_lhb} {#USA-analyzeUserById_S_S_B__table_kct_qrw_33b__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 次のように、アナライザースキルマップに基づいてユーザーに関する必要なすべての情報を含む JSON。 * sys_id:文字列。ユーザー \[sys_user\] テーブルの Sys ID。 * is_qualified:ブーリアン。ユーザーが必要なスキルの資格があるかどうかを示すフラグ。 * ユーザーがすべての必須スキルを持ち、スキルレベルが適用される場合は True。 * ユーザーがすべての必須スキルを持っているわけではない場合、またはレベル要件を満たしていない場合は False。 {#USA-analyzeUserById_S_S_B__ul_ql2_rhq_g3b} * num_skills:番号。必要なスキルと一致するスキル。 * num_skills_matching_level:番号。必要なスキルレベルに一致するユーザースキル。 * total_skill_level_gap:番号。スキルレベルギャップは、ランキングアルゴリズムが最小スキルレベル要件を満たす最適なユーザーを見つけるのに役立ちます。タスクのスキルレベルとユーザーのスキルレベルの全体的なギャップに基づいて計算されます。ユーザーは必須スキルに必要なスキルレベルを持っている必要があります。 * optional_skill_level_gap:番号。オプションのスキルのみにスキルレベルギャップを提供します。合計スキルレベルとオプションのスキルレベルギャップを区別するエンドポイントを支援します。 {#USA-analyzeUserById_S_S_B__ul_q1n_msd_f3b} 指定されたパラメーターが不正確であるか、JSON の形式が正しくない場合はエラー。 | [表 : 3. 返される内容] {#USA-analyzeUserById_S_S_B__table_kct_qrw_33b} 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) {#ariaid-title4} 必要なスキルに対してユーザースキルを分析し、インスタンスから収集できる一致するスキル、スキルレベルのギャップ、および資格の数を設定します。 {#USA-analyzeUserBySkills_S_S_B__table_crq_fzr_lhb__entry__3} | 名前 | タイプ | 説明 | |-|-|-| | requiredSkillsJson | 文字列 | ユーザーを認定するために必要なスキルのリスト。 各スキルは、次の形式の JSON エントリとしてリストされます。 * sys_id:文字列。スキル \[cmn_skill\] テーブルのスキルの Sys ID。 * is_mandatory:ブーリアン。スキルが必須かどうかを示すフラグ。 * level:文字列。スキルレベル \[cmn_skill_level\] テーブルの Sys ID。 {#USA-analyzeUserBySkills_S_S_B__ul_imx_vsw_33b} | | ユーザースキル JSON | 文字列 | 必要なスキルの資格を判断するためのユーザースキルのリスト。 各スキルは、次の形式の JSON エントリとしてリストされます。 * sys_id:文字列。スキル \[cmn_skill\] テーブルのスキルの Sys ID。 * is_mandatory:ブーリアン。スキルが必須かどうかを示すフラグ。 * level:文字列。スキルレベル \[cmn_skill_level\] テーブルの Sys ID。 {#USA-analyzeUserBySkills_S_S_B__ul_kj3_h1c_j3b} | | isSkillLevelEnforced | ブーリアン | ユーザーが必要なすべての必須スキルの最小スキルレベルを持っている必要がある場合は true、それ以外の場合は false。デフォルト値：false。 | [表 : 4. パラメーター] {#USA-analyzeUserBySkills_S_S_B__table_crq_fzr_lhb} {#USA-analyzeUserBySkills_S_S_B__table_vdx_prw_33b__entry__2} | タイプ | 説明 | |-|-| | 文字列 | 次のように、アナライザースキルマップに基づいてユーザーに関する必要なすべての情報を含む JSON。 * sys_id:文字列。ユーザー \[sys_user\] テーブルの Sys ID。 * is_qualified:ブーリアン。ユーザーが必要なスキルの資格があるかどうかを示すフラグ。 * ユーザーがすべての必須スキルを持ち、スキルレベルが適用される場合は True。 * ユーザーがすべての必須スキルを持っているわけではない場合、またはレベル要件を満たしていない場合は False。 {#USA-analyzeUserBySkills_S_S_B__ul_ql2_rhq_g3b} * num_skills:番号。必要なスキルと一致するスキル。 * num_skills_matching_level:番号。必要なスキルレベルに一致するユーザースキル。 * total_skill_level_gap:番号。スキルレベルギャップは、ランキングアルゴリズムが最小スキルレベル要件を満たす最適なユーザーを見つけるのに役立ちます。タスクのスキルレベルとユーザーのスキルレベルの全体的なギャップに基づいて計算されます。ユーザーは必須スキルに必要なスキルレベルを持っている必要があります。 * optional_skill_level_gap:番号。オプションのスキルのみにスキルレベルギャップを提供します。合計スキルレベルとオプションのスキルレベルギャップを区別するエンドポイントを支援します。 {#USA-analyzeUserBySkills_S_S_B__ul_q1n_msd_f3b} 指定されたパラメーターが不正確であるか、JSON の形式が正しくない場合はエラー。 | [表 : 5. 返される内容] {#USA-analyzeUserBySkills_S_S_B__table_vdx_prw_33b} 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);