OnCallRotation

OnCallRotation – getCatchAll(String rotaID)

Ruft die sys_id der „catch all“- Person ab. Verwenden Sie dies zusammen mit der Methode getCatchAllType(), um die Quelle der zurückgegebenen ID zu ermitteln. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 1. Parameter
Name	Typ	Beschreibung
rotaID	Zeichenfolge	Die sys_id des Rotationsplans.

Tabelle : 2. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Die sys_id eines sys_user, eines cmn_rota_roster oder NULL.


var rotaSysId = '349f399173062300e7af6238edf6a75e';
var onCallRotation = new OnCallRotation();
var catchAll = onCallRotation.getCatchAll(rotaSysId);
gs.log(catchAll);

Ausgabe:

46d44a23a9fe19810012d100cca80666

OnCallRotation – getCatchAllType(String rotaID)

Ruft den Typ von „_catch all_“ ab, der sich am Ende der Eskalationskette befindet. Wenn die Eskalationskette beendet wird, ohne eine Person in Rufbereitschaft zuzuweisen, wird der Incident, sofern konfiguriert, „_catch all_“ zugewiesen. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 3. Parameter
Name	Typ	Beschreibung
rotaID	Zeichenfolge	Die sys_id des Rotationsplans.

Tabelle : 4. Ergebnisse
Typ	Beschreibung
Zeichenfolge	NULL: Ungültige Rotationsplan-ID oder „catch all“ ist nicht verfügbar. Group_manager: Der Manager der Gruppe, die mit dem Rotationsplan verknüpft ist, ist die „catch all“-Person. Individual: Ein konfigurierter Benutzer ist die „catch all“-Person. All: Alle Mitglieder des konfigurierten Dienstplans sind die „catch all“-Person.

var rotaSysId = '349f399173062300e7af6238edf6a75e';
var onCallRotation = new OnCallRotation();
var catchAllType = onCallRotation.getCatchAllType(rotaSysId);
gs.log(catchAllType);

Ausgabe:

group_manager

OnCallRotation – getEscalatees(String groupSysIds, String rotaSysIds, String rosterSysIds, GlideDateTime gdt, GlideRecord taskGr)

Ruft eine Liste der Eskalierten an, die für einen bestimmte Zeit auf Rufbereitschaft sind. Wird keine Uhrzeit angegeben, wird die aktuelle Uhrzeit verwendet. Wenn keine groupSysIds bereitgestellt werden, wird eine leere Liste zurückgegeben. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Hinweis:

Legen Sie den Parameter taskGR fest, um die Eskalationsplanauswertung zu aktivieren.

Tabelle : 5. Parameter
Name	Typ	Beschreibung
groupSysIds	Zeichenfolge	Kommagetrennte Liste von sys_ids der sys_user_group, nach der die Datensätze gefiltert werden sollen.
rotaSysIds	Zeichenfolge	Kommagetrennte Liste von cmn_rota-sys_ids, nach der die Datensätze gefiltert werden sollen.
rosterSysIds	Zeichenfolge	Kommagetrennte Liste von cmn_rota_roster-sys_ids, nach der die Datensätze gefiltert werden sollen.
gDT	GlideDateTime	Datum in der UTC-Zeitzone
taskGr	GlideRecord	Optional. Aktueller Aufgabendatensatz. Wenn taskGr leer ist, gibt diese Methode den Standardeskalationsplan zurück. Wenn taskGr übergeben wird, werden die Eskalationsrichtlinien der Reihe nach ausgewertet, und diese Methode gibt den entsprechenden Eskalationsplan zurück.

Tabelle : 6. Ergebnisse
Typ	Beschreibung
Objekt	Eskalieren Sie Informationen, wie zum Beispiel userIds, deviceIds und escalationGroups.


var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.getEscalatees(groupSysId, "", "", currentTime);
gs.log(JSON.stringify(result));

Ausgabe:

Für Einzelschicht:

[
  {
    "memberId": "119f399173062300e7af6238edf6a7e7",
    "memberIds": [],
    "userId": "62826bf03710200044e0bfc8bcbe5df1",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 1,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
  },
  {
    "memberId": "1d9f399173062300e7af6238edf6a7e8",
    "memberIds": [],
    "userId": "a8f98bb0eb32010045e1a5115206fe3a",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 2,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
  },
  {
    "memberId": "dd9f399173062300e7af6238edf6a7e9",
    "memberIds": [],
    "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 3,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
  }
]

Für überlappende Schicht:

