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


---

# OCRotationV2 - 전역

# OCRotationV2 - 전역 {#ariaid-title1}

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

OCRotationV2 스크립트 포함은 OCRotation 스크립트 포함의 확장으로, Fullcalendar.io 및 DHTMLX 당직 달력에서 사용됩니다.

이 스크립트 포함을 사용하여 그룹, 교대, 명단 및 사용자를 기준으로 추가로 필터링되는 두 날짜 사이의 일정 시간 범위를 구합니다. OCRotationV2를 확장하여 동작을 추가하거나 수정할 수도 있습니다. 이는 당직 일정 관리의 일부입니다.

## OCRotationV2 - getGroups() {#ariaid-title2}

활성 순번이 있는 그룹의 배열을 반환합니다.
{#r_OCRotationV2-getGroups__table_ozg_nlb_h5__entry__3}

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

{#r_OCRotationV2-getGroups__table_ozg_nlb_h5} {#r_OCRotationV2-getGroups__table_pzg_nlb_h5__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 그룹 객체의 배열입니다. 각각에는 다음과 같은 속성이 포함됩니다. * sys_user_group 기록의 sys_id * sys_user_group 기록의 이름 {#r_OCRotationV2-getGroups__ul_brf_31x_55} |
[표 2. 반환]

{#r_OCRotationV2-getGroups__table_pzg_nlb_h5}

## OCRotationV2 - getRostersByRotas(문자열 rotaSysIds) {#ariaid-title3}

지정된 교대 ID에 대한 활성 근무자 명단의 배열을 반환합니다.
{#r_OCRotationV2-getRostersByRotas_String__table_y14_1mb_h5__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| rotaSysId | 문자열 | cmn_rota(교대 sys_id) 값을 쉼표로 구분한 목록입니다. |
[표 3. 매개변수]

{#r_OCRotationV2-getRostersByRotas_String__table_y14_1mb_h5} {#r_OCRotationV2-getRostersByRotas_String__table_z14_1mb_h5__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | rota 객체의 배열입니다. 각각에는 다음과 같은 속성이 포함됩니다. * cmn_rota_roster 기록의 sys_id * cmn_rota_roster 기록의 이름 * cmn_rota 기록의 교대 sys_id {#r_OCRotationV2-getRostersByRotas_String__ul_svs_y1x_55} |
[표 4. 반환]

{#r_OCRotationV2-getRostersByRotas_String__table_z14_1mb_h5}

## OCRotationV2 - getRotasByGroup(문자열 groupSysIds) {#ariaid-title4}

지정된 그룹 ID에 대한 활성 순번 배열을 반환합니다.
{#r_OCRotationV2-getRotasByGroup_String__table_jcg_xlb_h5__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| groupSysIds | 문자열 | sys_user_group(그룹 sys_id) 값을 쉼표로 구분한 목록입니다. |
[표 5. 매개변수]

{#r_OCRotationV2-getRotasByGroup_String__table_jcg_xlb_h5} {#r_OCRotationV2-getRotasByGroup_String__table_kcg_xlb_h5__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | rota 객체의 배열입니다. 각각에는 다음과 같은 속성이 포함됩니다. * cmn_rota 기록의 sys_id * cmn_rota 기록의 이름 * sys_user_group 기록의 그룹 sys_id {#r_OCRotationV2-getRotasByGroup_String__ul_plv_p1x_55} |
[표 6. 반환]

{#r_OCRotationV2-getRotasByGroup_String__table_kcg_xlb_h5}

## OCRotationV2 - getSpans() {#ariaid-title5}

지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.
{#r_OCRotationV2-getSpans__table_j24_jlb_h5__entry__3}

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

{#r_OCRotationV2-getSpans__table_j24_jlb_h5} {#r_OCRotationV2-getSpans__table_k24_jlb_h5__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 범위의 배열입니다. 각각에는 id, sys_id, table, rota_id, roster_id, user_id, text, description, color, textColor, start_date, end_date 속성이 포함됩니다. |
[표 8. 반환]

{#r_OCRotationV2-getSpans__table_k24_jlb_h5}  
기본 기간에 대한 모든 범위 가져오기

    var spans = new OCRotationV2().getSpans();
    var firstSpanStartDate = spans[0].start_date; // get the first span's start date

2014년 4월 1일부터 2014년 6월 5일까지의 모든 범위 가져오기

    var spans = new OCRotationV2()
        .setStartDate("2014-04-01")
        .setEndDate("2014-06-05")
        .getSpans();

기본 기간에 대한 네트워크 그룹의 범위를 가져옵니다.

    var spans = new OCRotationV2()
         .setGroupIds("287ebd7da9fe198100f92cc8d1d2154e")
         .getSpans();

2014년 1월 1일부터 2014년 1월 31일까지 ITIL 사용자의 범위 가져오기

    var spans = new OCRotationV2()
        .setStartDate("2014-01-01")
        .setEndDate("2014-01-31")
        .setUserIds("681b365ec0a80164000fb0b05854a0cd")
        .getSpans();