---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://www.servicenow.com/docs/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SkillDeterminationUtils - スコープ指定

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

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](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(アレイ skills, GlideRecord now_GR) {#ariaid-title3}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| skills | アレイ | アサインされるアクティブなスキルオブジェクトのアレイ。 |
| 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) を使用してインタラクションレコードを作成し、インタラクション作業アイテムにスキルを割り当て、インタラクションスキル \[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：文字列。スキルの名前。 * mandatory：ブーリアン。必須の場合は 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}]