---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# OnCallEscalationTemplateSNC - 전역

# OnCallEscalationTemplateSNC - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

OnCallEscalationTemplateSNC 스크립트 포함은 에스컬레이션 정책 템플릿을 에스컬레이션 세트에 적용하는 메서드를 제공합니다.

에스컬레이션 프로세스에 대한 자세한 내용은 다음 문서를 참조하십시오 [Defining On-Call Scheduling escalation process](https://www.servicenow.com/docs/access?context=defining-escalation-process-and-template&version=australia&pubname=australia-it-service-management&ft:locale=en-US).

이 스크립트 포함에는 On-Call Scheduling 플러그인(com.snc.on_call_rotation)이 필요합니다.

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

OnCallEscalationTemplateSNC 객체를 인스턴스화합니다.
{#OnCallEscTemp-OnCallEscTemp__table_y2b_lld_rxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#OnCallEscTemp-OnCallEscTemp__table_y2b_lld_rxb}  
이 예제에서는 OnCallEscalationTemplateSNC 개체를 인스턴스화합니다.

    var escTemp = new global.OnCallEscalationTemplateSNC();

## OnCallEscalationTemplateSNC - copyEscalationTemplatetoEscalationSet(String templateSysId, String escalationSetSysId) {#ariaid-title3}

에스컬레이션 세트에 에스컬레이션 정책 템플릿을 적용합니다.
템플릿이 에스컬레이션 세트에 적용되면 교대조 에스컬레이션 단계 정의\[cmn_rota_esc_step_def\] 테이블에 에스컬레이션 단계 정의 기록이 생성됩니다.

이 메서드를 호출하기 전에 deleteEscalationSetSteps() 메서드를 호출하여 기존 에스컬레이션 단계 정의를 삭제합니다. 기존 기록을 먼저 삭제하지 않으면 이 메서드는 오류를 반환합니다.
{#OnCallEscTemp-copyEsTempEsSet_S_S__table_wh5_3td_3xb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| templateSysId | 문자열 | 당직 에스컬레이션 정책 템플릿 \[on_call_template_escalation_policy\] 테이블의 에스컬레이션 정책 템플릿 Sys_id입니다. |
| 에스컬레이션 세트 시스템 ID | 문자열 | 교대조 에스컬레이션 세트\[cmn_rota_escalation_set\] 테이블에 있는 에스컬레이션 세트의 Sys_id입니다. |
[표 2. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 객체 | 오류 및 경고 메시지를 포함하는 객체입니다. 운영이 성공하면 이 객체는 비어 있습니다. 주: 오류가 발생하면 작업이 중지되고 템플릿이 적용되지 않습니다. 경고가 발생해도 작업은 계속되고 일부 기록은 여전히 생성됩니다. { "error": "String", "warning": {Object} } |
| \<Object\>.error | 오류 메시지. 가능한 오류: * 에스컬레이션 정책 템플릿 sys_id이 올바르지 않습니다. * 에스컬레이션 세트 sys_id이 올바르지 않습니다. * 에스컬레이션 단계 정의가 이미 에스컬레이션 세트에 있습니다. {#OnCallEscTemp-copyEsTempEsSet_S_S__ul_dmh_3tc_kxb} 데이터 유형: 문자열 |
| \<Object\>.warning | 경고에 대한 정보입니다. 데이터 유형: 객체 { "message": "String", "skipped_steps": [Array], "not_matching_steps": {Object}, } |
| \<Object\>.warning.message | 경고 메시지 가능한 경고: * 명단 위치가 교대조의 근무자 명단과 일치하지 않음 * 에스컬레이션 단계 템플릿에 정의된 대상이 없습니다. {#OnCallEscTemp-copyEsTempEsSet_S_S__ul_zwt_zhr_rxb} 데이터 유형: 문자열 |
| \<Object\>.warning.skipped_steps | 건너뛴 에스컬레이션 단계의 인덱스입니다(1부터 시작). 데이터 유형: 배열 |
| \<Object\>.warning.not_matching_steps | 사용 가능한 명단이 없는 에스컬레이션 단계에 대한 정보를 포함하는 객체입니다( `{"단계 번호":[명단 번호]}` 형식). 예를 들어 반환 값이 `{"3":[3]}`이면 에스컬레이션 단계 3에서는 3차 명단을 사용할 수 없습니다. 데이터 유형: 객체 |
[표 3. 반환]

{#OnCallEscTemp-copyEsTempEsSet_S_S__table_xh5_3td_3xb}  
이 예에서는 근무자 명단에 따라 차례로 교대 에스컬레이션 정책 템플릿을 Service Desk -- 기본 에스컬레이션 세트에 적용합니다. 오류나 경고가 없기 때문에 반환 객체가 비어 있습니다.

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

출력:

    {}

이 예에서는 근무 시간 - 기본 에스컬레이션 세트에 근무 시간 에스컬레이션 세트에 근무 시간 에스컬레이션 정책 템플릿을 통해 차례로 교대합니다. 이 경우 애플리케이션 개발 교대조에는 명단이 두 개만 있지만 템플릿은 세 번째 명단을 할당하려고 시도합니다. 명단 수가 일치하지 않으므로 경고가 발생합니다. 교대조 에스컬레이션 단계 정의\[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));

출력:

    {
       "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(문자열 escalationSetSysId) {#ariaid-title4}

에스컬레이션 세트와 연결된 모든 에스컬레이션 단계 정의 기록을 삭제합니다.
{#OnCallEscTemp-deleteEsSetSteps_S__table_rvx_35d_3xb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 에스컬레이션 세트 시스템 ID | 문자열 | 교대조 에스컬레이션 세트\[cmn_rota_escalation_set\] 테이블에 있는 에스컬레이션 세트의 Sys_id입니다. |
[표 4. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 5. 반환]

{#OnCallEscTemp-deleteEsSetSteps_S__table_svx_35d_3xb}  
이 예에서는 Service Desk -- 기본 에스컬레이션 세트와 연결된 모든 에스컬레이션 단계 정의를 삭제합니다.

    var escSetSysId = "32820dc3eb422110249e8d835d5228c3";

    var escTemp = new global.OnCallEscalationTemplateSNC();

    escTemp.deleteEscalationSetSteps(escSetSysId);