OCRotationV2 - グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • OCRotationV2 スクリプトインクルードは、Fullcalendar.io および DHTMLX オンコールカレンダーで使用される OCRotation スクリプトインクルードの拡張です。

    このスクリプトインクルードを使用して、グループ、勤務表、勤務表、およびユーザーによってさらにフィルタリングされた 2 つの日付間のスケジュールタイムスパンを取得します。OCRotationV2 を拡張して、動作を追加または変更することもできます。これはオンコールスケジューリングの一部です。

    OCRotationV2:getGroups()

    アクティブな勤務表を持つグループのアレイを返します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし
    表 : 2. 返される内容
    タイプ 説明
    アレイ グループオブジェクトのアレイ。それぞれに次の属性が含まれています。
    • sys_user_groupレコードのsys_id
    • sys_user_groupレコードの名前

    OCRotationV2 - getRostersByRotas(文字列 rotaSysIds)

    指定された勤務表 ID のアクティブな勤務表のアレイを返します。

    表 : 3. パラメーター
    名前 タイプ 説明
    rotaSysId 文字列 勤務表sys_id (cmn_rota) 値のカンマ区切りリスト。
    表 : 4. 返される内容
    タイプ 説明
    アレイ 勤務表オブジェクトのアレイ。それぞれに次の属性が含まれています。
    • cmn_rota_rosterレコードのsys_id
    • cmn_rota_rosterレコードの名前
    • cmn_rotaレコードの勤務表sys_id

    OCRotationV2:getRotasByGroup(文字列 groupSysIds)

    指定されたグループ ID のアクティブな勤務表のアレイを返します。

    表 : 5. パラメーター
    名前 タイプ 説明
    groupSysIds 文字列 グループsys_id (sys_user_group) 値のカンマ区切りリスト。
    表 : 6. 返される内容
    タイプ 説明
    アレイ 勤務表オブジェクトのアレイ。それぞれに次の属性が含まれています。
    • cmn_rotaレコードのsys_id
    • cmn_rotaレコードの名前
    • sys_user_groupレコードのグループsys_id

    OCRotationV2:getSpans()

    指定された開始日から指定された終了日までのスパンを取得します。開始日と終了日が指定されていない場合、開始日はデフォルトで 1 か月前、終了日はデフォルトで現在の時刻の 1 か月後に設定されます。グループ ID、勤務表 ID、勤務表 ID、ユーザー ID を使用して、スパンをさらにフィルタリングすることもできます。

    表 : 7. パラメーター
    名前 タイプ 説明
    なし
    表 : 8. 返される内容
    タイプ 説明
    アレイ スパンのアレイ。それぞれに、id、sys_id、table、rota_id、roster_id、user_id、text、description、color、textColor、start_date、end_date の属性が含まれています。
    デフォルト期間のすべてのスパンを取得
    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();