[
  {
    "memberId": "119f399173062300e7af6238edf6a7e7",
    "memberIds": [],
    "userId": "62826bf03710200044e0bfc8bcbe5df1",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 1,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
  },
  {
    "memberId": "7daf799173062300e7af6238edf6a7a2",
    "memberIds": [],
    "userId": "d2826bf03710200044e0bfc8bcbe5dc9",
    "userIds": [],
    "roster": "b5af799173062300e7af6238edf6a7a2",
    "rota": "35af799173062300e7af6238edf6a79e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 1,
    "isOverride": false,
    "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
    "memberScheduleId": "06af799173062300e7af6238edf6a7cd"
  },
  {
    "memberId": "1d9f399173062300e7af6238edf6a7e8",
    "memberIds": [],
    "userId": "a8f98bb0eb32010045e1a5115206fe3a",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 2,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
  },
  {
    "memberId": "f5af799173062300e7af6238edf6a7c9",
    "memberIds": [],
    "userId": "ee826bf03710200044e0bfc8bcbe5def",
    "userIds": [],
    "roster": "b5af799173062300e7af6238edf6a7a2",
    "rota": "35af799173062300e7af6238edf6a79e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 2,
    "isOverride": false,
    "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
    "memberScheduleId": "8aaf799173062300e7af6238edf6a7cf"
  },
  {
    "memberId": "dd9f399173062300e7af6238edf6a7e9",
    "memberIds": [],
    "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 3,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
  },
  {
    "memberId": "8aaf799173062300e7af6238edf6a7ca",
    "memberIds": [],
    "userId": "e2826bf03710200044e0bfc8bcbe5de0",
    "userIds": [],
    "roster": "b5af799173062300e7af6238edf6a7a2",
    "rota": "35af799173062300e7af6238edf6a79e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 3,
    "isOverride": false,
    "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
    "memberScheduleId": "02af799173062300e7af6238edf6a7d2"
  }
]

Für benutzerdefinierte Eskalation

[
  {
    "memberId": "",
    "memberIds": [],
    "userId": "",
    "userIds": [
      "62826bf03710200044e0bfc8bcbe5df1",
      "46d44a23a9fe19810012d100cca80666"
    ],
    "roster": "",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [
      "a715cd759f2002002920bde8132e7018"
    ],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 1,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": ""
  },
  {
    "memberId": "",
    "memberIds": [
      "119f399173062300e7af6238edf6a7e7"
    ],
    "userId": "",
    "userIds": [
      "62826bf03710200044e0bfc8bcbe5df1"
    ],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 2,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": ""
  }
]

/**
 * create a custom escalation for service desk shift with condition as P1 for Incident
 * taskGr is optional parameter
 * if taskGr is empty then it returns list of escalatees in default escalation plan
 * if taskGr is passed then escalation policies are executed evaluated in order and list of escalatees in corresponding escalation plan is returned
**/
var serviceDeskSysId = 'd625dccec0a8016700a222a0f7900d06';
var taskGr = new GlideRecord('incident');
taskGr.get('ed92e8d173d023002728660c4cf6a7bc');

var ocRotation = new OnCallRotation();
var escalatees = ocRotation.getEscalatees(serviceDeskSysId, null, null, null, null, taskGr);
gs.log(JSON.stringify(escalatees));

OnCallRotation – getEscalateeAt(String groupID, GlideDateTime dateTime, Number position)

Ruft ein Element für die Eskalation ab, entweder einen Benutzer [sys_user], eine Gruppe oder ein Benachrichtigungsgerät [cmn_notif_device], für die Schicht einer Gruppe zum angegebenen Datum und zur gegebenen Uhrzeit und an einer bestimmten Position in der Eskalationsreihenfolge. Diese API gilt für eine einzelne Schicht.

Die Methode gibt NULL zurück, wenn eine ungültige Position oder Gruppe als Argument übergeben wird.

Sie können die Methode getTableName() verwenden, um zu überprüfen, ob der zurückgegebene GlideRecord aus der Tabelle „sys_user“ oder „cmn_notif_device“ stammt.

Tabelle : 7. Parameter
Name	Typ	Beschreibung
groupID	Zeichenfolge	Die sys_id für die Gruppe, aus der das zu eskalierende Element abgerufen werden soll.
dateTime	GlideDateTime	Das Datum und die Uhrzeit, zu der die Eskalationsreihenfolge beginnen soll.
position	Zahl	Die Position in der Reihenfolge, um das zu eskalierende Element zu bestimmen (auf 1 basiert, d. h. die Zählung beginnt mit 1).

Tabelle : 8. Ergebnisse
Typ	Beschreibung
GlideRecord	Das Element, an das eskaliert werden soll, d. h. Eskalierte (entweder ein Benutzer-, Gruppen- oder Gerätedatensatz, abhängig von den Benachrichtigungsregeln) zu einem bestimmten Zeitpunkt und an einer bestimmten Position. Gibt NULL zurück, wenn nichts gefunden wird.


var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var escalatee = onCallRotation.getEscalateeAt(groupSysId, currentTime, 1);
gs.log(escalatee.name);

Ausgabe:

Abel Tuter

OnCallRotation – getEscalationPlan(String groupSysId, GlideDateTime gdt, String rotaSysIds, GlideRecord taskGr)

Ruft für die Schicht einer Gruppe zum angegebenen Datum und zur angegebenen Uhrzeit eine Liste mit Objekten, zu denen die Eskalation erfolgen soll, Eskalationspläne, die entweder aus einem Benutzer [sys_user] oder einem Benachrichtigungsgerät [cmn_notif_device] bestehen, ab. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Das Eskalationsobjekt enthält die folgenden Felder:

Number order: Die Eskalationsreihenfolge innerhalb der Aufstellung
String userId: sys_id des sys_user-Datensatzes oder NULL
String deviceId: sys_id des cmn_notif_device-Datensatzes oder NULL
Boolean isDevice: „true“ oder „false“, je nachdem, ob es sich bei dem zu eskalierenden Element um ein Gerät oder einen Benutzer handelt
GlideDuration timeBetweenReminders: die Zeit zwischen gesendeten Erinnerungen
Number reminderNum: Anzahl der Erinnerungen, die für jedes Element gesendet werden sollen, zu dem die Eskalation erfolgen soll

Hinweis:

