OnCallContactPrefTemplate : Global

Die OnCallContactPrefTemplate -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 ein OnCallContactPrefTemplate- Objekt.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

In diesem Beispiel wird ein OnCallContactPrefTemplate -Objekt instanziiert.

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 in der Tabelle „Kontakteinstellung für Schicht“ [cmn_rota_contact_preference] Datensätze für Kontaktversuche erstellt.

Rufen Sie vor dem Aufrufen dieser Methode die Methode deleteContactPreferenceAttempts() auf, um vorhandene Datensätze für Kontaktversuche zu löschen. 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 „Vorlage für Kontakteinstellung für Rufbereitschaft“ [on_call_template_contact_preference].
escalationSetSysId	Zeichenfolge	Sys_id des Eskalationssatzes in der Tabelle „Schichteskalationssatz“ [cmn_rota_escalation_set].

Tabelle : 3. Rückgaben

Typ	Beschreibung
Objekt	Objekt, das Fehler- und Warnmeldungen enthält. Wenn der Vorgang erfolgreich war, ist dieses Objekt leer. Hinweis: Bei einem Fehler 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 Eskalationssatz Service Desk – Standard angewendet. Das Rückgabeobjekt ist leer, da keine Fehler oder Warnungen vorliegen.

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 Datensätze für Kontaktversuche für den Eskalationssatz werden aus der Tabelle „Kontakteinstellung für Schicht“ [cmn_rota_contact_preference] gelöscht.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
escalationSetSysId	Zeichenfolge	Sys_id des Eskalationssatzes in der Tabelle „Schichteskalationssatz“ [cmn_rota_escalation_set].

Tabelle : 5. Ausgabe

Typ	Beschreibung
Keine

In diesem Beispiel werden alle Kontakteinstellungen gelöscht, die dem Eskalationssatz Service Desk – Standard zugeordnet sind.

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

contactPrefTemp.deleteContactPreferenceAttempts(escSetSysId);