---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# OnCallEscalationTemplateSNC - Global

# OnCallEscalationTemplateSNC - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

A inclusão de script OnCallEscalationTemplateSNC fornece métodos para aplicar modelos de política de escalação a conjuntos de escalação.

Para obter mais informações sobre o processo de escalação, consulte [Defining On-Call Scheduling escalation process](https://www.servicenow.com/docs/access?context=defining-escalation-process-and-template&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

Esta inclusão de script requer o plug-in Agendamento de plantão (com.snc.on_call_rotation).

## OnCallEscalationTemplateSNC - OnCallEscalationTemplateSNC() {#ariaid-title2}

Instancia um objeto OnCallEscalationTemplateSNC.
{#OnCallEscTemp-OnCallEscTemp__table_y2b_lld_rxb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum(a) |   |   |
[Tabela 1. Parâmetros]

{#OnCallEscTemp-OnCallEscTemp__table_y2b_lld_rxb}  
Este exemplo instancia um objeto OnCallEscalationTemplateSNC.

    var escTemp = new global.OnCallEscalationTemplateSNC();

## OnCallEscalationTemplateSNC - copyEscalationTemplatetoEscalationSet(cadeia de caracteres templateSysId, cadeia de caracteres escalationSetSysId) {#ariaid-title3}

Aplica um modelo de política de escalação a um conjunto de escalação.
Quando o modelo é aplicado ao conjunto de escalação, os registros de definição de etapa de escalação são criados na tabela Definição de etapa de escalação de turno \[cmn_rota_esc_step_def\].

Antes de chamar este método, chame o método deleteEscalationSetSteps() para excluir as definições de etapa de escalação existentes. Se os registros existentes não forem excluídos primeiro, este método retornará um erro.
{#OnCallEscTemp-copyEsTempEsSet_S_S__table_wh5_3td_3xb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| templateSysId | Cadeia de caracteres | Sys_id do modelo de política de escalação na tabela Modelo de política de escalação de plantão \[on_call_template_escalation_policy\]. |
| escalationSetSysId | Cadeia de caracteres | Sys_id do conjunto de escalação na tabela Conjunto de escalação de turno \[cmn_rota_escalation_set\]. |
[Tabela 2. Parâmetros]

{#OnCallEscTemp-copyEsTempEsSet_S_S__table_wh5_3td_3xb} {#OnCallEscTemp-copyEsTempEsSet_S_S__table_xh5_3td_3xb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Objeto que contém mensagens de erro e aviso. Se a operação foi bem-sucedida, este objeto está vazio. Nota: Se ocorrer um erro, a operação será interrompida e o modelo não será aplicado. Se ocorrer um aviso, a operação continuará e alguns registros ainda serão criados. { "error": "String", "warning": {Object} } |
| \<Object\>.erro | Mensagens de erro Possíveis erros: * O modelo de política de escalação sys_id não está correto. * O sys_id do conjunto de escalação não está correto. * As definições de etapa de escalação já existem no conjunto de escalação. {#OnCallEscTemp-copyEsTempEsSet_S_S__ul_dmh_3tc_kxb} Tipo de dados: cadeia de caracteres |
| \<Object\>.aviso | Informações sobre quaisquer avisos. Tipo de dados: objeto { "message": "String", "skipped_steps": [Array], "not_matching_steps": {Object}, } |
| \<Object\>.aviso.mensagem | Mensagem de aviso. Possíveis avisos: * A posição da escala não corresponde às escalas no turno * Não há públicos definidos no modelo de etapa de escalação {#OnCallEscTemp-copyEsTempEsSet_S_S__ul_zwt_zhr_rxb} Tipo de dados: cadeia de caracteres |
| \<Object\>.aviso.etapas_ignoradas | Índices de todas as etapas de escalação que foram ignoradas (base 1). Tipo de dados: matriz |
| \<Object\>.aviso.not_matching_steps | Objeto que contém informações sobre etapas de escalação que não têm escalas disponíveis no formato `{"step number":[roster number]}`. Por exemplo, se o valor de retorno for `{"3":[3]}`, na etapa três de escalação, a escala terciária não estará disponível. Tipo de dados: objeto |
[Tabela 3. Retorna]

{#OnCallEscTemp-copyEsTempEsSet_S_S__table_xh5_3td_3xb}  
Este exemplo aplica o modelo de política de escalação Rotacionar por meio de escalas ao conjunto de escalação Central de serviços - Padrão. O objeto de retorno está vazio porque não há erros ou avisos.

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

Saída:

    {}

Este exemplo aplica o modelo de política de escalação Rotação por meio de listagem ao conjunto de escalação Horário de trabalho - Padrão. Nesse caso, o turno de Desenvolvimento de aplicações tem apenas duas escalas, mas o modelo tenta atribuir uma terceira escala. Como o número de escalas não corresponde, um aviso será emitido. Dois registros ainda são criados na tabela Definição de etapa de escalação de turno \[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));

Saída:

    {
       "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(cadeia de caracteres escalationSetSysId) {#ariaid-title4}

Exclui todos os registros de definição de etapa de escalação associados a um conjunto de escalação.
{#OnCallEscTemp-deleteEsSetSteps_S__table_rvx_35d_3xb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| escalationSetSysId | Cadeia de caracteres | Sys_id do conjunto de escalação na tabela Conjunto de escalação de turno \[cmn_rota_escalation_set\]. |
[Tabela 4. Parâmetros]

{#OnCallEscTemp-deleteEsSetSteps_S__table_rvx_35d_3xb} {#OnCallEscTemp-deleteEsSetSteps_S__table_svx_35d_3xb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 5. Retorna]

{#OnCallEscTemp-deleteEsSetSteps_S__table_svx_35d_3xb}  
Este exemplo exclui todas as definições de etapa de escalação associadas ao conjunto de escalação Central de serviços - Padrão.

    var escSetSysId = "32820dc3eb422110249e8d835d5228c3";

    var escTemp = new global.OnCallEscalationTemplateSNC();

    escTemp.deleteEscalationSetSteps(escSetSysId);