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


---

# OnCallContactPrefTemplate -- Global

# OnCallContactPrefTemplate -- Global {#ariaid-title1}

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

Die OnCallContactPrefTemplate Die Skripteinbindung bietet Methoden zum Anwenden von Kontakteinstellungsvorlagen 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).

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

Instanziiert einen OnCallContactPrefTemplate Objekt.
{#OnCallCtPrefTemp-OnCallCtPrefTemp__table_b1n_q5c_kxb__entry__3}

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

{#OnCallCtPrefTemp-OnCallCtPrefTemp__table_b1n_q5c_kxb}  
In diesem Beispiel wird ein instanziiert OnCallContactPrefTemplate Objekt.

    var contactPrefTemp = new global.OnCallContactPrefTemplate();

## OnCallContactPrefTemplate -- copyContactPreferences(Zeichenfolge templateSysId, Zeichenfolge eskalationSetSysId) {#ariaid-title3}

Wendet eine Kontakteinstellungsvorlage auf einen Eskalationssatz an.
Wenn die Vorlage auf den Eskalationssatz angewendet wird, werden Kontaktversuchsdatensätze in der Tabelle „Schichtkontakteinstellung" \[cmn_rota_contact_preference\] erstellt.

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

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

{#OnCallCtPrefTemp-copyCtPrefs_S_S__table_cgl_2rd_3xb} {#OnCallCtPrefTemp-copyCtPrefs_S_S__table_dgl_2rd_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": "String" } |
| \<Object\>.Fehler | Fehlermeldung. Mögliche Werte: * Die sys_ID der Kontakteinstellungsvorlage ist nicht korrekt * Sys_ID des Eskalationssatzes ist nicht korrekt * Kontaktversuche sind bereits vorhanden {#OnCallCtPrefTemp-copyCtPrefs_S_S__ul_dmh_3tc_kxb} Datentyp: Zeichenfolge |
| \<Object\>.Warnung | Warnmeldung. Datentyp: Zeichenfolge |
[Tabelle : 3. Rückgaben]

{#OnCallCtPrefTemp-copyCtPrefs_S_S__table_dgl_2rd_3xb}  
Dieses Beispiel wendet eine Kontakteinstellungsvorlage auf den Service Desk an -- Standard-Eskalationssatz. Das Rückgabeobjekt ist leer, da keine Fehler oder Warnungen vorhanden sind.

    var escSetSysId = "a47ac1abeb5a6110249e8d835d5228aa";
    var templateSysId = "f8dac9ebeb5a6110249e8d835d522873";

    var contactPrefTemp = new global.OnCallContactPrefTemplate();

    // delete existing contact attempt records before applying the template
    contactPrefTemp.deleteContactPreferenceAttempts(escSetSysId); 

    var result = contactPrefTemp.copyContactPreferences(templateSysId, escSetSysId);
    gs.info(JSON.stringify(result));

Ausgabe:

    {}

## OnCallContactPrefTemplate -- deleteContactPreferenceAttempts(Zeichenfolge eskalationSetSysId) {#ariaid-title4}

Löscht alle Kontakteinstellungen, die einem Eskalationssatz zugeordnet sind.
Alle Kontaktversuchsdatensätze für den Eskalationssatz werden aus der Tabelle „Schichtkontakteinstellungen" \[cmn_rota_contact_preference\] gelöscht.
{#OnCallCtPrefTemp-deleteCtPrefAtt_S__table_zlg_zqd_3xb__entry__3}

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

{#OnCallCtPrefTemp-deleteCtPrefAtt_S__table_zlg_zqd_3xb} {#OnCallCtPrefTemp-deleteCtPrefAtt_S__table_amg_zqd_3xb__entry__2}

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

{#OnCallCtPrefTemp-deleteCtPrefAtt_S__table_amg_zqd_3xb}  
Dieses Beispiel löscht alle Kontakteinstellungen, die dem Service Desk -- Standard-Eskalationssatz zugeordnet sind.

    var escSetSysId = "a47ac1abeb5a6110249e8d835d5228aa";
    var contactPrefTemp = new global.OnCallContactPrefTemplate();

    contactPrefTemp.deleteContactPreferenceAttempts(escSetSysId);


