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


---

# OnCallRotation - 전역

# OnCallRotation - 전역 {#ariaid-title1}

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

OnCallRotation 스크립트 포함은 당직 일정을 관리하는 메서드를 제공합니다.

자세한 내용은 [당직 일정 관리를](https://www.servicenow.com/docs/access?context=c_OnCallScheduling&version=australia&pubname=australia-it-service-management&ft:locale=en-US) 참조하십시오.

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

OnCallRotation 클래스의 인스턴스를 만듭니다.
{#r_OCR-OnCallRotation__table_pzm_w3f_2w__entry__3}

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

{#r_OCR-OnCallRotation__table_pzm_w3f_2w}  

    var oncall = new OnCallRotation();

## OnCallRotation - addCurrentToNotified() {#ariaid-title3}

API가 연락한 사람을 알 수 있도록 알림을 받은 사용자 목록에 현재 에스컬레이션 구성원을 추가합니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#OCR-addCurrentToNotified__table_wd4_rbk_3gb__entry__3}

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

{#OCR-addCurrentToNotified__table_wd4_rbk_3gb} {#OCR-addCurrentToNotified__table_xd4_rbk_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 3. 반환]

{#OCR-addCurrentToNotified__table_xd4_rbk_3gb}

## OnCallRotation - cancelEscalations(GlideRecord escalationGr) {#ariaid-title4}

startEscalations API로 시작된 GlideRecord에 대한 모든 에스컬레이션을 취소합니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#OCR-cancelEscalations_GR__table_gv4_hbk_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 에스컬레이션 Gr | GlideRecord | 교대 에스컬레이션의 GlideRecord(cmn_rota_escalation |
[표 4. 매개변수]

{#OCR-cancelEscalations_GR__table_gv4_hbk_3gb} {#OCR-cancelEscalations_GR__table_hv4_hbk_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 5. 반환]

{#OCR-cancelEscalations_GR__table_hv4_hbk_3gb}

## OnCallRotation - continueEscalations(GlideRecord escalationGr) {#ariaid-title5}

문서(인시던트 now_GR) 및 그룹에 대한 에스컬레이션을 계속합니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#OCR-continueEscalations_GR__table_a5h_x1k_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 에스컬레이션 Gr | GlideRecord | 교대 에스컬레이션의 GlideRecord(cmn_rota_escalation |
[표 6. 매개변수]

{#OCR-continueEscalations_GR__table_a5h_x1k_3gb} {#OCR-continueEscalations_GR__table_b5h_x1k_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 7. 반환]

{#OCR-continueEscalations_GR__table_b5h_x1k_3gb}

## OnCallRotation - getCatchAll(문자열 rotaID) {#ariaid-title6}

예비 연락망 사람의 sys_id 가져옵니다. getCatchAllType() 메서드와 함께 사용하여 반환된 ID의 소스를 확인합니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#r_OCR-getCatchAll_S__table_g3f_cbg_2w__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 교대 ID | 문자열 | 로타의 sys_id입니다. |
[표 8. 매개변수]

{#r_OCR-getCatchAll_S__table_g3f_cbg_2w} {#r_OCR-getCatchAll_S__table_h3f_cbg_2w__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | sys_user, cmn_rota_roster 또는 null의 sys_id입니다. |
[표 9. 반환]

{#r_OCR-getCatchAll_S__table_h3f_cbg_2w}  


    var rotaSysId = '349f399173062300e7af6238edf6a75e';
    var onCallRotation = new OnCallRotation();
    var catchAll = onCallRotation.getCatchAll(rotaSysId);
    gs.log(catchAll);

출력:

    46d44a23a9fe19810012d100cca80666

## OnCallRotation - getCatchAllType(문자열 rotaID) {#ariaid-title7}

에스컬레이션 체인의 끝에 있는 _catch all_ 유형을 가져옵니다. 당직 근무자를 할당하지 않고 에스컬레이션 체인이 완료되면 구성된 경우 인시던트가 _catch all_에 할당됩니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#r_OCR-getCatchAllType_S__table_gsz_g1g_2w__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 교대 ID | 문자열 | 로타의 sys_id입니다. |
[표 10. 매개변수]

{#r_OCR-getCatchAllType_S__table_gsz_g1g_2w} {#r_OCR-getCatchAllType_S__table_hsz_g1g_2w__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | * Null: 잘못된 교대 ID 또는 예비 연락망을 사용할 수 없습니다. * Group_manager: 교대에 연결된 그룹의 관리자는 예비 연락망입니다. * 개인: 구성된 사용자가 예비 연락망입니다. * 전체: 구성된 명단의 모든 구성원이 예비 연락망자입니다. {#r_OCR-getCatchAllType_S__ul_yw2_51g_2w} |
[표 11. 반환]

{#r_OCR-getCatchAllType_S__table_hsz_g1g_2w}  

    var rotaSysId = '349f399173062300e7af6238edf6a75e';
    var onCallRotation = new OnCallRotation();
    var catchAllType = onCallRotation.getCatchAllType(rotaSysId);
    gs.log(catchAllType);

출력:

    group_manager

## OnCallRotation - getEscalateeAt(String groupID, GlideDateTime dateTime, Number position) {#ariaid-title8}

에스컬레이션 라인업의 특정 위치에서 지정된 날짜 및 시간에 그룹의 교대조에 대해 에스컬레이션할 항목(사용자 \[sys_user\], 그룹 또는 알림 장치\[cmn_notif_device\])을 가져옵니다. 이 API는 단일 교대조에 적용할 수 있습니다.
잘못된 위치 또는 그룹이 인수로 전달되면 메서드는 null을 반환합니다.

getTableName() 메서드를 사용하여 반환되는 GlideRecord가 sys_user 테이블인지 아니면 cmn_notif_device 테이블에서 왔는지 확인할 수 있습니다.
{#r_OCR-getEscalateeAt_S_GDT_N__table_txq_hxf_2w__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 그룹 ID | 문자열 | 에스컬레이션 항목을 가져올 그룹의 sys_id입니다. |
| 날짜/시간 | GlideDateTime | 에스컬레이션 라인업을 시작할 날짜 및 시간입니다. |
| 위치 | 번호 | 에스컬레이션 대상 항목을 결정할 라인업의 위치(1부터 시작, 카운트가 1부터 시작됨)입니다. |
[표 12. 매개변수]

{#r_OCR-getEscalateeAt_S_GDT_N__table_txq_hxf_2w} {#r_OCR-getEscalateeAt_S_GDT_N__table_uxq_hxf_2w__entry__2}

| 유형 | 설명 |
|-|-|
| GlideRecord | 에스컬레이션할 대상 항목, 즉 에스컬레이션 신청자(알림 규칙에 따라 사용자, 그룹 또는 장치 기록)는 특정 시간과 위치에서 해당됩니다. 아무것도 발견되지 않으면 null을 반환합니다. |
[표 13. 반환]

{#r_OCR-getEscalateeAt_S_GDT_N__table_uxq_hxf_2w}  


    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var escalatee = onCallRotation.getEscalateeAt(groupSysId, currentTime, 1);
    gs.log(escalatee.name);

출력:

    Abel Tuter

## OnCallRotation - getEscalatees(문자열 groupSysIds, 문자열 rotaSysIds, 문자열 rosterSysIds, GlideDateTime gdt, GlideRecord taskGr) {#ariaid-title9}

지정된 시간 동안 당직인 에스컬레이션 신청자 목록을 가져옵니다. 시간을 지정하지 않으면 현재 시간이 사용됩니다. groupSysId가 제공되지 않으면 빈 목록이 반환됩니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
주:  
에스컬레이션 계획 평가를 활성화하려면 taskGR 매개변수를 설정합니다.
{#OCR-getEscalatees_S_S_S_GDT__table_ixr_4jk_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| groupSysIds | 문자열 | 기록을 필터링할 쉼표로 구분된 sys_user_group sys_ids 목록입니다. |
| rotaSysId | 문자열 | 기록을 필터링할 쉼표로 구분된 cmn_rota sys_ids 목록입니다. |
| 명단 시스템 ID | 문자열 | 기록을 필터링할 쉼표로 구분된 cmn_rota_roster sys_ids 목록입니다. |
| gdt | GlideDateTime | UTC 시간대의 날짜 |
| taskGr | GlideRecord | 옵션입니다. 현재 작업 기록입니다. taskGr이 비어 있으면 이 메서드는 기본 에스컬레이션 계획을 반환합니다. taskGr이 전달되면 에스컬레이션 정책이 순서대로 평가되고 이 메서드는 해당 에스컬레이션 계획을 반환합니다. |
[표 14. 매개변수]

{#OCR-getEscalatees_S_S_S_GDT__table_ixr_4jk_3gb} {#OCR-getEscalatees_S_S_S_GDT__table_jxr_4jk_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | userId, deviceIds, escalationGroups 등의 에스컬레이션 신청자 정보입니다. |
[표 15. 반환]

{#OCR-getEscalatees_S_S_S_GDT__table_jxr_4jk_3gb}  


    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.getEscalatees(groupSysId, "", "", currentTime);
    gs.log(JSON.stringify(result));

출력:

단일 교대조의 경우:

    [
      {
        "memberId": "119f399173062300e7af6238edf6a7e7",
        "memberIds": [],
        "userId": "62826bf03710200044e0bfc8bcbe5df1",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 1,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
      },
      {
        "memberId": "1d9f399173062300e7af6238edf6a7e8",
        "memberIds": [],
        "userId": "a8f98bb0eb32010045e1a5115206fe3a",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 2,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
      },
      {
        "memberId": "dd9f399173062300e7af6238edf6a7e9",
        "memberIds": [],
        "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 3,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
      }
    ]

중복된 교대조의 경우:

    [
      {
        "memberId": "119f399173062300e7af6238edf6a7e7",
        "memberIds": [],
        "userId": "62826bf03710200044e0bfc8bcbe5df1",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 1,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
      },
      {
        "memberId": "7daf799173062300e7af6238edf6a7a2",
        "memberIds": [],
        "userId": "d2826bf03710200044e0bfc8bcbe5dc9",
        "userIds": [],
        "roster": "b5af799173062300e7af6238edf6a7a2",
        "rota": "35af799173062300e7af6238edf6a79e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 1,
        "isOverride": false,
        "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "06af799173062300e7af6238edf6a7cd"
      },
      {
        "memberId": "1d9f399173062300e7af6238edf6a7e8",
        "memberIds": [],
        "userId": "a8f98bb0eb32010045e1a5115206fe3a",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 2,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
      },
      {
        "memberId": "f5af799173062300e7af6238edf6a7c9",
        "memberIds": [],
        "userId": "ee826bf03710200044e0bfc8bcbe5def",
        "userIds": [],
        "roster": "b5af799173062300e7af6238edf6a7a2",
        "rota": "35af799173062300e7af6238edf6a79e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 2,
        "isOverride": false,
        "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "8aaf799173062300e7af6238edf6a7cf"
      },
      {
        "memberId": "dd9f399173062300e7af6238edf6a7e9",
        "memberIds": [],
        "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 3,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
      },
      {
        "memberId": "8aaf799173062300e7af6238edf6a7ca",
        "memberIds": [],
        "userId": "e2826bf03710200044e0bfc8bcbe5de0",
        "userIds": [],
        "roster": "b5af799173062300e7af6238edf6a7a2",
        "rota": "35af799173062300e7af6238edf6a79e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 3,
        "isOverride": false,
        "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "02af799173062300e7af6238edf6a7d2"
      }
    ]

사용자 지정 에스컬레이션의 경우

    [
      {
        "memberId": "",
        "memberIds": [],
        "userId": "",
        "userIds": [
          "62826bf03710200044e0bfc8bcbe5df1",
          "46d44a23a9fe19810012d100cca80666"
        ],
        "roster": "",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [
          "a715cd759f2002002920bde8132e7018"
        ],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 1,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": ""
      },
      {
        "memberId": "",
        "memberIds": [
          "119f399173062300e7af6238edf6a7e7"
        ],
        "userId": "",
        "userIds": [
          "62826bf03710200044e0bfc8bcbe5df1"
        ],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 2,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": ""
      }
    ]

    /**
     * create a custom escalation for service desk shift with condition as P1 for Incident
     * taskGr is optional parameter
     * if taskGr is empty then it returns list of escalatees in default escalation plan
     * if taskGr is passed then escalation policies are executed evaluated in order and list of escalatees in corresponding escalation plan is returned
    **/
    var serviceDeskSysId = 'd625dccec0a8016700a222a0f7900d06';
    var taskGr = new GlideRecord('incident');
    taskGr.get('ed92e8d173d023002728660c4cf6a7bc');

    var ocRotation = new OnCallRotation();
    var escalatees = ocRotation.getEscalatees(serviceDeskSysId, null, null, null, null, taskGr);
    gs.log(JSON.stringify(escalatees));

## OnCallRotation - getEscalationPlan(String groupSysId, GlideDateTime gdt, String rotaSysIds, GlideRecord taskGr) {#ariaid-title10}

지정된 날짜 및 시간에 그룹의 교대조에 대해 사용자\[sys_user\] 또는 알림 장치\[cmn_notif_device\]로 구성된 에스컬레이션 계획인 에스컬레이션 대상의 객체 목록을 가져옵니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
에스컬레이션 객체에는 다음 필드가 포함됩니다.

* 번호 순서: 라인업 내의 에스컬레이션 순서입니다
* 문자열 userId: sys_user 기록의 sys_id 또는 null
* 문자열 deviceId: cmn_notif_device 기록의 sys_id 또는 null
* 부울 isDevice: 에스컬레이션 대상 항목이 장치인지 사용자인지에 따라 예 또는 아니오
* GlideDuration timeBetweenReminders: 미리 알림이 전송되는 간격 간격 시간
* Number reminderNum: 에스컬레이션할 각 항목에 대해 보낼 미리 알림 수
{#r_OCR-getEscalationPlan_S_GDT__ul_isy_tyf_2w}  
주:  
에스컬레이션 계획 평가를 활성화하려면 taskGR 매개변수를 설정합니다.
{#r_OCR-getEscalationPlan_S_GDT__table_bs2_lyf_2w__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 그룹 ID | 문자열 | 에스컬레이션 계획이 필요한 그룹의 sys_id입니다. |
| gdt | GlideDateTime | 에스컬레이션 라인업을 시작할 날짜 및 시간입니다. 기본값은 now입니다. yyyy-MM-dd HH:mm:ss는 UTC 시간대 형식입니다. |
| rotaSysId | 문자열 | 기록을 필터링할 쉼표로 구분된 cmn_rota sys_ids 목록입니다. |
| taskGr | GlideRecord | 옵션입니다. 현재 작업 기록입니다. taskGr이 비어 있으면 이 메서드는 기본 에스컬레이션 계획을 반환합니다. taskGr이 전달되면 에스컬레이션 정책이 순서대로 평가되고 이 메서드는 해당 에스컬레이션 계획을 반환합니다. |
[표 16. 매개변수]

{#r_OCR-getEscalationPlan_S_GDT__table_bs2_lyf_2w} {#r_OCR-getEscalationPlan_S_GDT__table_cs2_lyf_2w__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 에스컬레이션할 에스컬레이션 객체의 목록입니다. |
[표 17. 반환]

{#r_OCR-getEscalationPlan_S_GDT__table_cs2_lyf_2w}  

    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.getEscalationPlan(groupSysId, currentTime);
    gs.log(JSON.stringify(result));

출력:

단일 교대조의 경우:

    [
      {
        "order": 1,
        "userId": "62826bf03710200044e0bfc8bcbe5df1",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "9d9f399173062300e7af6238edf6a7e5",
        "memberId": "119f399173062300e7af6238edf6a7e7",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [],
        "forcedCommunicationChannel": "",
        "rotaId": "349f399173062300e7af6238edf6a75e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
      },
      {
        "order": 2,
        "userId": "a8f98bb0eb32010045e1a5115206fe3a",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "9d9f399173062300e7af6238edf6a7e5",
        "memberId": "1d9f399173062300e7af6238edf6a7e8",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [],
        "forcedCommunicationChannel": "",
        "rotaId": "349f399173062300e7af6238edf6a75e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
      },
      {
        "order": 3,
        "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "9d9f399173062300e7af6238edf6a7e5",
        "memberId": "dd9f399173062300e7af6238edf6a7e9",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [],
        "forcedCommunicationChannel": "",
        "rotaId": "349f399173062300e7af6238edf6a75e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
      }
    ]

중복된 교대조의 경우:

    [
      {
        "order": 1,
        "userId": "62826bf03710200044e0bfc8bcbe5df1",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "9d9f399173062300e7af6238edf6a7e5",
        "memberId": "119f399173062300e7af6238edf6a7e7",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [
          {
            "order": 1,
            "userId": "d2826bf03710200044e0bfc8bcbe5dc9",
            "userIds": [],
            "deviceId": "",
            "deviceIds": [],
            "escalationGroups": [],
            "isDevice": false,
            "timeToNextStep": null,
            "cmnRotaEscStepDefId": null,
            "reminderNum": 1,
            "rosterId": "b5af799173062300e7af6238edf6a7a2",
            "memberId": "7daf799173062300e7af6238edf6a7a2",
            "memberIds": [],
            "isOverride": false,
            "additionalEscalatees": [],
            "forcedCommunicationChannel": "",
            "rotaId": "35af799173062300e7af6238edf6a79e",
            "groupId": "096fb59173062300e7af6238edf6a783",
            "rotaScheduleId": "3daf799173062300e7af6238edf6a79e",
            "memberScheduleId": "06af799173062300e7af6238edf6a7cd"
          }
        ],
        "forcedCommunicationChannel": "",
        "rotaId": "349f399173062300e7af6238edf6a75e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
      },
      {
        "order": 2,
        "userId": "a8f98bb0eb32010045e1a5115206fe3a",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "9d9f399173062300e7af6238edf6a7e5",
        "memberId": "1d9f399173062300e7af6238edf6a7e8",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [
          {
            "order": 2,
            "userId": "ee826bf03710200044e0bfc8bcbe5def",
            "userIds": [],
            "deviceId": "",
            "deviceIds": [],
            "escalationGroups": [],
            "isDevice": false,
            "timeToNextStep": null,
            "cmnRotaEscStepDefId": null,
            "reminderNum": 1,
            "rosterId": "b5af799173062300e7af6238edf6a7a2",
            "memberId": "f5af799173062300e7af6238edf6a7c9",
            "memberIds": [],
            "isOverride": false,
            "additionalEscalatees": [],
            "forcedCommunicationChannel": "",
            "rotaId": "35af799173062300e7af6238edf6a79e",
            "groupId": "096fb59173062300e7af6238edf6a783",
            "rotaScheduleId": "3daf799173062300e7af6238edf6a79e",
            "memberScheduleId": "8aaf799173062300e7af6238edf6a7cf"
          }
        ],
        "forcedCommunicationChannel": "",
        "rotaId": "349f399173062300e7af6238edf6a75e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
      },
      {
        "order": 3,
        "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeToNextStep": null,
        "cmnRotaEscStepDefId": null,
        "reminderNum": 1,
        "rosterId": "9d9f399173062300e7af6238edf6a7e5",
        "memberId": "dd9f399173062300e7af6238edf6a7e9",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [
          {
            "order": 3,
            "userId": "e2826bf03710200044e0bfc8bcbe5de0",
            "userIds": [],
            "deviceId": "",
            "deviceIds": [],
            "escalationGroups": [],
            "isDevice": false,
            "timeToNextStep": null,
            "cmnRotaEscStepDefId": null,
            "reminderNum": 1,
            "rosterId": "b5af799173062300e7af6238edf6a7a2",
            "memberId": "8aaf799173062300e7af6238edf6a7ca",
            "memberIds": [],
            "isOverride": false,
            "additionalEscalatees": [],
            "forcedCommunicationChannel": "",
            "rotaId": "35af799173062300e7af6238edf6a79e",
            "groupId": "096fb59173062300e7af6238edf6a783",
            "rotaScheduleId": "3daf799173062300e7af6238edf6a79e",
            "memberScheduleId": "02af799173062300e7af6238edf6a7d2"
          }
        ],
        "forcedCommunicationChannel": "",
        "rotaId": "349f399173062300e7af6238edf6a75e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
      }
    ]

사용자 지정 에스컬레이션의 경우:

    [
      {
        "order": 1,
        "userId": "",
        "userIds": [
          "62826bf03710200044e0bfc8bcbe5df1",
          "46d44a23a9fe19810012d100cca80666"
        ],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [
          "a715cd759f2002002920bde8132e7018"
        ],
        "isDevice": false,
        "timeBetweenReminders": {},
        "timeToNextStep": {},
        "cmnRotaEscStepDefId": "655042d173062300e7af6238edf6a738",
        "reminderNum": 1,
        "rosterId": "",
        "memberId": "",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [],
        "forcedCommunicationChannel": "",
        "rotaId": "349f399173062300e7af6238edf6a75e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": ""
      },
      {
        "order": 2,
        "userId": "",
        "userIds": [],
        "deviceId": "",
        "deviceIds": [],
        "escalationGroups": [],
        "isDevice": false,
        "timeBetweenReminders": {},
        "timeToNextStep": {},
        "cmnRotaEscStepDefId": "8b6042d173062300e7af6238edf6a7f3",
        "reminderNum": 1,
        "rosterId": "",
        "memberId": "",
        "memberIds": [],
        "isOverride": false,
        "additionalEscalatees": [],
        "forcedCommunicationChannel": "",
        "rotaId": "349f399173062300e7af6238edf6a75e",
        "groupId": "096fb59173062300e7af6238edf6a783",
        "rotaScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": ""
      }
    ]

    /**
    * create a custom escalation for service desk shift with condition as P1 for Incident
    * taskGr is optional parameter
    * if taskGr is empty then it returns default escalation plan
    * if taskGr is passed then escalation policies are executed evaluated in order and corresponding escalation plan is returned
    **/

    var serviceDeskSysId = 'd625dccec0a8016700a222a0f7900d06';
    var taskGr = new GlideRecord('incident');
    taskGr.get('ed92e8d173d023002728660c4cf6a7bc');

    var ocRotation = new OnCallRotation();
    var escalationPlan = ocRotation.getEscalationPlan(serviceDeskSysId, null, null, taskGr);
    gs.log(JSON.stringify(escalationPlan));

## OnCallRotation - getEscalationType(문자열 rotaID) {#ariaid-title11}

단순 계산을 기반으로 에스컬레이션 유형을 가져옵니다. 교대에 활성 명단이 하나 있는 경우 구성원을 교대로 변경합니다. 교대에 활성 명단이 두 개 이상 있는 경우 명단을 차례로 사용합니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#r_OCR-getEscalationType_S__table_avq_4zf_2w__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 교대 ID | 문자열 | 명단을 확인할 순번의 sys_id입니다. |
[표 18. 매개변수]

{#r_OCR-getEscalationType_S__table_avq_4zf_2w} {#r_OCR-getEscalationType_S__table_bvq_4zf_2w__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | * 구성원: 교대에 하나의 명단이 있는 경우. * 명단: 교대에 둘 이상의 명단이 있는 경우. * 이 교대에 명단 없음: 위의 항목 중 어느 것도 없는 경우. * 사용자 지정: 사용자 지정 에스컬레이션을 적용할 수 있는 경우 {#r_OCR-getEscalationType_S__ul_kxq_xzf_2w} |
[표 19. 반환]

{#r_OCR-getEscalationType_S__table_bvq_4zf_2w}  

    var rotaSysId = '349f399173062300e7af6238edf6a75e';
    var onCallRotation = new OnCallRotation();
    var escalationType = onCallRotation.getEscalationType(rotaSysId);
    gs.log(escalationType);

출력:

    custom

## OnCallRotation - getEscalateesAt(String groupSysId, GlideDateTime gdt, Number position, GlideRecord taskGr) {#ariaid-title12}

특정 시간과 위치에서 에스컬레이션 신청자(알림 규칙에 따라 사용자, 그룹 또는 장치 기록)를 가져옵니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
주:  
에스컬레이션 계획 평가를 활성화하려면 taskGR 매개변수를 설정합니다.
{#OCR-getEscalateesAt_S_GDT_N__table_o1s_x5j_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| groupSysId | 문자열 | 그룹의 ys_id입니다. |
| gdt | GlideDateTime | yyyy-MM-dd HH:mm:ss 형식입니다(UTC 시간대). 기본값은 now입니다. |
| 위치 | 번호 | 에스컬레이션 단계의 위치입니다. |
| taskGr | GlideRecord | 옵션입니다. 현재 작업 기록입니다. taskGr이 비어 있으면 이 메서드는 기본 에스컬레이션 계획을 반환합니다. taskGr이 전달되면 에스컬레이션 정책이 순서대로 평가되고 이 메서드는 해당 에스컬레이션 계획을 반환합니다. |
[표 20. 매개변수]

{#OCR-getEscalateesAt_S_GDT_N__table_o1s_x5j_3gb} {#OCR-getEscalateesAt_S_GDT_N__table_nmd_wvj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| GlideRecord | 특정 시간과 위치의 에스컬레이션 신청자(알림 규칙에 따라 사용자, 그룹 또는 장치 기록)의 배열입니다. |
[표 21. 반환]

{#OCR-getEscalateesAt_S_GDT_N__table_nmd_wvj_3gb}  

    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var escalatees = onCallRotation.getEscalateesAt(groupSysId, currentTime, 1);
    for (var i = 0; i < escalatees.length; i++) {
    gs.log(escalatees[i].name);
    }

출력:

중복된 교대조의 경우:

    Abel Tuter
    Barbara Hindley

사용자 지정 에스컬레이션의 경우:

    Abel Tuter
    Beth Anglin
    Change Management
    Barbara Hindley

    // Create a custom escalation for service desk shift with condition as P1 for Incident
    var serviceDeskSysId = 'd625dccec0a8016700a222a0f7900d06';
    // optional parameter taskGR
    var taskGr = new GlideRecord('incident');
    taskGr.get('ed92e8d173d023002728660c4cf6a7bc');

    var ocRotation = new OnCallRotation();
    var position = 1;
    var escalatees = ocRotation.getEscalateesAt(serviceDeskSysId, new GlideDateTime(), position, taskGr);

    // if taskGr is empty then it returns escalatees at a position in default escalation plan
    // if taskGr is passed then escalation policies are executed evaluated in order and escalatees at a position in corresponding escalation plan is returned
    for (var i = 0; i < escalatees.length; i++) {
        gs.log(escalatees[i].getDisplayValue());
    }

## OnCallRotation - getPrimaryUser() {#ariaid-title13}

단일 교대조가 있을 때 현재 기본 연락처의 sys_id 가져옵니다.
{#OCR-getPrimaryUser__table_zt1_qrj_3gb__entry__3}

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

{#OCR-getPrimaryUser__table_zt1_qrj_3gb} {#OCR-getPrimaryUser__table_a51_qrj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 기본 연락처의 sys_id입니다. |
[표 23. 반환]

{#OCR-getPrimaryUser__table_a51_qrj_3gb}  
예제:


    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.who(groupSysId, currentTime);
    var primaryUser = onCallRotation.getPrimaryUser();

출력:

    62826bf03710200044e0bfc8bcbe5df1

## OnCallRotation - getPrimaryUserByRota(문자열 rotaId) {#ariaid-title14}

지정된 교대조의 현재 기본 사용자의 sys_id 가져옵니다. 이 API는 단일 교대조 및 중복된 교대조에 적용할 수 있습니다.
{#OCR-getPrimaryUserByRota_S__table_n3s_zsj_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| rotaID | 문자열 | cmn_rota의 sys_id입니다. |
[표 24. 매개변수]

{#OCR-getPrimaryUserByRota_S__table_n3s_zsj_3gb} {#OCR-getPrimaryUserByRota_S__table_o3s_zsj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 교대조의 현재 기본 사용자 sys_id입니다. |
[표 25. 반환]

{#OCR-getPrimaryUserByRota_S__table_o3s_zsj_3gb}  


    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var rotaId = '349f399173062300e7af6238edf6a75e';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.who(groupSysId, currentTime);
    var primaryUser = onCallRotation.getPrimaryUserByRota(rotaId);
    gs.log(primaryUser);

출력:

    62826bf03710200044e0bfc8bcbe5df1

## OnCallRotation - getPrimaryUserName() {#ariaid-title15}

현재 기본 연락처의 이름을 가져옵니다. 이 API는 단일 교대조에 적용할 수 있습니다.
{#OCR-getPrimaryUserName__table_yzz_4sj_3gb__entry__3}

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

{#OCR-getPrimaryUserName__table_yzz_4sj_3gb} {#OCR-getPrimaryUserName__table_zzz_4sj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 기본 연락처의 이름입니다. |
[표 27. 반환]

{#OCR-getPrimaryUserName__table_zzz_4sj_3gb}  


    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.who(groupSysId, currentTime);
    var primaryUser = onCallRotation.getPrimaryUserName();
    gs.log(primaryUser);

출력:

    Abel Tuter

## OnCallRotation - getPrimaryUserNameByRota(문자열 rotaId) {#ariaid-title16}

지정된 교대조의 현재 기본 사용자 이름을 가져옵니다. 이 API는 단일 교대조 및 중복된 교대조에 적용할 수 있습니다.
{#OCR-getPrimaryUserNameByRota_S__table_k43_15j_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| rotaID | 문자열 | cmn_rota의 sys_id입니다. |
[표 28. 매개변수]

{#OCR-getPrimaryUserNameByRota_S__table_k43_15j_3gb} {#OCR-getPrimaryUserNameByRota_S__table_l43_15j_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 교대조의 현재 기본 사용자 이름입니다. |
[표 29. 반환]

{#OCR-getPrimaryUserNameByRota_S__table_l43_15j_3gb}  


    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var rotaId = '349f399173062300e7af6238edf6a75e';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.who(groupSysId, currentTime);
    var primaryUser = onCallRotation.getPrimaryUserNameByRota(rotaId);
    gs.log(primaryUser);

출력:

    Abel Tuter

## OnCallRotation - getPrimaryUsers() {#ariaid-title17}

교대조의 기본 연락처 목록을 가져옵니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#OCR-getPrimaryUsers__table_jbs_bsj_3gb__entry__3}

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

{#OCR-getPrimaryUsers__table_jbs_bsj_3gb} {#OCR-getPrimaryUsers__table_kbs_bsj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 기본 연락처 목록입니다. |
[표 31. 반환]

{#OCR-getPrimaryUsers__table_kbs_bsj_3gb}  


    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.who(groupSysId, currentTime);
    var primaryUser = onCallRotation.getPrimaryUser();
    gs.log(JSON.stringify(primaryUser));

출력:

    {
      "349f399173062300e7af6238edf6a75e": {
        "userSysId": "62826bf03710200044e0bfc8bcbe5df1",
        "userName": "Abel Tuter"
      },
      "35af799173062300e7af6238edf6a79e": {
        "userSysId": "d2826bf03710200044e0bfc8bcbe5dc9",
        "userName": "Barbara Hindley"
      }
    }

## OnCallRotation - spansOverlap(ArrayList parent, ArrayList 하위, 문자열 timeZone) {#ariaid-title18}

상위 범위와 하위 범위가 겹치는지 확인합니다.
{#r_OCR-spansOverlap_AL_AL_S__table_pzn_tjf_2w__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 상위 | 배열 목록 | 비교할 상위 범위입니다. |
| 하위 | 배열 목록 | 비교할 하위 범위입니다. |
| 시간대 | 문자열 | 시간대 이름입니다. |
[표 32. 매개변수]

{#r_OCR-spansOverlap_AL_AL_S__table_pzn_tjf_2w} {#r_OCR-spansOverlap_AL_AL_S__table_qzn_tjf_2w__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 상위 범위와 하위 범위가 겹치는 경우 예를 반환합니다. |
[표 33. 반환]

{#r_OCR-spansOverlap_AL_AL_S__table_qzn_tjf_2w}  

    var onCall = new OnCallRotation();
     
    // get a time range we are interested in
    var timeZone = gs.getSession().getTimeZoneName();
    var dateStart = new GlideDateTime();
    var dateEnd = new GlideDateTime().addMonths(1);
     
    // convert glidedatime to scheduledatetime because it is required
    // by the function being called below
    var scheduleStart = new GlideScheduleDateTime(dateStart);
    var scheduleEnd =  new GlideScheduleDateTime(dateEnd);
    scheduleStart.setTimeZone(timeZone);
    scheduleEnd.setTimeZone(timeZone);
     
    // calculate rotation items based on the date and time given
    // for all the groups the currently logged in user is a member of
    gs.include("OnCallRotationPersonal");
    var rotation = new OnCallRotationPersonal();
    var myGroups = gs.getUser().getMyGroups();
    var groupIter = myGroups.iterator();
     
    while(groupIter.hasNext()){
    	var rotaItems = rotation.onCallDuringPeriod(groupIter.next(), scheduleStart, scheduleEnd);
     
    	// loop through rotation schedules
    	for (var i = 0; i < rotaItems.length - 1; i++) {
    		var parentItem = rotaItems[i];
    		var nextItem = rotaItems[i + 1];
     
    		// check if previous and next time spans overlap
    		var overlaps = onCall.spansOverlap(parentItem.getTimeSpans(), nextItem.getTimeSpans(), 
    			gs.getSession().getTimeZoneName());
    	}
    }

## OnCallRotation - startEscalations(GlideRecord now_GR, 문자열 eventName, 문자열 escalationScriptName) {#ariaid-title19}

문서(인시던트 now_GR) 및 그룹의 에스컬레이션을 시작하고 에스컬레이션 알림의 이벤트 이름을 지정합니다. 또한 에스컬레이션이 발생할 때 호출할 비즈니스 규칙의 이름을 지정합니다. 이 메서드는 who 또는 whoAt 메서드를 성공적으로 호출한 후에 사용해야 합니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#OCR-startEscalations_GR_S_S__table_nh2_xzj_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| now_GR | GlideRecord | 문서 Glide 기록. 예를 들어 인시던트 now_GR입니다. |
| eventName | 문자열 | 에스컬레이션 알림의 이벤트 이름입니다. |
| escalationScriptName | 문자열 | 에스컬레이션이 발생할 때 호출할 비즈니스 규칙 |
[표 34. 매개변수]

{#OCR-startEscalations_GR_S_S__table_nh2_xzj_3gb} {#OCR-startEscalations_GR_S_S__table_oh2_xzj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 35. 반환]

{#OCR-startEscalations_GR_S_S__table_oh2_xzj_3gb}

## OnCallRotation - who(문자열, groupSysId, GlideDateTime, gdt, 부울 nullifyOverrideRoster, 문자열 rotaSysIds, 부울 overrideCustomEscalation, GlideRecord taskGR) {#ariaid-title20}

당직 사용자, 그룹 또는 장치가 있는지 지정합니다. 이 방법은 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
주:  
에스컬레이션 계획 평가를 활성화하는 매개변수를 전달 taskGR 합니다.
{#OCR-who_S_GDT_B_S__table_xgb_ypj_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| groupSysId | 문자열 | 확인할 그룹의 Sys_id입니다. |
| gdt | [GlideDateTime](https://servicenow-prod.fluidtopics.net/yyrrUwOqTDBeMM3IDUcPLQ#c_GlideDateTimeAPI "GlideDateTime 클래스는 GlideDateTime 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.") | 날짜 및 시간입니다. 형식: yyyy-MM-dd HH:mm:ss(UTC 표준 시간대) 기본값: 현재 날짜 및 시간 |
| nullifyOverrideRoster | 부울 | 그룹의 알림 목록이 특정 명단에 대한 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 특정 명단에 해당하지 않습니다. * false: 특정 명단의 경우. |
| rotaSysId | 문자열 | 기록을 필터링할 쉼표로 구분된 cmn_rota sys_ids 목록입니다. |
| overrideCustomEscalation | 부울 | 기본 에스컬레이션 정책을 사용자 지정 에스컬레이션으로 무효화할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 기본 에스컬레이션 정책을 무효화합니다. * false: 기본 에스컬레이션 정책을 재정의하지 않습니다. |
| taskGR | [GlideRecord](https://servicenow-prod.fluidtopics.net/Q2N~KJ0CerSTV4yr_nWFJw#c_GlideRecordAPI "GlideRecord API는 데이터베이스 작업에 사용됩니다.") | 옵션입니다. 현재 작업 기록입니다. 통과되면 메서드는 에스컬레이션 조건에 따라 에스컬레이션 신청자를 채웁니다. |
[표 36. 매개변수]

{#OCR-who_S_GDT_B_S__table_xgb_ypj_3gb} {#OCR-who_S_GDT_B_S__table_lzh_1rj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 일치하는 항목을 찾았는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 일치하는 항목이 하나 이상 있습니다. * false: 일치하는 항목이 없습니다. {#OCR-who_S_GDT_B_S__ul_f4h_qjk_lrb} |
[표 37. 반환]

{#OCR-who_S_GDT_B_S__table_lzh_1rj_3gb}  

    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.who(groupSysId, currentTime);
    gs.log(result);

출력:

    true

다음 예는 인시던트에 대한 조건 P1을 사용하여 서비스 데스크 교대조에 대한 사용자 지정 에스컬레이션을 생성하는 방법을 보여줍니다.

    /**
     * When the who() method is invoked with the optional taskGr parameter, 
     * escalatees are populated based on the conditional escalations
    **/

    var serviceDeskSysId = 'd625dccec0a8016700a222a0f7900d06';
    var taskGr = new GlideRecord('incident');
    taskGr.get('ed92e8d173d023002728660c4cf6a7bc');

    var ocRotation = new OnCallRotation();
    ocRotation.who(serviceDeskSysId, null, null, null, null, taskGr);
    while (ocRotation.next()) {
        gs.log(ocRotation.getUserName());
    }

출력:

    Beth Anglin

## OnCallRotation - whoAt(문자열 groupSysId, GlideDateTime gdt, 문자열 rotaSysIds) {#ariaid-title21}

당직 사용자, 그룹 또는 장치가 있는지 지정합니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#OCR-whoAt_S_GDT_S__table_xgb_ypj_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| groupSysId | 문자열 | 그룹의 시스템 ID입니다. |
| gdt | GlideDateTime | yyyy-MM-dd HH:mm:ss 형식입니다(UTC 시간대). 기본값은 now입니다. |
| rotaSysId | 문자열 | 기록을 필터링할 cmn_rota 시스템 ID의 쉼표로 구분된 목록입니다. |
[표 38. 매개변수]

{#OCR-whoAt_S_GDT_S__table_xgb_ypj_3gb} {#OCR-whoAt_S_GDT_S__table_ygb_ypj_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 하나 이상의 당직 사용자, 그룹 또는 장치가 있는 경우 True입니다. 그렇지 않으면 false입니다. |
[표 39. 반환]

{#OCR-whoAt_S_GDT_S__table_ygb_ypj_3gb}  


    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var result = onCallRotation.whoAt(groupSysId, currentTime);
    gs.log(result);

출력:

    true

## OnCallRotation - whoIsOnCall(문자열 groupSysIds, 문자열 rotaSysIds, 문자열 rosterSysIds, GlideDateTime gdt) {#ariaid-title22}

지정된 시간에 당직인 사용자 목록을 가져옵니다. 시간을 지정하지 않으면 현재 시간이 사용됩니다. 이 API는 단일 교대조 및 중복된 교대조에 적용할 수 있습니다.
{#OCR-whoIsOnCall_S_S_S_GDT__table_ixr_4jk_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| groupSysIds | 문자열 | 기록을 필터링할 쉼표로 구분된 sys_user_group sys_ids 목록입니다. |
| rotaSysId | 문자열 | 기록을 필터링할 쉼표로 구분된 cmn_rota sys_ids 목록입니다. |
| 명단 시스템 ID | 문자열 | 기록을 필터링할 쉼표로 구분된 cmn_rota_roster sys_ids 목록입니다. |
| gdt | GlideDateTime | UTC 시간대의 날짜 |
[표 40. 매개변수]

{#OCR-whoIsOnCall_S_S_S_GDT__table_ixr_4jk_3gb} {#OCR-whoIsOnCall_S_S_S_GDT__table_ubq_ykk_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 지정된 시간에 당직인 사용자, 그룹 또는 장치의 목록입니다. 예: userIds, deviceIds 및 escalationGroups에 대한 정보입니다. |
[표 41. 반환]

{#OCR-whoIsOnCall_S_S_S_GDT__table_ubq_ykk_3gb}  

    var groupSysId = '096fb59173062300e7af6238edf6a783';
    var currentTime = new GlideDateTime();
    var onCallRotation = new OnCallRotation();
    var escalatees = onCallRotation. whoIsOnCall(groupSysId, "", "", currentTime);
    gs.log(JSON.stringify(escalatees));

출력:

단일 교대조의 경우:

    [
      {
        "memberId": "119f399173062300e7af6238edf6a7e7",
        "memberIds": [],
        "userId": "62826bf03710200044e0bfc8bcbe5df1",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 1,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
      },
      {
        "memberId": "1d9f399173062300e7af6238edf6a7e8",
        "memberIds": [],
        "userId": "a8f98bb0eb32010045e1a5115206fe3a",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 2,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
      },
      {
        "memberId": "dd9f399173062300e7af6238edf6a7e9",
        "memberIds": [],
        "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 3,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
      }
    ]

중복된 교대조의 경우:

    [
      {
        "memberId": "119f399173062300e7af6238edf6a7e7",
        "memberIds": [],
        "userId": "62826bf03710200044e0bfc8bcbe5df1",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 1,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "9d9f399173062300e7af6238edf6a7ec"
      },
      {
        "memberId": "7daf799173062300e7af6238edf6a7a2",
        "memberIds": [],
        "userId": "d2826bf03710200044e0bfc8bcbe5dc9",
        "userIds": [],
        "roster": "b5af799173062300e7af6238edf6a7a2",
        "rota": "35af799173062300e7af6238edf6a79e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 1,
        "isOverride": false,
        "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "06af799173062300e7af6238edf6a7cd"
      },
      {
        "memberId": "1d9f399173062300e7af6238edf6a7e8",
        "memberIds": [],
        "userId": "a8f98bb0eb32010045e1a5115206fe3a",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 2,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "d99f399173062300e7af6238edf6a7ef"
      },
      {
        "memberId": "f5af799173062300e7af6238edf6a7c9",
        "memberIds": [],
        "userId": "ee826bf03710200044e0bfc8bcbe5def",
        "userIds": [],
        "roster": "b5af799173062300e7af6238edf6a7a2",
        "rota": "35af799173062300e7af6238edf6a79e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 2,
        "isOverride": false,
        "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "8aaf799173062300e7af6238edf6a7cf"
      },
      {
        "memberId": "dd9f399173062300e7af6238edf6a7e9",
        "memberIds": [],
        "userId": "0a826bf03710200044e0bfc8bcbe5d7a",
        "userIds": [],
        "roster": "9d9f399173062300e7af6238edf6a7e5",
        "rota": "349f399173062300e7af6238edf6a75e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 3,
        "isOverride": false,
        "rotationScheduleId": "119f399173062300e7af6238edf6a7df",
        "memberScheduleId": "519f399173062300e7af6238edf6a7f2"
      },
      {
        "memberId": "8aaf799173062300e7af6238edf6a7ca",
        "memberIds": [],
        "userId": "e2826bf03710200044e0bfc8bcbe5de0",
        "userIds": [],
        "roster": "b5af799173062300e7af6238edf6a7a2",
        "rota": "35af799173062300e7af6238edf6a79e",
        "group": "096fb59173062300e7af6238edf6a783",
        "escalationGroups": [],
        "deviceId": "",
        "deviceIds": [],
        "isDevice": false,
        "order": 3,
        "isOverride": false,
        "rotationScheduleId": "3daf799173062300e7af6238edf6a79e",
        "memberScheduleId": "02af799173062300e7af6238edf6a7d2"
      }
    ]

## OnCallRotation - whoIsNext(GlideRecord 에스컬레이션 Gr) {#ariaid-title23}

에스컬레이션 비즈니스 규칙은 교대조에서 다음에 연락할 대상을 결정합니다. 메서드에 전달된 에스컬레이션 기록은 비즈니스 규칙 발동 간 에스컬레이션을 추적합니다. 이 API는 단일 교대조, 중복된 교대조 및 사용자 지정 에스컬레이션에 적용할 수 있습니다.
{#OCR-whoIsNext_GR__table_h4n_fck_3gb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 에스컬레이션 Gr | GlideRecord | 교대 에스컬레이션 \[cmn_rota_escalation\]의 GlideRecord |
[표 42. 매개변수]

{#OCR-whoIsNext_GR__table_h4n_fck_3gb} {#OCR-whoIsNext_GR__table_i4n_fck_3gb__entry__2}

| 유형 | 설명 |
|-|-|
| 안 함 |   |
[표 43. 반환]

{#OCR-whoIsNext_GR__table_i4n_fck_3gb}