OnCallEscalationTemplateSNC : global

L’include de script OnCallEscalationTemplateSNC fournit des méthodes permettant d’appliquer des modèles de politique d’escalade à des ensembles d’escalade.

Pour en savoir plus sur le processus d’escalade, reportez-vous à la section Defining On-Call Scheduling escalation process.

Cet include de script nécessite le module d’extension Planification d’astreinte (com.snc.on_call_rotation).

OnCallEscalationTemplateSNC : OnCallEscalationTemplateSNC()

Instancie un objet OnCallEscalationTemplateSNC .

Tableau 1. Paramètres

Nom	Type	Description
Aucun

Cet exemple instancie un objet OnCallEscalationTemplateSNC .

var escTemp = new global.OnCallEscalationTemplateSNC();

OnCallEscalationTemplateSNC : copyEscalationTemplatetoEscalationSet(String templateSysId, String escalationSetSysId)

Applique un modèle de politique d’escalade à un ensemble d’escalades.

Lorsque le modèle est appliqué à l’ensemble d’escalade, les enregistrements de définition d’étape d’escalade sont créés dans la table Définition d’étape d’escalade d’équipe [cmn_rota_esc_step_def].

Avant d’appeler cette méthode, appelez la méthode deleteEscalationSetSteps() pour supprimer les définitions d’étapes d’escalade existantes. Si les enregistrements existants ne sont pas supprimés en premier, cette méthode renvoie une erreur.

Tableau 2. Paramètres

Nom	Type	Description
templateSysId	Chaîne	Sys_id du modèle de politique d’escalade dans la table Modèle de politique d’escalade d’astreinte [on_call_template_escalation_policy].
EscalationSetSysId	Chaîne	Sys_id de l’ensemble d’escalade dans la table Ensemble d’escalades des équipes [cmn_rota_escalation_set].

Tableau 3. Renvoie

Type	Description
Objet	Objet contenant des messages d’erreur et d’avertissement. Si l’opération a réussi, cet objet est vide. Remarque : En cas d’erreur, l’opération s’arrête et le modèle n’est pas appliqué. En cas d’avertissement, l’opération se poursuit et certains enregistrements sont encore créés. { "error": "String", "warning": {Object} }
<Object>.erreur	Message d'erreur. Erreurs possibles : La sys_id du modèle de politique d’escalade n’est pas correcte. L’ensemble d’escalade sys_id est incorrect. Des définitions d’étapes d’escalade existent déjà dans l’ensemble d’escalade. Type de données : chaîne
<Object>.avertissement	Informations sur les avertissements. Type de données : objet { "message": "String", "skipped_steps": [Array], "not_matching_steps": {Object}, }
<Object>.avertissement.message	Message d’avertissement. Avertissements possibles : La position de liste ne correspond pas aux listes de l’équipe Aucune audience n’est définie sur le modèle d’étape d’escalade Type de données : chaîne
<Object>.warning.skipped_steps	Index de toutes les étapes d’escalade qui ont été ignorées (de base 1). Type de données : tableau
<Object>.warning.not_matching_steps	Objet contenant des informations sur toutes les étapes d’escalade pour lesquelles aucune liste n’est disponible au format {"step number » :[roster number]}. Par exemple, si la valeur de retour est {"3 » :[3]}, la liste tertiaire n’est pas disponible à la troisième étape d’escalade. Type de données : objet

Cet exemple applique le modèle de politique d’escalade Alterner les listes au Service Desk : jeu d’escalade par défaut. L’objet de retour est vide car il n’y a pas d’erreurs ni d’avertissements.

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

Sortie :

{}

Cet exemple applique le modèle de politique d’escalade Alterner la liste au jeu Heures de travail – Escalade par défaut. Dans ce cas, l’équipe de développement d’application n’a que deux listes, mais le modèle tente d’affecter une troisième liste. Étant donné que le nombre de listes ne correspond pas, un avertissement est émis. Deux enregistrements sont toujours créés dans la table Définition des étapes d’escalade des équipes [cmn_rota_esc_step_def].

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

Sortie :

{
   "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(String escalationSetSysId)

Supprime tous les enregistrements de définition d’étape d’escalade associés à un ensemble d’escalades.

Tableau 4. Paramètres

Nom	Type	Description
EscalationSetSysId	Chaîne	Sys_id de l’ensemble d’escalade dans la table Ensemble d’escalades des équipes [cmn_rota_escalation_set].

Tableau 5. Renvoie

Type	Description
Aucun

Cet exemple supprime toutes les définitions d’étapes d’escalade associées à Centre de services – Jeu d’escalade par défaut.

var escSetSysId = "32820dc3eb422110249e8d835d5228c3";

var escTemp = new global.OnCallEscalationTemplateSNC();

escTemp.deleteEscalationSetSteps(escSetSysId);