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


---

# OnCallContactPrefTemplate - 전역

# OnCallContactPrefTemplate - 전역 {#ariaid-title1}

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

OnCallContactPrefTemplate 스크립트 포함은 에스컬레이션 집합에 연락처 기본 설정 템플릿을 적용하는 메서드를 제공합니다.

에스컬레이션 프로세스에 대한 자세한 내용은 다음 문서를 참조하십시오 [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)이 필요합니다.

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

OnCallContactPrefTemplate 개체를 인스턴스화합니다.
{#OnCallCtPrefTemp-OnCallCtPrefTemp__table_b1n_q5c_kxb__entry__3}

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

{#OnCallCtPrefTemp-OnCallCtPrefTemp__table_b1n_q5c_kxb}  
이 예제에서는 OnCallContactPrefTemplate 개체를 인스턴스화합니다.

    var contactPrefTemp = new global.OnCallContactPrefTemplate();

## OnCallContactPrefTemplate - copyContactPreferences(문자열 templateSysId, 문자열 escalationSetSysId) {#ariaid-title3}

연락처 기본 설정 템플릿을 에스컬레이션 세트에 적용합니다.
템플릿이 에스컬레이션 세트에 적용되면 교대조 연락처 기본 설정 \[cmn_rota_contact_preference\] 테이블에 연락 시도 기록이 생성됩니다.

이 메서드를 호출하기 전에 deleteContactPreferenceAttempts() 메서드를 호출하여 기존 연락 시도 기록을 삭제합니다. 기존 기록을 먼저 삭제하지 않으면 이 메서드는 오류를 반환합니다.
{#OnCallCtPrefTemp-copyCtPrefs_S_S__table_cgl_2rd_3xb__entry__3}

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

{#OnCallCtPrefTemp-copyCtPrefs_S_S__table_cgl_2rd_3xb} {#OnCallCtPrefTemp-copyCtPrefs_S_S__table_dgl_2rd_3xb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 오류 및 경고 메시지를 포함하는 객체입니다. 운영이 성공하면 이 객체는 비어 있습니다. 주: 오류가 발생하면 작업이 중지되고 템플릿이 적용되지 않습니다. 경고가 발생해도 작업은 계속되고 일부 기록은 여전히 생성됩니다. { "error": "String", "warning": "String" } |
| \<Object\>.error | 오류 메시지. 가능한 값: * 연락처 기본 설정 템플릿 sys_id가 올바르지 않습니다. * 에스컬레이션 세트 sys_id가 올바르지 않습니다. * 연락 시도가 이미 있음 {#OnCallCtPrefTemp-copyCtPrefs_S_S__ul_dmh_3tc_kxb} 데이터 유형: 문자열 |
| \<Object\>.warning | 경고 메시지 데이터 유형: 문자열 |
[표 3. 반환]

{#OnCallCtPrefTemp-copyCtPrefs_S_S__table_dgl_2rd_3xb}  
이 예에서는 연락처 기본 설정 템플릿을 Service Desk -- 기본 에스컬레이션 세트에 적용합니다. 오류나 경고가 없기 때문에 반환 객체가 비어 있습니다.

    var escSetSysId = "a47ac1abeb5a6110249e8d835d5228aa";
    var templateSysId = "f8dac9ebeb5a6110249e8d835d522873";

    var contactPrefTemp = new global.OnCallContactPrefTemplate();

    // delete existing contact attempt records before applying the template
    contactPrefTemp.deleteContactPreferenceAttempts(escSetSysId); 

    var result = contactPrefTemp.copyContactPreferences(templateSysId, escSetSysId);
    gs.info(JSON.stringify(result));

출력:

    {}

## OnCallContactPrefTemplate - deleteContactPreferenceAttempts(문자열 escalationSetSysId) {#ariaid-title4}

에스컬레이션 세트와 관련된 모든 연락처 기본 설정을 삭제합니다.
에스컬레이션 세트에 대한 모든 연락 시도 기록이 교대조 연락처 기본 설정 \[cmn_rota_contact_preference\] 테이블에서 삭제됩니다.
{#OnCallCtPrefTemp-deleteCtPrefAtt_S__table_zlg_zqd_3xb__entry__3}

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

{#OnCallCtPrefTemp-deleteCtPrefAtt_S__table_zlg_zqd_3xb} {#OnCallCtPrefTemp-deleteCtPrefAtt_S__table_amg_zqd_3xb__entry__2}

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

{#OnCallCtPrefTemp-deleteCtPrefAtt_S__table_amg_zqd_3xb}  
이 예에서는 Service Desk -- 기본 에스컬레이션 세트와 관련된 모든 연락처 기본 설정을 삭제합니다.

    var escSetSysId = "a47ac1abeb5a6110249e8d835d5228aa";
    var contactPrefTemp = new global.OnCallContactPrefTemplate();

    contactPrefTemp.deleteContactPreferenceAttempts(escSetSysId);