Legen Sie den Parameter taskGR fest, um die Eskalationsplanauswertung zu aktivieren.

Tabelle : 9. Parameter
Name	Typ	Beschreibung
groupID	Zeichenfolge	sys_id für die Gruppe, für die Sie den Eskalationsplan benötigen.
gDT	GlideDateTime	Das Datum und die Uhrzeit, zu der die Eskalationsreihenfolge beginnen soll. Standard ist jetzt. jjjj-mm-tt HH:mm:ss ist das Format in der UTC-Zeitzone.
rotaSysIds	Zeichenfolge	Kommagetrennte Liste von cmn_rota-sys_ids, nach der die Datensätze gefiltert werden sollen.
taskGr	GlideRecord	Optional. Aktueller Aufgabendatensatz. Wenn taskGr leer ist, gibt diese Methode den Standardeskalationsplan zurück. Wenn taskGr übergeben wird, werden die Eskalationsrichtlinien der Reihe nach ausgewertet, und diese Methode gibt den entsprechenden Eskalationsplan zurück.

Tabelle : 10. Ergebnisse
Typ	Beschreibung
Objekt	Eine Liste von Eskalationsobjekten, zu denen eskaliert werden soll.

var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.getEscalationPlan(groupSysId, currentTime);
gs.log(JSON.stringify(result));

Ausgabe:

Für Einzelschicht:

[
  {
    "order": 1,
    "userId": "62826bf03710200044e0bfc8bcbe5df1",
    "userIds": [],
    "deviceId": "",
    "deviceIds": [],
    "escalationGroups": [],
    "isDevice": false,
    "timeToNextStep": null,
    "cmnRotaEscStepDefId": null,
    "reminderNum": 1,
    "rosterId": "9d9f399173062300e7af6238edf6a7e5",
    "memberId": "119f399173062300e7af6238edf6a7e7",
    "memberIds": [],
    "isOverride": false,
    "additionalEscalatees": [],
    "forcedCommunicationChannel": "",
    "rotaId": "349f399173062300e7af6238edf6a75e",
    "groupId": "096fb59173062300e7af6238edf6a783",
    "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
  },
  {
    "order": 2,
    "userId": "a8f98bb0eb32010045e1a5115206fe3a",
    "userIds": [],
    "deviceId": "",
    "deviceIds": [],
    "escalationGroups": [],
    "isDevice": false,
    "timeToNextStep": null,
    "cmnRotaEscStepDefId": null,
    "reminderNum": 1,
    "rosterId": "9d9f399173062300e7af6238edf6a7e5",
    "memberId": "1d9f399173062300e7af6238edf6a7e8",
    "memberIds": [],
    "isOverride": false,
    "additionalEscalatees": [],
    "forcedCommunicationChannel": "",
    "rotaId": "349f399173062300e7af6238edf6a75e",
    "groupId": "096fb59173062300e7af6238edf6a783",
    "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
  },
  {
    "order": 3,
    "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
    "userIds": [],
    "deviceId": "",
    "deviceIds": [],
    "escalationGroups": [],
    "isDevice": false,
    "timeToNextStep": null,
    "cmnRotaEscStepDefId": null,
    "reminderNum": 1,
    "rosterId": "9d9f399173062300e7af6238edf6a7e5",
    "memberId": "dd9f399173062300e7af6238edf6a7e9",
    "memberIds": [],
    "isOverride": false,
    "additionalEscalatees": [],
    "forcedCommunicationChannel": "",
    "rotaId": "349f399173062300e7af6238edf6a75e",
    "groupId": "096fb59173062300e7af6238edf6a783",
    "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
  }
]

Für überlappende Schicht:

[
  {
    "order": 1,
    "userId": "62826bf03710200044e0bfc8bcbe5df1",
    "userIds": [],
    "deviceId": "",
    "deviceIds": [],
    "escalationGroups": [],
    "isDevice": false,
    "timeToNextStep": null,
    "cmnRotaEscStepDefId": null,
    "reminderNum": 1,
    "rosterId": "9d9f399173062300e7af6238edf6a7e5",
    "memberId": "119f399173062300e7af6238edf6a7e7",
    "memberIds": [],
    "isOverride": false,
    "additionalEscalatees": [
      {
        "order": 1,
        "userId": "d2826bf03710200044e0bfc8bcbe5dc9",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "b5af799173062300e7af6238edf6a7a2",
        "memberId": "7daf799173062300e7af6238edf6a7a2",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [],
        "forcedCommunicationChannel": "",
        "rotaId": "35af799173062300e7af6238edf6a79e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "06af799173062300e7af6238edf6a7cd"
      }
    ],
    "forcedCommunicationChannel": "",
    "rotaId": "349f399173062300e7af6238edf6a75e",
    "groupId": "096fb59173062300e7af6238edf6a783",
    "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
  },
  {
    "order": 2,
    "userId": "a8f98bb0eb32010045e1a5115206fe3a",
    "userIds": [],
    "deviceId": "",
    "deviceIds": [],
    "escalationGroups": [],
    "isDevice": false,
    "timeToNextStep": null,
    "cmnRotaEscStepDefId": null,
    "reminderNum": 1,
    "rosterId": "9d9f399173062300e7af6238edf6a7e5",
    "memberId": "1d9f399173062300e7af6238edf6a7e8",
    "memberIds": [],
    "isOverride": false,
    "additionalEscalatees": [
      {
        "order": 2,
        "userId": "ee826bf03710200044e0bfc8bcbe5def",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "b5af799173062300e7af6238edf6a7a2",
        "memberId": "f5af799173062300e7af6238edf6a7c9",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [],
        "forcedCommunicationChannel": "",
        "rotaId": "35af799173062300e7af6238edf6a79e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "8aaf799173062300e7af6238edf6a7cf"
      }
    ],
    "forcedCommunicationChannel": "",
    "rotaId": "349f399173062300e7af6238edf6a75e",
    "groupId": "096fb59173062300e7af6238edf6a783",
    "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
  },
  {
    "order": 3,
    "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
    "userIds": [],
    "deviceId": "",
    "deviceIds": [],
    "escalationGroups": [],
    "isDevice": false,
    "timeToNextStep": null,
    "cmnRotaEscStepDefId": null,
    "reminderNum": 1,
    "rosterId": "9d9f399173062300e7af6238edf6a7e5",
    "memberId": "dd9f399173062300e7af6238edf6a7e9",
    "memberIds": [],
    "isOverride": false,
    "additionalEscalatees": [
      {
        "order": 3,
        "userId": "e2826bf03710200044e0bfc8bcbe5de0",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "b5af799173062300e7af6238edf6a7a2",
        "memberId": "8aaf799173062300e7af6238edf6a7ca",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [],
        "forcedCommunicationChannel": "",
        "rotaId": "35af799173062300e7af6238edf6a79e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "02af799173062300e7af6238edf6a7d2"
      }
    ],
    "forcedCommunicationChannel": "",
    "rotaId": "349f399173062300e7af6238edf6a75e",
    "groupId": "096fb59173062300e7af6238edf6a783",
    "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
  }
]

