--- 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 --- # OCRotation - 전역 # OCRotation - 전역 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분 OCRotation 스크립트 포함은 달력을 표시하는 데 사용되는 데이터 구조를 빌드하는 메서드를 제공합니다. 이 코드는 범위 항목 목록을 저장하는 GlideAJAXSchedulePage 객체를 빌드합니다. Gwt(레거시) 달력에 이 유형을 사용할 수 있습니다. 다른 달력 유형에 대한 스크립트 포함을 [OCRotationV2 - 전역](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#c_OCRotationV2 "OCRotationV2 스크립트 포함은 OCRotation 스크립트 포함의 확장으로, Fullcalendar.io 및 DHTMLX 당직 달력에서 사용됩니다.") 참조하십시오. 이는 당직 일정 관리의 일부입니다. ## OCRotation - buildRotas() {#ariaid-title2} 그룹, 교대 및 명단을 기반으로 당직 범위를 구축합니다. OCRotationV2 - getSpans 메서드에서 사용됩니다. {#r_OCRotation-buildrotas__table_bl2_jhb_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 1. 매개변수] {#r_OCRotation-buildrotas__table_bl2_jhb_h5} {#r_OCRotation-buildrotas__table_cl2_jhb_h5__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 2. 반환] {#r_OCRotation-buildrotas__table_cl2_jhb_h5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - getEndDate() {#ariaid-title3} 당직 범위를 검색할 기간의 종료 날짜를 반환합니다. {#r_OCRotation-getEndDate__table_ljb_njx_g5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 3. 매개변수] {#r_OCRotation-getEndDate__table_ljb_njx_g5} {#r_OCRotation-getEndDate__table_mjb_njx_g5__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 당직 범위를 검색할 기간의 종료 날짜입니다. | [표 4. 반환] {#r_OCRotation-getEndDate__table_mjb_njx_g5} ## OCRotation - getGroupIds() {#ariaid-title4} 당직 일정에 대한 sys_user_group(그룹 sys_id) 값의 쉼표로 구분된 목록을 반환합니다. {#r_OCRotation-getGroupIDs__table_d2s_nnx_g5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 5. 매개변수] {#r_OCRotation-getGroupIDs__table_d2s_nnx_g5} {#r_OCRotation-getGroupIDs__table_e2s_nnx_g5__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 당직 일정에 대한 sys_user_group(그룹 sys_id) 값을 쉼표로 구분한 목록입니다. | [표 6. 반환] {#r_OCRotation-getGroupIDs__table_e2s_nnx_g5} ## OCRotation - getRosterIds() {#ariaid-title5} 선택한 순번에 따라 명단을 반환합니다. {#r_OCRotation-getRosterIDs__table_kcq_gcb_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 7. 매개변수] {#r_OCRotation-getRosterIDs__table_kcq_gcb_h5} {#r_OCRotation-getRosterIDs__table_lcq_gcb_h5__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 선택한 순번에 따른 명단입니다. | [표 8. 반환] {#r_OCRotation-getRosterIDs__table_lcq_gcb_h5} ## OCRotation - getRotaGr(String rotaIds, String groupIds, String rosterIds, String userIds) {#ariaid-title6} 그룹, 교대, 사용자 및 명단별로 필터링된 cmn_rota 테이블에 대한 GlideRecord를 반환합니다. {#r_OCRotation-getrotaGr_String_String_String_String__table_r4x_prm_45__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | rotaId | 문자열 | 당직 일정에 대한 cmn_rota(교대 sys_id) 값을 쉼표로 구분한 목록입니다. | | groupIds | 문자열 | 당직 일정에 대한 sys_user_group(그룹 sys_id) 값을 쉼표로 구분한 목록입니다. | | rosterId | 문자열 | 당직 일정에 대한 cmn_rota_roster(명단 sys_id) 값의 쉼표로 구분된 목록입니다. | | 사용자 ID | 문자열 | 당직 일정에 대한 sys_user(사용자 sys_id) 값을 쉼표로 구분한 목록입니다. | [표 9. 매개변수] {#r_OCRotation-getrotaGr_String_String_String_String__table_r4x_prm_45} {#r_OCRotation-getrotaGr_String_String_String_String__table_s4x_prm_45__entry__2} | 유형 | 설명 | |-|-| | GlideRecord | 그룹, 교대, 사용자 및 명단별로 필터링된 cmn_rota 테이블에 대한 GlideRecord입니다. | [표 10. 반환] {#r_OCRotation-getrotaGr_String_String_String_String__table_s4x_prm_45} ## OCRotation - getRotaIds() {#ariaid-title7} 달력의 그룹에 대한 순번을 반환합니다. {#r_OCRotation-getRotaIDs__table_ycs_rbb_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 11. 매개변수] {#r_OCRotation-getRotaIDs__table_ycs_rbb_h5} {#r_OCRotation-getRotaIDs__table_zcs_rbb_h5__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 달력에 있는 그룹의 순번입니다. | [표 12. 반환] {#r_OCRotation-getRotaIDs__table_zcs_rbb_h5} ## OCRotation - getStartDate() {#ariaid-title8} 당직 범위를 검색할 기간의 시작 날짜를 반환합니다. {#r_OCRotation-getStartDate__table_asg_l3r_g5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 13. 매개변수] {#r_OCRotation-getStartDate__table_asg_l3r_g5} {#r_OCRotation-getStartDate__table_bsg_l3r_g5__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 당직 범위를 검색할 기간의 시작 날짜입니다. | [표 14. 반환] {#r_OCRotation-getStartDate__table_bsg_l3r_g5} ## OCRotation - getTimezone() {#ariaid-title9} 당직 달력에서 사용할 시간대를 반환합니다. {#r_OCRotation-getTimezone__table_u5g_kkx_g5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 15. 매개변수] {#r_OCRotation-getTimezone__table_u5g_kkx_g5} {#r_OCRotation-getTimezone__table_v5g_kkx_g5__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 당직 달력이 사용할 시간대입니다. 예: 유럽/마드리드 및 미국/태평양. | [표 16. 반환] {#r_OCRotation-getTimezone__table_v5g_kkx_g5} ## OCRotation - getUserIDs() {#ariaid-title10} 이렇게 하면 사용자별로 반환되는 일정이 필터링됩니다. 당직 일정을 필터링하는 데 사용되는 sys_user(사용자 sys_id) 값의 쉼표로 구분된 목록을 가져옵니다. {#r_OCRotation-getUserIDs__table_y3n_5cb_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 17. 매개변수] {#r_OCRotation-getUserIDs__table_y3n_5cb_h5} {#r_OCRotation-getUserIDs__table_z3n_5cb_h5__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 당직 일정을 필터링하는 데 사용되는 sys_user(사용자 sys_id) 값을 쉼표로 구분한 목록입니다. | [표 18. 반환] {#r_OCRotation-getUserIDs__table_z3n_5cb_h5} ## OCRotation - setEndDate(문자열 endDate, 부울 포함) {#ariaid-title11} 당직 범위를 검색할 기간의 종료 날짜를 설정합니다. 종료 날짜를 설정하지 않으면 기본적으로 다음 달의 마지막 날이 적용됩니다. OCRotationV2와 함께 사용 - getSpans. {#r_OCRotation-setEndDate_String_B__table_rvb_dkx_g5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | endDate | 문자열 | \[선택 사항\] 당직 일정의 종료 날짜입니다. | | 포함 | 부울 | \[선택 사항\] 예일 때는 종료 날짜가 시간 범위에 포함됩니다. 지정하지 않으면 이 값은 기본적으로 true로 설정됩니다. | [표 19. 매개변수] {#r_OCRotation-setEndDate_String_B__table_rvb_dkx_g5} {#r_OCRotation-setEndDate_String_B__table_svb_dkx_g5__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 20. 반환] {#r_OCRotation-setEndDate_String_B__table_svb_dkx_g5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setGroupIds(String groupIds) {#ariaid-title12} 그룹별로 반환되는 일정을 필터링합니다. 당직 일정에 대한 sys_user_group(그룹 sys_id) 값의 쉼표로 구분된 목록을 설정합니다. OCRotationV2와 함께 사용 - getSpans. {#r_OCRotation-setGroupIDs_String__table_zkc_kbb_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | groupIds | 문자열 | 당직 일정에 대한 sys_user_group(그룹 sys_id) 값을 쉼표로 구분한 목록입니다. | [표 21. 매개변수] {#r_OCRotation-setGroupIDs_String__table_zkc_kbb_h5} {#r_OCRotation-setGroupIDs_String__table_alc_kbb_h5__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 22. 반환] {#r_OCRotation-setGroupIDs_String__table_alc_kbb_h5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setRosterIds(문자열 rosterIds) {#ariaid-title13} 선택한 순번에 따라 명단을 설정합니다. OCRotationV2와 함께 사용 - getSpans. {#r_OCRotation-setRosterIDs_String__table_ljr_mcb_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | RosterId | 문자열 | 선택한 순번에 따른 명단입니다. | [표 23. 매개변수] {#r_OCRotation-setRosterIDs_String__table_ljr_mcb_h5} {#r_OCRotation-setRosterIDs_String__table_mjr_mcb_h5__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 24. 반환] {#r_OCRotation-setRosterIDs_String__table_mjr_mcb_h5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setRotaIds(String rotaIds) {#ariaid-title14} 달력에 있는 그룹의 순번을 설정합니다. OCRotationV2와 함께 사용 - getSpans. {#r_OCRotation-setRotaIDs_String__table_gvw_zbb_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 교대 ID | 문자열 | 달력에 있는 그룹의 순번입니다. | [표 25. 매개변수] {#r_OCRotation-setRotaIDs_String__table_gvw_zbb_h5} {#r_OCRotation-setRotaIDs_String__table_hvw_zbb_h5__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 26. 반환] {#r_OCRotation-setRotaIDs_String__table_hvw_zbb_h5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setStartDate(문자열 startDate) {#ariaid-title15} 당직 범위를 검색할 기간의 시작 날짜를 설정합니다. 시작 날짜가 설정되지 않은 경우 기본적으로 이전 달의 첫 번째 날이 적용됩니다. OCRotationV2와 함께 사용 - getSpans. {#r_OCRotation-setStartDate_String__table_ivn_bjx_g5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | startDate | 문자열 | \[선택 사항\] 당직 범위를 검색할 기간의 시작 날짜입니다. | [표 27. 매개변수] {#r_OCRotation-setStartDate_String__table_ivn_bjx_g5} {#r_OCRotation-setStartDate_String__table_jvn_bjx_g5__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 28. 반환] {#r_OCRotation-setStartDate_String__table_jvn_bjx_g5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setTimezone(문자열 시간대) {#ariaid-title16} 당직 달력에서 사용할 시간대를 설정합니다. OCRotationV2와 함께 사용 - getSpans. {#r_OCRotation-setTimezone_String__table_mpl_3mx_g5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 시간대 | 문자열 | 당직 달력이 사용할 시간대입니다. 예: 유럽/마드리드 및 미국/태평양. | [표 29. 매개변수] {#r_OCRotation-setTimezone_String__table_mpl_3mx_g5} {#r_OCRotation-setTimezone_String__table_npl_3mx_g5__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 30. 반환] {#r_OCRotation-setTimezone_String__table_npl_3mx_g5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setUserIds(문자열 userIds) {#ariaid-title17} 당직 일정을 필터링하는 데 사용되는 사용자 sys_id(sys_user) 값의 쉼표로 구분된 목록을 설정합니다. OCRotationV2와 함께 사용 - getSpans. {#r_OCRotation-setUserIDs_String__table_l3f_1db_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 사용자 ID | 문자열 | 당직 일정을 필터링하는 데 사용되는 sys_user(사용자 sys_id) 값을 쉼표로 구분한 목록입니다. | [표 31. 매개변수] {#r_OCRotation-setUserIDs_String__table_l3f_1db_h5} {#r_OCRotation-setUserIDs_String__table_m3f_1db_h5__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 32. 반환] {#r_OCRotation-setUserIDs_String__table_m3f_1db_h5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/OP7Ixg3fUvmdB8ukdQ94GA#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 현재 시간보다 한 달 전으로 설정되고 종료 날짜는 기본적으로 현재 시간보다 한 달 후로 설정됩니다. 그룹 ID, 교대 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.")