---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# OnCallEscalationTemplateSNC - グローバル

# OnCallEscalationTemplateSNC - グローバル {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分

OnCallEscalationTemplateSNC スクリプトインクルードは、エスカレーションポリシーテンプレートをエスカレーションセットに適用するメソッドを提供します。

エスカレーションプロセスの詳細については、「 [Defining On-Call Scheduling escalation process](https://www.servicenow.com/docs/access?context=defining-escalation-process-and-template&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US)」を参照してください。

このスクリプトインクルードには、オンコールスケジューリングプラグイン (com.snc.on_call_rotation) が必要です。

## OnCallEscalationTemplateSNC - OnCallEscalationTemplateSNC() {#ariaid-title2}

OnCallEscalationTemplateSNC オブジェクトをインスタンス化します。
{#OnCallEscTemp-OnCallEscTemp__table_y2b_lld_rxb__entry__3}

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

{#OnCallEscTemp-OnCallEscTemp__table_y2b_lld_rxb}  
この例では、 OnCallEscalationTemplateSNC オブジェクトをインスタンス化します。

    var escTemp = new global.OnCallEscalationTemplateSNC();

## OnCallEscalationTemplateSNC - copyEscalationTemplatetoEscalationSet(文字列 templateSysId, 文字列 escalationSetSysId) {#ariaid-title3}

エスカレーションポリシーテンプレートをエスカレーションセットに適用します。
テンプレートがエスカレーションセットに適用されると、シフトエスカレーションステップ定義 \[cmn_rota_esc_step_def\] テーブルにエスカレーションステップ定義レコードが作成されます。

このメソッドを呼び出す前に、 deleteEscalationSetSteps() メソッドを呼び出して既存のエスカレーションステップ定義を削除します。既存のレコードが最初に削除されていない場合、このメソッドはエラーを返します。
{#OnCallEscTemp-copyEsTempEsSet_S_S__table_wh5_3td_3xb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| templateSysId | 文字列 | オンコールエスカレーションポリシーテンプレート \[on_call_template_escalation_policy\] テーブルのエスカレーションポリシーテンプレートのSys_id。 |
| エスカレーションセット SysID | 文字列 | シフトエスカレーションセット \[cmn_rota_escalation_set\] テーブル内のエスカレーションセットのSys_id。 |
[表 : 2. パラメーター]

{#OnCallEscTemp-copyEsTempEsSet_S_S__table_wh5_3td_3xb} {#OnCallEscTemp-copyEsTempEsSet_S_S__table_xh5_3td_3xb__entry__2}

| タイプ | 説明 |
|-|-|
| オブジェクト | エラーメッセージと警告メッセージを含むオブジェクト。操作が成功した場合、このオブジェクトは空です。 注: エラーが発生すると、操作は停止し、テンプレートは適用されません。警告が発生した場合、操作は続行され、一部のレコードは引き続き作成されます。 { "error": "String", "warning": {Object} } |
| \<Object\>。エラー | エラーメッセージ 考えられるエラー: * エスカレーションポリシーテンプレートsys_idが正しくありません。 * エスカレーションセットsys_idが正しくありません。 * エスカレーションステップ定義は、エスカレーションセットに既に存在します。 {#OnCallEscTemp-copyEsTempEsSet_S_S__ul_dmh_3tc_kxb} データタイプ：文字列 |
| \<Object\>。警告 | 警告に関する情報。 データタイプ: オブジェクト { "message": "String", "skipped_steps": [Array], "not_matching_steps": {Object}, } |
| \<Object\>.warning.message | 警告メッセージ。 考えられる警告: * 勤務表の位置がシフトの勤務表と一致しません * エスカレーションステップテンプレートで対象者が定義されていません {#OnCallEscTemp-copyEsTempEsSet_S_S__ul_zwt_zhr_rxb} データタイプ：文字列 |
| \<Object\>.warning.skipped_steps | スキップされたエスカレーションステップのインデックス (1 から始まる)。 データタイプ：アレイ |
| \<Object\>.warning.not_matching_steps | 利用可能な勤務表がないエスカレーションステップに関する情報を含むオブジェクト。{ `"step number":[roster number]}` の形式。 たとえば、戻り値が `{"3":[3]}` の場合、エスカレーションステップ 3 では、第 3 の勤務表は使用できません。 データタイプ: オブジェクト |
[表 : 3. 返される内容]

{#OnCallEscTemp-copyEsTempEsSet_S_S__table_xh5_3td_3xb}  
この例では、「勤務表ローテーション」エスカレーションポリシーテンプレートを「サービスデスク - デフォルトのエスカレーションセット」に適用します。エラーや警告がないため、戻りオブジェクトは空です。

    var escSetSysId = "32820dc3eb422110249e8d835d5228c3";
    var templateSysId = "a89e2982eb592110249e8d835d522825";
    var escTemp = new global.OnCallEscalationTemplateSNC();

    // delete existing escalation step definitions before applying the template
    escTemp.deleteEscalationSetSteps(escSetSysId);

    var result = escTemp.copyEscalationTemplatetoEscalationSet(templateSysId, escSetSysId);
    gs.info(JSON.stringify(result));

出力:

    {}

この例では、「勤務表によるローテーション」エスカレーションポリシーテンプレートを「勤務時間 - デフォルトの」エスカレーションセットに適用します。この場合、アプリケーション開発シフトには勤務表が 2 つしかありませんが、テンプレートは 3 番目の勤務表を割り当てようとします。勤務表の数が一致しないため、警告がスローされます。シフトエスカレーションステップ定義 \[cmn_rota_esc_step_def\] テーブルにはまだ 2 つのレコードが作成されています。

    var escSetSysId = "e4f8f73deb562110249e8d835d522852";
    var templateSysId = "a89e2982eb592110249e8d835d522825";
    var escTemp = new global.OnCallEscalationTemplateSNC();

    // delete existing escalation step definitions before applying the template
    escTemp.deleteEscalationSetSteps(escSetSysId);

    var result = escTemp.copyEscalationTemplatetoEscalationSet(templateSysId, escSetSysId);
    gs.info(JSON.stringify(result));

出力:

    {
       "warning": {
          "message": "Skipped copying templates for some of the steps since no audiences are defined",
          "not_matching_steps": {
             "3": [
                3
             ]
          },
          "skipped_steps": [
             "3"
          ]
       }
    }

## OnCallEscalationTemplateSNC - deleteEscalationSetSteps(文字列 escalationSetSysId) {#ariaid-title4}

エスカレーションセットに関連付けられたすべてのエスカレーションステップ定義レコードを削除します。
{#OnCallEscTemp-deleteEsSetSteps_S__table_rvx_35d_3xb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| エスカレーションセット SysID | 文字列 | シフトエスカレーションセット \[cmn_rota_escalation_set\] テーブル内のエスカレーションセットのSys_id。 |
[表 : 4. パラメーター]

{#OnCallEscTemp-deleteEsSetSteps_S__table_rvx_35d_3xb} {#OnCallEscTemp-deleteEsSetSteps_S__table_svx_35d_3xb__entry__2}

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

{#OnCallEscTemp-deleteEsSetSteps_S__table_svx_35d_3xb}  
この例では、「サービスデスク - デフォルト」エスカレーションセットに関連付けられたすべてのエスカレーションステップ定義を削除します。

    var escSetSysId = "32820dc3eb422110249e8d835d5228c3";

    var escTemp = new global.OnCallEscalationTemplateSNC();

    escTemp.deleteEscalationSetSteps(escSetSysId);