Für benutzerdefinierte Eskalation:

[
  {
    "order": 1,
    "userId": "",
    "userIds": [
      "62826bf03710200044e0bfc8bcbe5df1",
      "46d44a23a9fe19810012d100cca80666"
    ],
    "deviceId": "",
    "deviceIds": [],
    "escalationGroups": [
      "a715cd759f2002002920bde8132e7018"
    ],
    "isDevice": false,
    "timeBetweenReminders": {},
    "timeToNextStep": {},
    "cmnRotaEscStepDefId": "655042d173062300e7af6238edf6a738",
    "reminderNum": 1,
    "rosterId": "",
    "memberId": "",
    "memberIds": [],
    "isOverride": false,
    "additionalEscalatees": [],
    "forcedCommunicationChannel": "",
    "rotaId": "349f399173062300e7af6238edf6a75e",
    "groupId": "096fb59173062300e7af6238edf6a783",
    "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": ""
  },
  {
    "order": 2,
    "userId": "",
    "userIds": [],
    "deviceId": "",
    "deviceIds": [],
    "escalationGroups": [],
    "isDevice": false,
    "timeBetweenReminders": {},
    "timeToNextStep": {},
    "cmnRotaEscStepDefId": "8b6042d173062300e7af6238edf6a7f3",
    "reminderNum": 1,
    "rosterId": "",
    "memberId": "",
    "memberIds": [],
    "isOverride": false,
    "additionalEscalatees": [],
    "forcedCommunicationChannel": "",
    "rotaId": "349f399173062300e7af6238edf6a75e",
    "groupId": "096fb59173062300e7af6238edf6a783",
    "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": ""
  }
]

/**
* create a custom escalation for service desk shift with condition as P1 for Incident
* taskGr is optional parameter
* if taskGr is empty then it returns default escalation plan
* if taskGr is passed then escalation policies are executed evaluated in order and corresponding escalation plan is returned
**/

var serviceDeskSysId = 'd625dccec0a8016700a222a0f7900d06';
var taskGr = new GlideRecord('incident');
taskGr.get('ed92e8d173d023002728660c4cf6a7bc');

var ocRotation = new OnCallRotation();
var escalationPlan = ocRotation.getEscalationPlan(serviceDeskSysId, null, null, taskGr);
gs.log(JSON.stringify(escalationPlan));

OnCallRotation – getEscalationType(String rotaID)

Ruft die Art der Eskalation basierend auf einer einfachen Berechnung ab. Wenn sich ein aktiver Dienstplan im Rotationsplan befindet, wird durch die Mitglieder rotiert. Wenn sich mehr als ein aktiver Dienstplan im Rotationsplan befindet, wird durch die Dienstpläne rotiert. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 11. Parameter
Name	Typ	Beschreibung
rotaID	Zeichenfolge	Die sys_id für den Rotationsplan, in dem nach Dienstplänen gesucht werden soll.

Tabelle : 12. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Mitglied: wenn der Rotationsplan einen Dienstplan enthält. Dienstplan: wenn der Rotationsplan mehr als einen Dienstplan enthält. Keine Dienstpläne in diesem Rotationsplan: wenn keines der oben genannten Szenarien zutrifft. Benutzerdefiniert: Wenn die benutzerdefinierte Eskalation anwendbar ist.

var rotaSysId = '349f399173062300e7af6238edf6a75e';
var onCallRotation = new OnCallRotation();
var escalationType = onCallRotation.getEscalationType(rotaSysId);
gs.log(escalationType);

Ausgabe:

custom

OnCallRotation – OnCallRotation()

Erstellt eine Instanz der OnCallRotation-Klasse.

Tabelle : 13. Parameter
Name	Typ	Beschreibung
Keine

