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


---

# SkillDeterminationUtils - スコープ指定

# SkillDeterminationUtils - スコープ指定 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

SkillDeterminationUtils スクリプトインクルードは、作業アイテムのスキルデータを取得または設定するためのユーティリティメソッドを提供します。

このスクリプトインクルードにはスキル決定 (com.snc.skill_determination) プラグインが必要であり、 `sn_skill_rule` 名前空間内で提供されます。

## SkillDeterminationUtils:SkillDeterminationUtils() {#ariaid-title2}

SkillDeterminationUtils のインスタンスを作成するコンストラクター。
{#SkillDeterminationUtilsConstructor__table_v2y_sh5_fhb__entry__3}

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

{#SkillDeterminationUtilsConstructor__table_v2y_sh5_fhb}  

    var util = new sn_skill_rule.SkillDeterminationUtils();

## SkillDeterminationUtils - assignSkillsToWorkItem(アレイスキル、GlideRecord now_GR) {#ariaid-title3}

アクティブなスキルオブジェクトのアレイを作業アイテムにアサインします。
{#assignSkillsToWorkItem_A_GR__table_cv2_w45_fhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| スキル | アレイ | アサインするアクティブなスキルオブジェクトのアレイ。 |
| skill.skillName | 文字列 | スキルの名前。 |
| skill.skillSysId | 文字列 | スキルの Sys ID。 |
| skill.mandatory | ブーリアン | スキルが必須の場合は true、それ以外の場合は false。 |
| skill.skillLevelName | 文字列 | オプションのスキルレベル名。 |
| skill.skillLevelSysId | 文字列 | オプションのスキルレベル Sys ID。 |
| now_GR | GlideRecord | スキルをアサインする作業アイテムの GlideRecord。 |
[表 : 2. パラメーター]

{#assignSkillsToWorkItem_A_GR__table_cv2_w45_fhb} {#assignSkillsToWorkItem_A_GR__table_dv2_w45_fhb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 3. 返される内容]

{#assignSkillsToWorkItem_A_GR__table_dv2_w45_fhb}  
以下の例では、テーブル名 (インタラクション) を使用してインタラクションレコードを作成し、インタラクション作業アイテムにスキルを割り当てて、インタラクションスキル \[interaction_m2m_skill\] テーブルにレコードを作成する方法を示します。

ユースケース 1:determineWorkItemSkills() から返された結果を使用して、インタラクションテーブルから作業アイテムにスキルをアサインします。

    // Create an interaction record
    var now_GR = new GlideRecord('interaction');
    now_GR.insert();

    var util = new sn_skill_rule.SkillDeterminationUtils();

    // Get interaction skills interaction 
    // and specify if any are mandatory
    var result = util.determineWorkItemSkills(now_GR);

    // Assign skills determined by result and 
    // assign them to the interaction work item
    util.assignSkillsToWorkItem(result, now_GR);

ユースケース 2:スキルアレイを手動で挿入する。この場合、インタラクション作業アイテムに IT スキルをアサインします。

    var now_GR = new GlideRecord('interaction');
    now_GR.insert();

    var util = new sn_skill_rule.SkillDeterminationUtils();

    var skills = [{"skillSysId":"2eb1c2029f100200a3bc1471367fcfe4", "skillName":"IT", "mandatory":true, "skillLevelName":"", "skillLevelSysId":null}];

    util.assignSkillsToWorkItem(skills, now_GR);

## SkillDeterminationUtils - determineWorkItemSkills(GlideRecord now_GR) {#ariaid-title4}

指定された作業アイテムのスキルを取得し、スキルが必須かどうかを示し、スキルレベルを一覧表示します。
{#determineWorkItemSkills_GR__table_hct_yl5_fhb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| now_GR | GlideRecord | 任意のインタラクションまたはタスクテーブル拡張からの作業アイテムの GlideRecord。 |
[表 : 4. パラメーター]

{#determineWorkItemSkills_GR__table_hct_yl5_fhb} {#determineWorkItemSkills_GR__table_ict_yl5_fhb__entry__2}

| タイプ | 説明 |
|-|-|
| アレイ | 1 つ以上のスキルオブジェクト。 * skillSysId:文字列。スキル \[cmn_skill\] テーブルのスキルの Sys ID。 * skillName:文字列。スキルの名前。 * 必須:ブーリアン。必須の場合は true、それ以外の場合は false。 * skillLevelName:スキルが存在する場合、スキルレベルの名前。 * skillLevelSysId:スキルが存在する場合、スキルレベル \[cmn_skill_level\] テーブルのスキルレベルの Sys ID。 {#determineWorkItemSkills_GR__ul_bwb_5nb_j3b} |
[表 : 5. 返される内容]

{#determineWorkItemSkills_GR__table_ict_yl5_fhb}  
次のスクリプトは、インタラクションレコードを作成し、インタラクション作業アイテムのスキルを取得して、スキルが必須かどうかを示します。

    // Create an interaction record
    var now_GR = new GlideRecord('interaction');
    now_GR.insert();

    var util = new sn_skill_rule.SkillDeterminationUtils();

    var result = util.determineWorkItemSkills(now_GR);
    gs.info(JSON.stringify(result));

出力：

    [{"skillSysId":"6c0f025c7f672300a8b1bdc8adfa917f",
    "skillName":"Premier Support Certified",
    "mandatory":false,"skillLevelName":"",
    "skillLevelSysId":null}]