---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

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 スクリプトインクルードは、Fullcalendar.io および DHTMLX オンコールカレンダーで使用される OCRotation スクリプトインクルードの拡張です。

このスクリプトインクルードを使用して、グループ、勤務表、勤務表、およびユーザーによってさらにフィルタリングされた 2 つの日付間のスケジュールタイムスパンを取得します。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 | 文字列 | 勤務表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();