var oncall = new OnCallRotation();

OnCallRotation – spansOverlap(ArrayList parent, ArrayList child, String timeZone)

Überprüft, ob sich die übergeordnete Spanne und die untergeordneten Spannen überschneiden.

Tabelle : 14. Parameter
Name	Typ	Beschreibung
parent	ArrayList	Die zu vergleichenden übergeordneten Spannen.
child	ArrayList	Die zu vergleichenden untergeordneten Spannen.
timeZone	Zeichenfolge	Der Name der Zeitzone.

Tabelle : 15. Ergebnisse
Typ	Beschreibung
Boolean	Gibt „true“ zurück, wenn sich die übergeordneten und untergeordneten Spannen überschneiden.

var onCall = new OnCallRotation();
 
// get a time range we are interested in
var timeZone = gs.getSession().getTimeZoneName();
var dateStart = new GlideDateTime();
var dateEnd = new GlideDateTime().addMonths(1);
 
// convert glidedatime to scheduledatetime because it is required
// by the function being called below
var scheduleStart = new GlideScheduleDateTime(dateStart);
var scheduleEnd =  new GlideScheduleDateTime(dateEnd);
scheduleStart.setTimeZone(timeZone);
scheduleEnd.setTimeZone(timeZone);
 
// calculate rotation items based on the date and time given
// for all the groups the currently logged in user is a member of
gs.include("OnCallRotationPersonal");
var rotation = new OnCallRotationPersonal();
var myGroups = gs.getUser().getMyGroups();
var groupIter = myGroups.iterator();
 
while(groupIter.hasNext()){
	var rotaItems = rotation.onCallDuringPeriod(groupIter.next(), scheduleStart, scheduleEnd);
 
	// loop through rotation schedules
	for (var i = 0; i < rotaItems.length - 1; i++) {
		var parentItem = rotaItems[i];
		var nextItem = rotaItems[i + 1];
 
		// check if previous and next time spans overlap
		var overlaps = onCall.spansOverlap(parentItem.getTimeSpans(), nextItem.getTimeSpans(), 
			gs.getSession().getTimeZoneName());
	}
}

OnCallRotation – getEscalateesAt(String groupSysId, GlideDateTime gdt, Number position, GlideRecord taskGr)

Ruft die Eskalierten (entweder ein Benutzer-, Gruppen- oder Gerätedatensatz, abhängig von den Benachrichtigungsregeln) zu einem bestimmten Zeitpunkt und an einer bestimmten Position ab. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Hinweis:

Legen Sie den Parameter taskGR fest, um die Eskalationsplanauswertung zu aktivieren.

Tabelle : 16. Parameter
Name	Typ	Beschreibung
groupSysId	Zeichenfolge	ys_id der Gruppe.
gDT	GlideDateTime	jjjj-mm-tt HH:mm:ss-Format in der UTC-Zeitzone. Standard ist jetzt.
position	Zahl	Position des Eskalationsschrittes.
taskGr	GlideRecord	Optional. Aktueller Aufgabendatensatz. Wenn taskGr leer ist, gibt diese Methode den Standardeskalationsplan zurück. Wenn taskGr übergeben wird, werden die Eskalationsrichtlinien der Reihe nach ausgewertet, und diese Methode gibt den entsprechenden Eskalationsplan zurück.

Tabelle : 17. Ergebnisse
Typ	Beschreibung
GlideRecord	Array von Eskalierten (entweder ein Benutzer-, Gruppen- oder Gerätedatensatz, abhängig von den Benachrichtigungsregeln) zu einem bestimmten Zeitpunkt und an einer bestimmten Position.

var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var escalatees = onCallRotation.getEscalateesAt(groupSysId, currentTime, 1);
for (var i = 0; i < escalatees.length; i++) {
gs.log(escalatees[i].name);
}

Ausgabe:

Für überlappende Schichten:

Abel Tuter
Barbara Hindley

Für benutzerdefinierte Eskalation:

Abel Tuter
Beth Anglin
Change Management
Barbara Hindley

// Create a custom escalation for service desk shift with condition as P1 for Incident
var serviceDeskSysId = 'd625dccec0a8016700a222a0f7900d06';
// optional parameter taskGR
var taskGr = new GlideRecord('incident');
taskGr.get('ed92e8d173d023002728660c4cf6a7bc');

var ocRotation = new OnCallRotation();
var position = 1;
var escalatees = ocRotation.getEscalateesAt(serviceDeskSysId, new GlideDateTime(), position, taskGr);

// if taskGr is empty then it returns escalatees at a position in default escalation plan
// if taskGr is passed then escalation policies are executed evaluated in order and escalatees at a position in corresponding escalation plan is returned
for (var i = 0; i < escalatees.length; i++) {
    gs.log(escalatees[i].getDisplayValue());
}

OnCallRotation – getPrimaryUser()

Ruft die sys_id des aktuellen primären Kontakts bei einer einzelnen Schicht auf.

Tabelle : 18. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 19. Ergebnisse
Typ	Beschreibung
Zeichenfolge	sys_id des aktuellen primären Kontakts.

Beispiel:


var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.who(groupSysId, currentTime);
var primaryUser = onCallRotation.getPrimaryUser();

Ausgabe:

62826bf03710200044e0bfc8bcbe5df1

OnCallRotation – getPrimaryUserByRota(String rotaId)

