OCRotationV2 - グローバル

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

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

    OCRotationV2 - getGroups()

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

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

    OCRotationV2 - getRostersByRotas(文字列 rotaSysIds)

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

    表 : 3. パラメーター
    名前 タイプ 説明
    rotaSysIds 文字列 勤務表 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();