--- sourceDocument: Xanadu API 참조 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference Release : - xanadu ft:locale : - ko-KR ft:publication_title : - Xanadu API 참조 ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # OCRotation - 전역 # OCRotation - 전역 {#ariaid-title1} * 릴리스 버전: Xanadu * * 업데이트 날짜 2024년 08월 01일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분 OCRotation 스크립트 포함은 달력을 표시하는 데 사용되는 데이터 구조를 작성하는 메서드를 제공합니다. 이 코드는 범위 항목 목록을 저장하는 GlideAJAXSchedulePage 개체를 빌드합니다. 이 유형은 Gwt(레거시) 달력에 사용할 수 있습니다. 다른 달력 유형에 대해서는 스크립트 포함을 [OCRotationV2 - 전역](https://servicenow-prod.fluidtopics.net/FJhspM84b8oNntqD0k7Wmw#c_OCRotationV2 "OCRotationV2 스크립트 포함은 OCRotation 스크립트 포함의 확장으로, Fullcalendar.io 및 DHTMLX 당직 달력에서 사용됩니다.") 참조하십시오. 이는 On-Call Scheduling의 일부입니다. ## 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/FJhspM84b8oNntqD0k7Wmw#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(문자열 rotaIds, 문자열 groupIds, 문자열 rosterIds, 문자열 userIds) {#ariaid-title6} 그룹, 교대, 사용자 및 명단으로 필터링된 cmn_rota 테이블에 대한 GlideRecord를 반환합니다. {#r_OCRotation-getrotaGr_String_String_String_String__table_r4x_prm_45__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 순번 | 문자열 | 당직 일정에 대한 cmn_rota(순번 sys_id) 값을 쉼표로 구분한 목록입니다. | | groupIds | 문자열 | 당직 일정에 대한 sys_user_group(그룹 sys_id) 값의 쉼표로 구분된 목록입니다. | | rosterIds | 문자열 | 당직 일정에 대한 cmn_rota_roster(명단 sys_id) 값을 쉼표로 구분한 목록입니다. | | 사용자 ID | 문자열 | 당직 일정에 대한 사용자 sys_id(sys_user) 값을 쉼표로 구분한 목록입니다. | [표 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_id(sys_user) 값의 쉼표로 구분된 목록을 가져옵니다. {#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_id(sys_user) 값을 쉼표로 구분한 목록입니다. | [표 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이면 종료 날짜가 시간 범위에 포함됩니다. 지정하지 않으면 이 값은 기본적으로 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/FJhspM84b8oNntqD0k7Wmw#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 한 달 전으로 지정되고 종료 날짜는 현재 시간으로부터 한 달 후로 설정됩니다. 그룹 ID, 순번 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setGroupIds(문자열 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/FJhspM84b8oNntqD0k7Wmw#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 한 달 전으로 지정되고 종료 날짜는 현재 시간으로부터 한 달 후로 설정됩니다. 그룹 ID, 순번 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setRosterIds(문자열 rosterIds) {#ariaid-title13} 선택한 순번에 따라 명단을 설정합니다. OCRotationV2 - getSpans와 함께 사용합니다. {#r_OCRotation-setRosterIDs_String__table_ljr_mcb_h5__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 명단 ID | 문자열 | 선택한 교대에 따른 명단. | [표 23. 매개변수] {#r_OCRotation-setRosterIDs_String__table_ljr_mcb_h5} {#r_OCRotation-setRosterIDs_String__table_mjr_mcb_h5__entry__2} | 유형 | 설명 | |-|-| | void | | [표 24. 반환] {#r_OCRotation-setRosterIDs_String__table_mjr_mcb_h5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/FJhspM84b8oNntqD0k7Wmw#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 한 달 전으로 지정되고 종료 날짜는 현재 시간으로부터 한 달 후로 설정됩니다. 그룹 ID, 순번 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.") ## OCRotation - setRotaIds(문자열 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/FJhspM84b8oNntqD0k7Wmw#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} | 유형 | 설명 | |-|-| | void | | [표 28. 반환] {#r_OCRotation-setStartDate_String__table_jvn_bjx_g5} **관련 참조** * [OCRotationV2 - getSpans()](https://servicenow-prod.fluidtopics.net/FJhspM84b8oNntqD0k7Wmw#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/FJhspM84b8oNntqD0k7Wmw#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_id(sys_user) 값을 쉼표로 구분한 목록입니다. | [표 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/FJhspM84b8oNntqD0k7Wmw#r_OCRotationV2-getSpans "지정된 시작 날짜부터 지정된 종료 날짜까지의 범위를 가져옵니다. 시작 및 종료 날짜가 제공되지 않은 경우 시작 날짜는 기본적으로 한 달 전으로 지정되고 종료 날짜는 현재 시간으로부터 한 달 후로 설정됩니다. 그룹 ID, 순번 ID, 명단 ID, 사용자 ID를 사용하여 범위를 추가로 필터링할 수도 있습니다.")