Ruft die sys_id des aktuellen primären Benutzers der angegebenen Schicht auf. Diese API ist für eine einzelne Schicht und sich überschneidende Schichten anwendbar.

Tabelle : 20. Parameter
Name	Typ	Beschreibung
rotaId	Zeichenfolge	sys_id der cmn_rota.

Tabelle : 21. Ergebnisse
Typ	Beschreibung
Zeichenfolge	sys_id des aktuellen primären Benutzers der angegebenen Schicht.


var groupSysId = '096fb59173062300e7af6238edf6a783';
var rotaId = '349f399173062300e7af6238edf6a75e';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.who(groupSysId, currentTime);
var primaryUser = onCallRotation.getPrimaryUserByRota(rotaId);
gs.log(primaryUser);

Ausgabe:

62826bf03710200044e0bfc8bcbe5df1

OnCallRotation – getPrimaryUserName()

Ruft den Namen des aktuellen primären Kontakts ab. Diese API gilt für eine einzelne Schicht.

Tabelle : 22. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 23. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Name des aktuellen primären Kontakts.


var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.who(groupSysId, currentTime);
var primaryUser = onCallRotation.getPrimaryUserName();
gs.log(primaryUser);

Ausgabe:

Abel Tuter

OnCallRotation – getPrimaryUserNameByRota(String rotaId)

Ruft den Namen des aktuellen primären Benutzers der angegebenen Schicht ab. Diese API ist für eine einzelne Schicht und sich überschneidende Schichten anwendbar.

Tabelle : 24. Parameter
Name	Typ	Beschreibung
rotaId	Zeichenfolge	sys_id der cmn_rota.

Tabelle : 25. Ergebnisse
Typ	Beschreibung
Zeichenfolge	Name des aktuellen primären Benutzers der angegebenen Schicht.


var groupSysId = '096fb59173062300e7af6238edf6a783';
var rotaId = '349f399173062300e7af6238edf6a75e';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.who(groupSysId, currentTime);
var primaryUser = onCallRotation.getPrimaryUserNameByRota(rotaId);
gs.log(primaryUser);

Ausgabe:

Abel Tuter

OnCallRotation – getPrimaryUsers()

Ruft die Liste der primären Kontakte für eine Schicht ab. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 26. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 27. Ergebnisse
Typ	Beschreibung
Objekt	Liste der primären Kontakte.


var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.who(groupSysId, currentTime);
var primaryUser = onCallRotation.getPrimaryUser();
gs.log(JSON.stringify(primaryUser));

Ausgabe:

{
  "349f399173062300e7af6238edf6a75e": {
    "userSysId": "62826bf03710200044e0bfc8bcbe5df1",
    "userName": "Abel Tuter"
  },
  "35af799173062300e7af6238edf6a79e": {
    "userSysId": "d2826bf03710200044e0bfc8bcbe5dc9",
    "userName": "Barbara Hindley"
  }
}

OnCallRotation – whoIsOnCall(String groupSysIds, String rotaSysIds, String rosterSysIds, GlideDateTime gdt)

Ruft die Liste der Benutzer ab, die zu einer bestimmten Zeit in Rufbereitschaft sind. Wenn keine Uhrzeit angegeben ist, wird die aktuelle Uhrzeit verwendet. Diese API ist für eine einzelne Schicht und sich überschneidende Schichten anwendbar.

Tabelle : 28. Parameter
Name	Typ	Beschreibung
groupSysIds	Zeichenfolge	Kommagetrennte Liste von sys_ids der sys_user_group, nach der die Datensätze gefiltert werden sollen.
rotaSysIds	Zeichenfolge	Kommagetrennte Liste von cmn_rota-sys_ids, nach der die Datensätze gefiltert werden sollen.
rosterSysIds	Zeichenfolge	Kommagetrennte Liste von cmn_rota_roster-sys_ids, nach der die Datensätze gefiltert werden sollen.
gDT	GlideDateTime	Datum in der UTC-Zeitzone

Tabelle : 29. Ergebnisse
Typ	Beschreibung
Objekt	Liste der Benutzer, Gruppen oder Geräte, die zu einer bestimmten Zeit in Rufbereitschaft sind. Beispielsweise Informationen zu userIds, deviceIds und escalationGroups.

var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var escalatees = onCallRotation. whoIsOnCall(groupSysId, "", "", currentTime);
gs.log(JSON.stringify(escalatees));

Ausgabe:

Für Einzelschicht:

[
  {
    "memberId": "119f399173062300e7af6238edf6a7e7",
    "memberIds": [],
    "userId": "62826bf03710200044e0bfc8bcbe5df1",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 1,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
  },
  {
    "memberId": "1d9f399173062300e7af6238edf6a7e8",
    "memberIds": [],
    "userId": "a8f98bb0eb32010045e1a5115206fe3a",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 2,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
  },
  {
    "memberId": "dd9f399173062300e7af6238edf6a7e9",
    "memberIds": [],
    "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 3,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
  }
]

Für überlappende Schicht:

