OnCallEscalationTemplateSNC : global

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • L’include de script OnCallEscalationTemplateSNC fournit des méthodes pour 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
    Néant

    Cet exemple instancie un objet OnCallEscalationTemplateSNC .

    var escTemp = new global.OnCallEscalationTemplateSNC();

    OnCallEscalationTemplateSNC : copyEscalationTemplatetoEscalationSet(Chaîne templateSysId, chaîne escalationSetSysId)

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

    Lorsque le modèle est appliqué à l’ensemble d’escalades, des 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’escalade définie dans la table Ensemble d’escalades d’équipe [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 :
    Si une erreur se produit, l’opération s’arrête et le modèle n’est pas appliqué. Si un avertissement se produit, l’opération se poursuit et certains enregistrements sont toujours 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’escalade définie sys_id n’est pas correcte.
    • Des définitions d’étapes d’escalade existent déjà dans l’ensemble d’escalades.

    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
    • Il n’y a aucune audience définie sur le modèle d’étape d’escalade

    Type de données : chaîne
    <Object>.warning.skipped_steps Index des étapes d’escalade qui ont été ignorées (basé sur 1).

    Type de données : tableau
    <Object>.warning.not_matching_steps Objet contenant des informations sur les étapes d’escalade pour lesquelles aucune liste n’est disponible au format {"numéro d’étape » :[numéro de liste]}.

    Par exemple, si la valeur de retour est {"3 » :[3]}, alors à la troisième étape d’escalade, la liste tertiaire n’est pas disponible.

    Type de données : objet

    Cet exemple applique le modèle de politique d’escalade Alterner les listes au Centre de services : ensemble d’escalade par défaut. L’objet de retour est vide car il n’y a pas d’erreurs ou 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 les listes au jeu d’escalade Heures de travail – Par défaut. Dans ce cas, l’équipe de développement d’application ne dispose que de deux listes, mais le modèle tente d’en affecter une troisième. Comme le nombre de listes ne correspond pas, un avertissement est lancé. Deux enregistrements sont toujours créés dans la table Définition des étapes d’escalade d’équipe [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’escalade.

    Tableau 4. Paramètres
    Nom Type Description
    escalationSetSysId Chaîne Sys_id de l’escalade définie dans la table Ensemble d’escalades d’équipe [cmn_rota_escalation_set].
    Tableau 5. Renvoie
    Type Description
    Néant

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

    var escSetSysId = "32820dc3eb422110249e8d835d5228c3";

var escTemp = new global.OnCallEscalationTemplateSNC();

escTemp.deleteEscalationSetSteps(escSetSysId);