OnCallContactPrefTemplate – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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.

    Diese Skripteinbindung erfordert das Plugin „Bereitschaftsplanung“ (com.snc.on_call_Rotation).

    OnCallContactPrefTemplate: OnCallContactPrefTemplate()

    Instanziiert einen OnCallContactPrefTemplate Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

    In diesem Beispiel wird ein instanziiert OnCallContactPrefTemplate Objekt.

    var contactPrefTemp = new global.OnCallContactPrefTemplate();

    OnCallContactPrefTemplate – copyContactPreferences(Zeichenfolge templateSysId, Zeichenfolge eskalationSetSysId)

    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_preferences] 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.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    templateSysId Zeichenfolge SYS_ID der Kontakteinstellungsvorlage in der Tabelle „Kontakteinstellungsvorlage für Rufbereitschaft“ [on_call_template_contact_preferences].
    EskalationSetSysId Zeichenfolge SYS_ID des Eskalationssatzes in der Tabelle „Schichteskalationssatz“ [cmn_Rota_Eskalation_Set].
    Tabelle : 3. Rückgaben
    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 beendet, 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

    Datentyp: Zeichenfolge

    <Object>.Warnung Warnmeldung.

    Datentyp: Zeichenfolge

    In diesem Beispiel wird eine Kontakteinstellungsvorlage auf den Service Desk – Standard-Eskalationssatz angewendet. 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)

    Löscht alle Kontakteinstellungen, die einem Eskalationssatz zugeordnet sind.

    Alle Kontaktversuchsdatensätze für den Eskalationssatz werden aus der Tabelle „Schichtkontakteinstellungen“ [cmn_Rota_contact_preferences] gelöscht.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    EskalationSetSysId Zeichenfolge SYS_ID des Eskalationssatzes in der Tabelle „Schichteskalationssatz“ [cmn_Rota_Eskalation_Set].
    Tabelle : 5. Ausgabe
    Typ Beschreibung
    Keine

    In diesem Beispiel werden alle Kontakteinstellungen gelöscht, die dem Satz „Service Desk – Standard-Eskalation“ zugeordnet sind.

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