[
  {
    "memberId": "119f399173062300e7af6238edf6a7e7",
    "memberIds": [],
    "userId": "62826bf03710200044e0bfc8bcbe5df1",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 1,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
  },
  {
    "memberId": "7daf799173062300e7af6238edf6a7a2",
    "memberIds": [],
    "userId": "d2826bf03710200044e0bfc8bcbe5dc9",
    "userIds": [],
    "roster": "b5af799173062300e7af6238edf6a7a2",
    "rota": "35af799173062300e7af6238edf6a79e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 1,
    "isOverride": false,
    "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
    "memberScheduleId": "06af799173062300e7af6238edf6a7cd"
  },
  {
    "memberId": "1d9f399173062300e7af6238edf6a7e8",
    "memberIds": [],
    "userId": "a8f98bb0eb32010045e1a5115206fe3a",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 2,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
  },
  {
    "memberId": "f5af799173062300e7af6238edf6a7c9",
    "memberIds": [],
    "userId": "ee826bf03710200044e0bfc8bcbe5def",
    "userIds": [],
    "roster": "b5af799173062300e7af6238edf6a7a2",
    "rota": "35af799173062300e7af6238edf6a79e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 2,
    "isOverride": false,
    "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
    "memberScheduleId": "8aaf799173062300e7af6238edf6a7cf"
  },
  {
    "memberId": "dd9f399173062300e7af6238edf6a7e9",
    "memberIds": [],
    "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
    "userIds": [],
    "roster": "9d9f399173062300e7af6238edf6a7e5",
    "rota": "349f399173062300e7af6238edf6a75e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 3,
    "isOverride": false,
    "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
    "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
  },
  {
    "memberId": "8aaf799173062300e7af6238edf6a7ca",
    "memberIds": [],
    "userId": "e2826bf03710200044e0bfc8bcbe5de0",
    "userIds": [],
    "roster": "b5af799173062300e7af6238edf6a7a2",
    "rota": "35af799173062300e7af6238edf6a79e",
    "group": "096fb59173062300e7af6238edf6a783",
    "escalationGroups": [],
    "deviceId": "",
    "deviceIds": [],
    "isDevice": false,
    "order": 3,
    "isOverride": false,
    "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
    "memberScheduleId": "02af799173062300e7af6238edf6a7d2"
  }
]

OnCallRotation – who(String groupSysId, GlideDateTime gdt, Boolean nullifyOverrideRoster, String rotaSysIds, Boolean overrideCustomEscalation, GlideRecord taskGR)

Gibt an, ob ein Benutzer, eine Gruppe oder ein Gerät in Rufbereitschaft ist. Diese Methode gilt für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation.

Hinweis:

Übergeben Sie den Parameter taskGR, um die Eskalationsplanauswertung zu aktivieren.

Tabelle : 30. Parameter
Name	Typ	Beschreibung
groupSysId	Zeichenfolge	Sys_id der Gruppe, nach der gesucht werden soll.
gDT	GlideDateTime	Datum und Uhrzeit. Format: jjjj-MM-tt HH:mm:ss in der UTC-Zeitzone Standard: Aktuelles Datum und Uhrzeit
nullifyOverrideRoster	Boolean	Kennzeichnung, die angibt, ob die Benachrichtigungsliste für die Gruppe für einen bestimmten Dienstplan gilt. Gültige Werte: true: Nicht für einen bestimmten Dienstplan. false: Für einen bestimmten Dienstplan.
rotaSysIds	Zeichenfolge	Kommagetrennte Liste von cmn_rota-sys_ids, nach der die Datensätze gefiltert werden sollen.
überschreibenBenutzerdefinierteEskalation	Boolean	Kennzeichnung, die angibt, ob die standardmäßige Eskalationsrichtlinie mit der benutzerdefinierten Eskalation überschrieben werden soll. Gültige Werte: true: Überschreibt die standardmäßige Eskalationsrichtlinie. false: Standardmäßige Eskalationsrichtlinie nicht überschreiben.
taskGR	GlideRecord	Optional. Aktueller Aufgabendatensatz. Wenn übergeben, füllt die Methode die Eskalationsempfänger basierend auf den Eskalationsbedingungen aus.

Tabelle : 31. Ergebnisse
Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob eine Übereinstimmung gefunden wurde. Mögliche Werte: true: Mindestens eine Übereinstimmung wurde gefunden. false: Es wurden keine Übereinstimmungen gefunden.

var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.who(groupSysId, currentTime);
gs.log(result);

Ausgabe:

true

Das folgende Beispiel zeigt, wie eine benutzerdefinierte Eskalation für die Service Desk-Schicht mit Bedingung P1 für einen Incident erstellt wird.

/**
 * When the who() method is invoked with the optional taskGr parameter, 
 * escalatees are populated based on the conditional escalations
**/

var serviceDeskSysId = 'd625dccec0a8016700a222a0f7900d06';
var taskGr = new GlideRecord('incident');
taskGr.get('ed92e8d173d023002728660c4cf6a7bc');

var ocRotation = new OnCallRotation();
ocRotation.who(serviceDeskSysId, null, null, null, null, taskGr);
while (ocRotation.next()) {
    gs.log(ocRotation.getUserName());
}

Ausgabe:

Beth Anglin

OnCallRotation – whoAt(String groupSysId, GlideDateTime gdt, String rotaSysIds)

Gibt an, ob ein Benutzer, eine Gruppe oder ein Gerät in Rufbereitschaft ist. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 32. Parameter
Name	Typ	Beschreibung
groupSysId	Zeichenfolge	Sys-ID der Gruppe.
gDT	GlideDateTime	jjjj-mm-tt HH:mm:ss-Format in der UTC-Zeitzone. Standard ist jetzt.
rotaSysIds	Zeichenfolge	Kommagetrennte Liste von cmn_rota-Sys-IDs, nach der die Datensätze gefiltert werden sollen.

