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


---

# OnCallContactPreferenceUtil - 전역

# OnCallContactPreferenceUtil - 전역 {#ariaid-title1}

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

OnCallContactPreferenceUtil 스크립트 포함은 연락처 기본 설정을 처리하는 메서드를 제공합니다.

연락처 기본 설정 구성은 [연락처 기본 설정 구성을](https://www.servicenow.com/docs/access?context=config-my-contact-prefs-oncall&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 참조하십시오.

이 스크립트 포함은 [OnCallRotation](https://servicenow-prod.fluidtopics.net/xOcDASjXEi0JYMAmogeLAA#c_OnCallRotationAPI "OnCallRotation 스크립트 포함은 당직 일정을 관리하는 메서드를 제공합니다.") 스크립트 포함을 지원합니다.

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

OnCallContactPreferenceUtil 클래스의 인스턴스를 만듭니다.
{#P-OnCallContactPreferenceUtil__table_pzm_w3f_2w__entry__3}

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

{#P-OnCallContactPreferenceUtil__table_pzm_w3f_2w}

## OnCallContactPreferenceUtil - getContactsAtByEscalatee(객체 에스컬레이션 신청자, 번호 contactAttempt, GlideDateTime gdt, 문자열 rotaSysIds) {#ariaid-title3}

에스컬레이션 객체가 있는 연락처 목록을 가져옵니다. 반환된 각 연락처에는 사용자 연락처 기본 설정 목록이 포함되어 있습니다.
{#P-getContactsAtByEscalatee_O_N_F_S__table_o1s_x5j_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 에스컬레이션 신청자 | 객체 | 필수입니다. [getEscalationPlan()](https://servicenow-prod.fluidtopics.net/xOcDASjXEi0JYMAmogeLAA#r_OCR-getEscalationPlan_S_GDT "지정된 날짜 및 시간에 그룹의 교대조에 대해 사용자[sys_user] 또는 알림 장치[cmn_notif_device]로 구성된 에스컬레이션 계획인 에스컬레이션 대상의 객체 목록을 가져옵니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.") 메서드에서 반환한 Escalatee 객체입니다. |
| 접촉 시도 | 번호 | 옵션입니다. \[기본값 = 1\]에 연락하려는 시도입니다. * <kbd class="ph userinput">1</kbd>: 첫 번째 시도 * <kbd class="ph userinput">2</kbd>: 첫 번째 미리 알림 * <kbd class="ph userinput">3개 이상</kbd>: 후속 미리 알림 {#P-getContactsAtByEscalatee_O_N_F_S__ul_gp2_q4w_gjb} |
| gdt | GlideDateTime | 선택 사항입니다. yyyy-MM-dd HH:mm:ss 형식입니다(UTC 시간대). 기본값은 now.admin입니다. |
| rotaSysId | 문자열 | 옵션입니다. \[cmn_rota\] 테이블의 교대조 시스템 ID를 쉼표로 구분한 문자열입니다. 기본값은 현재 시간의 교대조 시스템 ID를 반환합니다. |
[표 2. 매개변수]

{#P-getContactsAtByEscalatee_O_N_F_S__table_o1s_x5j_3gb} {#P-getContactsAtByEscalatee_O_N_F_S__table_nmd_wvj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 배열 | 특정 시간과 위치의 에스컬레이션 신청자(알림 규칙에 따라 사용자, 그룹 또는 장치 기록)의 배열입니다. * 유형: 문자열. 연락처 유형(예: 사용자) * sys_id: 문자열. \[sys_user\] 테이블의 사용자 시스템 ID입니다. * rota_id: 문자열. \[cmn_rota\] 테이블의 교대조 시스템 ID입니다. * roster_id: 문자열. \[cmn_rota_roster\] 테이블의 명단 시스템 ID입니다. * escalation_step_id: 문자열. 에스컬레이션 경로가 정의된 경우 \[cmn_rota_esc_step_def\] 테이블의 에스컬레이션 단계의 시스템 ID입니다. * forced_communication_channel: 문자열. 기본 설정에 지정된 경우 필수 커뮤니케이션 채널입니다. 지원되는 값으로는 SMS, 음성 기능 또는 이메일이 있습니다. * override_user_contact_preference: 부울. 연락처 재정의가 있으면 True이고 그렇지 않으면 False입니다. * preference_source: 문자열. 연락처 또는 그룹과 같은 기본 설정 소스입니다. * contact_attempt: 번호. 연락 시도: 1 = 첫 번째 시도, 2 = 첫 번째 미리 알림 등입니다. * user_preferences: 배열 객체입니다. * 유형: 문자열. 사용자가 선호하는 연락처 형식(예: SMS, 이메일 또는 번호)입니다. * \<기본 형식의 이름(예: 이메일 또는 숫자)\>: 문자열. 기본 연락처 유형의 콘텐츠(예: 이메일 주소 또는 전화 번호)입니다. {#P-getContactsAtByEscalatee_O_N_F_S__ul_pzn_52r_gjb} * contact_preferences, 배열 객체입니다. * 유형: 문자열. 사용자가 선호하는 연락처 형식(예: 이메일 또는 번호)입니다. * \<기본 형식의 이름(예: 이메일 또는 숫자)\>: 문자열. 기본 연락처 유형의 콘텐츠(예: 이메일 주소 또는 전화 번호)입니다. {#P-getContactsAtByEscalatee_O_N_F_S__ul_vnw_y2r_gjb} {#P-getContactsAtByEscalatee_O_N_F_S__ul_whv_4bp_3jb} |
[표 3. 반환]

{#P-getContactsAtByEscalatee_O_N_F_S__table_nmd_wvj_3gb}  

    var serviceDeskSysId = '<Sys_ID>';
    var ocRotation = new OnCallRotation();
    var escalationPlan = ocRotation.getEscalationPlan(serviceDeskSysId);
    var escalatee = escalationPlan[0];

    var onContactPrefUtil = new OnCallContactPreferenceUtil();
    var contactAttempt = 1;
    var gdt = new GlideDateTime();
    var contacts = onContactPrefUtil.getContactsAtByEscalatee(escalatee, contactAttempt, gdt);
    gs.log(JSON.stringify(contacts));

출력:

    [{
        "type": "user",
        "sys_id": "<Sys_ID>",
        "rota_id": "<Rotation_ID>",
        "roster_id": "",
        "escalation_step_id": "<Escalation_Step_ID>",
        "forced_communication_channel": "",
        "override_user_contact_preference": true,
        "preference_source": "contact",
        "contact_attempt": 1,
        "user_preferences": [{
            "type": "sms",
            "number": "8587200477"
        }],
        "contact_preferences": [{
            "type": "voice",
            "number": "5555555555"
        }]
    }]

## OnCallContactPreferenceUtil - getUserPreferences(String userSysId, Number contactAttempt, GlideDateTime gdt, String communicationTypes) {#ariaid-title4}

사용자가 통신을 선택한 시점의 연락처 기본 설정 목록을 가져옵니다. 시간을 지정하지 않으면 현재 시간이 사용됩니다. 이 방법은 단일 및 중복된 교대조에 적용할 수 있습니다.
{#P-getUserPreferences_S_N_GDT_S__table_ixr_4jk_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| userSysId | 문자열 | \[sys_user\] 테이블의 사용자 시스템 ID입니다. |
| 접촉 시도 | 번호 | 옵션입니다. \[기본값 = 1\]에 연락하려는 시도입니다. * <kbd class="ph userinput">1</kbd>: 첫 번째 시도 * <kbd class="ph userinput">2</kbd>: 첫 번째 미리 알림 * <kbd class="ph userinput">3개 이상</kbd>: 후속 미리 알림 {#P-getUserPreferences_S_N_GDT_S__ul_gp2_q4w_gjb} |
| gdt | GlideDateTime | 선택 사항입니다. yyyy-MM-dd HH:mm:ss 형식입니다(UTC 시간대). 기본값은 now입니다. |
| communication유형 | 문자열 | 옵션입니다. 다음 값 중 하나 이상을 포함하는 쉼표로 구분된 문자열: * 이메일 * SMS 메시지 * 음성 {#P-getUserPreferences_S_N_GDT_S__ul_pbz_gp5_1jb} 기본값에는 사용 가능한 모든 커뮤니케이션 유형이 포함됩니다. |
[표 4. 매개변수]

{#P-getUserPreferences_S_N_GDT_S__table_ixr_4jk_3gb} {#P-getUserPreferences_S_N_GDT_S__table_ubq_ykk_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 배열 | 당직 사용자 연락처 기본 설정. * 유형: 문자열. 사용자가 선호하는 연락처 형식(예: SMS, 이메일 또는 번호)입니다. * \<기본 형식의 이름(예: 이메일 또는 숫자)\>: 문자열. 기본 연락처 유형의 콘텐츠(예: 이메일 주소 또는 전화 번호)입니다. {#P-getUserPreferences_S_N_GDT_S__ul_pzn_52r_gjb} |
[표 5. 반환]

{#P-getUserPreferences_S_N_GDT_S__table_ubq_ykk_3gb}  

    var onContactPrefUtil = new OnCallContactPreferenceUtil();
    var contactAttempt = 1;
    var gdt = new GlideDateTime();
    var itilUserSysId = '<itilUserSysId>;
    var userPreferences = onContactPrefUtil.getUserPreferences(itilUserSysId, contactAttempt, gdt);
    gs.log(JSON.stringify(userPreferences));

출력:

    [{
        "type": "sms",
        "number": "5555555555"
    }, {
        "type": "voice",
        "number": "5555555555"
    }]

## OnCallContactPreferenceUtil - getCatchAllContacts(String rotaId, GlideDateTime gdt) {#ariaid-title5}

예비 연락망 연락처 및 기본 설정 목록을 가져옵니다.
{#P-getCatchAllContacts_S_GDT_S__table_xgb_ypj_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| rotaID | 문자열 | \[cmn_rota\] 테이블의 교대조 시스템 ID입니다. |
| gdt | GlideDateTime | 선택 사항입니다. yyyy-MM-dd HH:mm:ss 형식입니다(UTC 시간대). 기본값은 now입니다. |
[표 6. 매개변수]

{#P-getCatchAllContacts_S_GDT_S__table_xgb_ypj_3gb} {#P-getCatchAllContacts_S_GDT_S__table_ygb_ypj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 배열 | 기본 설정이 있는 예비 연락망 연락처 목록입니다. * 유형: 문자열. 연락처 유형(예: 사용자) * sys_id: 문자열. \[sys_user\] 테이블의 사용자 시스템 ID입니다. * rota_id: 문자열. \[cmn_rota\] 테이블의 교대조 시스템 ID입니다. * roster_id: 문자열. \[cmn_rota_roster\] 테이블의 명단 시스템 ID입니다. * escalation_step_id: 문자열. 에스컬레이션 경로가 정의된 경우 \[cmn_rota_esc_step_def\] 테이블의 에스컬레이션 단계의 시스템 ID입니다. * forced_communication_channel: 문자열. 기본 설정에 지정된 경우 필수 커뮤니케이션 채널입니다. 지원되는 값으로는 SMS, 음성 기능 또는 이메일이 있습니다. * override_user_contact_preference: 부울. 연락처 재정의가 있으면 True이고 그렇지 않으면 False입니다. * preference_source: 문자열. 연락처 또는 그룹과 같은 기본 설정 소스입니다. * contact_attempt: 번호. 연락 시도: 1 = 첫 번째 시도, 2 = 첫 번째 미리 알림 등입니다. * user_preferences: 배열 객체입니다. * 유형: 문자열. 사용자가 선호하는 연락처 형식(예: SMS, 이메일 또는 번호)입니다. * \<기본 형식의 이름(예: 이메일 또는 숫자)\>: 문자열. 기본 연락처 유형의 콘텐츠(예: 이메일 주소 또는 전화 번호)입니다. {#P-getCatchAllContacts_S_GDT_S__ul_pzn_52r_gjb} * contact_preferences, 배열 객체입니다. * 유형: 문자열. 사용자가 선호하는 연락처 형식(예: 이메일 또는 번호)입니다. * \<기본 형식의 이름(예: 이메일 또는 숫자)\>: 문자열. 기본 연락처 유형의 콘텐츠(예: 이메일 주소 또는 전화 번호)입니다. {#P-getCatchAllContacts_S_GDT_S__ul_vnw_y2r_gjb} {#P-getCatchAllContacts_S_GDT_S__ul_ftv_sbp_3jb} |
[표 7. 반환]

{#P-getCatchAllContacts_S_GDT_S__table_ygb_ypj_3gb}  
예제:


    var onContactPrefUtil = new OnCallContactPreferenceUtil();
    var contactAttempt = 1;
    var gdt = new GlideDateTime();
    var rotaSysId = '<Rotation_Sys_ID>';
    var catchAllContacts = onContactPrefUtil.getCatchAllContacts(rotaSysId, gdt);
    gs.log(JSON.stringify(catchAllContacts));

출력:

    [{
        "type": "user",
        "sys_id": "<Sys_ID>",
        "rota_id": "<Rotation_ID>",
        "roster_id": "",
        "escalation_step_id": "<Escalation_Step_ID>",
        "forced_communication_channel": "",
        "override_user_contact_preference": true,
        "preference_source": "contact",
        "contact_attempt": 1,
        "user_preferences": [{
            "type": "sms",
            "number": "8587200477"
        }],
        "contact_preferences": [{
            "type": "voice",
            "number": "5555555555"
        }]
    }]