---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# OnCallEscalationTemplateSNC -- Global

# OnCallEscalationTemplateSNC -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die OnCallEscalationTemplateSNC Die Skripteinbindung bietet Methoden zum Anwenden von Eskalationsrichtlinienvorlagen auf Eskalationssätze.

Weitere Informationen zum Eskalationsprozess finden Sie unter [Defining On-Call Scheduling escalation process](https://www.servicenow.com/docs/access?context=defining-escalation-process-and-template&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US).

Diese Skripteinbindung erfordert das Plugin „Rufbereitschaftsplanung" (com.snc.on_call_Rotation).

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

Instanziiert einen OnCallEscalationTemplateSNC Objekt.
{#OnCallEscTemp-OnCallEscTemp__table_y2b_lld_rxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#OnCallEscTemp-OnCallEscTemp__table_y2b_lld_rxb}  
In diesem Beispiel wird ein instanziiert OnCallEscalationTemplateSNC Objekt.

    var escTemp = new global.OnCallEscalationTemplateSNC();

## OnCallEscalationTemplateSNC -- copyEscalationTemplatetoEscalationSet(Zeichenfolge templateSysId, Zeichenfolge eskalationSetSysId) {#ariaid-title3}

Wendet eine Eskalationsrichtlinienvorlage auf einen Eskalationssatz an.
Wenn die Vorlage auf den Eskalationssatz angewendet wird, werden in der Tabelle „Schichteskalationsschritt-Definition" \[cmn_rota_esc_step_def\] Datensätze zur Eskalationsschritt-Definition erstellt.

Rufen Sie vor dem Aufrufen dieser Methode auf DeleteEscalationSetSteps() Methode zum Löschen vorhandener Eskalationsschrittdefinitionen. Wenn vorhandene Datensätze nicht zuerst gelöscht werden, gibt diese Methode einen Fehler zurück.
{#OnCallEscTemp-copyEsTempEsSet_S_S__table_wh5_3td_3xb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| templateSysId | Zeichenfolge | SYS_ID der Eskalationsrichtlinienvorlage in der Tabelle „Richtlinienvorlage für Rufbereitschaftseskalation" \[on_call_template_escalation_policy\]. |
| EskalationSetSysId | Zeichenfolge | SYS_ID des Eskalationssatzes in der Tabelle „Schichteskalationssatz \[cmn_rota_escalation_set\]". |
[Tabelle : 2. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Objekt | Objekt mit Fehler- und Warnmeldungen. Wenn der Vorgang erfolgreich war, ist dieses Objekt leer. Hinweis: Wenn ein Fehler auftritt, wird der Vorgang angehalten, und die Vorlage wird nicht angewendet. Wenn eine Warnung auftritt, wird der Vorgang fortgesetzt, und einige Datensätze werden noch erstellt. { "error": "String", "warning": {Object} } |
| \<Object\>.Fehler | Fehlermeldung. Mögliche Fehler: * Sys_ID der Eskalationsrichtlinienvorlage ist nicht korrekt. * Sys_ID des Eskalationssatzes ist nicht korrekt. * Eskalationsschrittdefinitionen sind bereits im Eskalationssatz vorhanden. {#OnCallEscTemp-copyEsTempEsSet_S_S__ul_dmh_3tc_kxb} Datentyp: Zeichenfolge |
| \<Object\>.Warnung | Informationen zu Warnungen. Datentyp: Objekt { "message": "String", "skipped_steps": [Array], "not_matching_steps": {Object}, } |
| \<Object\>.Warnung.Nachricht | Warnmeldung. Mögliche Warnungen: * Dienstplanposition stimmt nicht mit den Dienstplänen in der Schicht überein * In der Eskalationsschrittvorlage sind keine Zielgruppen definiert {#OnCallEscTemp-copyEsTempEsSet_S_S__ul_zwt_zhr_rxb} Datentyp: Zeichenfolge |
| \<Object\>.Warnung.Skipped_steps | Indizes aller Eskalationsschritte, die übersprungen wurden (1-basiert). Datentyp: Array |
| \<Object\>.warning.not_matching_steps | Objekt mit Informationen zu Eskalationsschritten, für die keine Dienstpläne im Format verfügbar sind `{"Schrittnummer":[Dienstplannummer]} `. Beispiel: Der Rückgabewert ist `{"3":[3]} `, Dann ist bei Eskalationsschritt 3 der tertiäre Dienstplan nicht verfügbar. Datentyp: Objekt |
[Tabelle : 3. Rückgaben]

{#OnCallEscTemp-copyEsTempEsSet_S_S__table_xh5_3td_3xb}  
Dieses Beispiel wendet die Richtlinienvorlage „durch Dienstpläne rotieren" auf den Service Desk an -- Standard-Eskalationssatz. Das Rückgabeobjekt ist leer, da keine Fehler oder Warnungen vorhanden sind.

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

Ausgabe:

    {}

Dieses Beispiel wendet die Richtlinienvorlage „durch Dienstplan rotieren" auf den Satz „Arbeitszeiten -- Standardeskalation" an. In diesem Fall hat die Anwendungsentwicklungsschicht nur zwei Dienstpläne, die Vorlage versucht jedoch, einen dritten Dienstplan zuzuweisen. Da die Anzahl der Dienstpläne nicht übereinstimmt, wird eine Warnung ausgelöst. In der Tabelle „Schichteskalationsschritt-Definition" \[cmn_rota_esc_step_def\] werden noch zwei Datensätze erstellt.

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

Ausgabe:

    {
       "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(Zeichenfolge eskalationSetSysId) {#ariaid-title4}

Löscht alle Eskalationsschritt-Definitionsdatensätze, die einem Eskalationssatz zugeordnet sind.
{#OnCallEscTemp-deleteEsSetSteps_S__table_rvx_35d_3xb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| EskalationSetSysId | Zeichenfolge | SYS_ID des Eskalationssatzes in der Tabelle „Schichteskalationssatz \[cmn_rota_escalation_set\]". |
[Tabelle : 4. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Rückgaben]

{#OnCallEscTemp-deleteEsSetSteps_S__table_svx_35d_3xb}  
In diesem Beispiel werden alle Eskalationsschrittdefinitionen gelöscht, die dem Service Desk -- Standard-Eskalationssatz zugeordnet sind.

    var escSetSysId = "32820dc3eb422110249e8d835d5228c3";

    var escTemp = new global.OnCallEscalationTemplateSNC();

    escTemp.deleteEscalationSetSteps(escSetSysId);


