--- sourceDocument: Xanadu API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # OCRotationV2 - グローバル # OCRotationV2 - グローバル {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分 OCRotationV2 スクリプトインクルードは、Fullcalendar.io および DHTMLX オンコールカレンダーで使用される OCRotation スクリプトインクルードの拡張です。 このスクリプトインクルードを使用して、グループ、勤務表、勤務表、およびユーザーでさらにフィルタリングされた 2 つの日付間のスケジュールのタイムスパンを取得します。OCRotationV2 を拡張して、動作を追加したり変更したりすることもできます。これは On-Call Scheduling の一部です。 ## 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} | 名前 | タイプ | 説明 | |-|-|-| | rotaSysIds | 文字列 | 勤務表 sys_id (cmn_rota) の値のカンマ区切りリスト。 | [表 : 3. パラメーター] {#r_OCRotationV2-getRostersByRotas_String__table_y14_1mb_h5} {#r_OCRotationV2-getRostersByRotas_String__table_z14_1mb_h5__entry__2} | タイプ | 説明 | |-|-| | アレイ | 勤務表オブジェクトのアレイ。それぞれに次の属性が含まれています。 * 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_id (sys_user_group) の値のカンマ区切りリスト。 | [表 : 5. パラメーター] {#r_OCRotationV2-getRotasByGroup_String__table_jcg_xlb_h5} {#r_OCRotationV2-getRotasByGroup_String__table_kcg_xlb_h5__entry__2} | タイプ | 説明 | |-|-| | アレイ | 勤務表オブジェクトのアレイ。それぞれに次の属性が含まれています。 * 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} 指定された開始日から指定された終了日までのスパンを取得します。開始日と終了日が指定されていない場合、開始日のデフォルトは現在の時刻の 1 か月前、終了日のデフォルトは 1 か月後になります。グループ 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();