Tabelle : 33. Ergebnisse
Typ	Beschreibung
Boolean	„True“, wenn mindestens ein Benutzer, eine Gruppe oder ein Gerät in Rufbereitschaft ist; Andernfalls „false“.


var groupSysId = '096fb59173062300e7af6238edf6a783';
var currentTime = new GlideDateTime();
var onCallRotation = new OnCallRotation();
var result = onCallRotation.whoAt(groupSysId, currentTime);
gs.log(result);

Ausgabe:

true

OnCallRotation – startEscalations(GlideRecord now_GR, String eventName, String escalationScriptName)

Starten Sie die Eskalationen für ein Dokument (incident now_GR) und eine Gruppe, und geben Sie den Ereignisnamen für die Eskalationsbenachrichtigungen an. Geben Sie außerdem den Namen der Business Rule an, die bei einer Eskalation aufgerufen werden soll. Diese Methode sollte nach einem erfolgreichen Aufruf der Methoden who oder whoAt verwendet werden. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 34. Parameter
Name	Typ	Beschreibung
now_GR	GlideRecord	Dokument-GlideRecord. Beispiel: Incident now_GR.
eventName	Zeichenfolge	Ereignisname für die Eskalationsbenachrichtigungen.
escalationScriptName	Zeichenfolge	Business Rule, die bei einer Eskalation aufgerufen werden soll

Tabelle : 35. Ergebnisse
Typ	Beschreibung
void

OnCallRotation – addCurrentToNotified()

Fügen Sie der Liste der benachrichtigten Benutzer das aktuelle Eskalationsmitglied hinzu, damit die API weiß, wer kontaktiert wurde. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 36. Parameter
Name	Typ	Beschreibung
Keine

Tabelle : 37. Ergebnisse
Typ	Beschreibung
void

OnCallRotation – whoIsNext(GlideRecord escalationGr)

Durch die Business Rules für die Eskalation wird festgelegt, wer in der Schicht als nächstes kontaktiert werden soll. Der Eskalationsdatensatz, der an die Methode übergeben wird, verfolgt die Eskalation zwischen Aufrufen der Business Rule. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 38. Parameter
Name	Typ	Beschreibung
eskalationGr	GlideRecord	GlideRecord der Rotationseskalation [cmn_rota_escalation].

Tabelle : 39. Ergebnisse
Typ	Beschreibung
Keine

OnCallRotation – continueEscalations(GlideRecord escalationGr)

Setzen Sie die Eskalationen für ein Dokument (incident now_GR) und eine Gruppe fort. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 40. Parameter
Name	Typ	Beschreibung
eskalationGr	GlideRecord	GlideRecord der Rotationseskalation(cmn_rota_escalation

Tabelle : 41. Ergebnisse
Typ	Beschreibung
void

OnCallRotation – cancelEscalations(GlideRecord escalationGr)

Bricht jegliche Eskalationen für den GlideRecord ab, die mit der startEscalations-API gestartet wurden. Diese API ist für eine einzelne Schicht, sich überschneidende Schichten und benutzerdefinierte Eskalation anwendbar.

Tabelle : 42. Parameter
Name	Typ	Beschreibung
eskalationGr	GlideRecord	GlideRecord der Rotationseskalation(cmn_rota_escalation

Tabelle : 43. Ergebnisse
Typ	Beschreibung
void

OnCallRotation – Global

Washington DC API-Referenz

OnCallRotation – Global

OnCallRotation – getCatchAll(String rotaID)

OnCallRotation – getCatchAllType(String rotaID)

OnCallRotation – getEscalatees(String groupSysIds, String rotaSysIds, String rosterSysIds, GlideDateTime gdt, GlideRecord taskGr)

OnCallRotation – getEscalateeAt(String groupID, GlideDateTime dateTime, Number position)

OnCallRotation – getEscalationPlan(String groupSysId, GlideDateTime gdt, String rotaSysIds, GlideRecord taskGr)

OnCallRotation – getEscalationType(String rotaID)

OnCallRotation – OnCallRotation()

OnCallRotation – spansOverlap(ArrayList parent, ArrayList child, String timeZone)

OnCallRotation – getEscalateesAt(String groupSysId, GlideDateTime gdt, Number position, GlideRecord taskGr)

OnCallRotation – getPrimaryUser()

OnCallRotation – getPrimaryUserByRota(String rotaId)

OnCallRotation – getPrimaryUserName()

OnCallRotation – getPrimaryUserNameByRota(String rotaId)

OnCallRotation – getPrimaryUsers()

OnCallRotation – whoIsOnCall(String groupSysIds, String rotaSysIds, String rosterSysIds, GlideDateTime gdt)

OnCallRotation – who(String groupSysId, GlideDateTime gdt, Boolean nullifyOverrideRoster, String rotaSysIds, Boolean overrideCustomEscalation, GlideRecord taskGR)

OnCallRotation – whoAt(String groupSysId, GlideDateTime gdt, String rotaSysIds)

OnCallRotation – startEscalations(GlideRecord now_GR, String eventName, String escalationScriptName)

OnCallRotation – addCurrentToNotified()

OnCallRotation – whoIsNext(GlideRecord escalationGr)

OnCallRotation – continueEscalations(GlideRecord escalationGr)

OnCallRotation – cancelEscalations(GlideRecord escalationGr)