OCRotation - Global

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 9분

    • The OCRotation script include provides methods to build a data structure that is used to display a calendar.

    The code builds up the GlideAJAXSchedulePage object which stores a list of span items. You can use this type for the Gwt (legacy) calendar. See the OCRotationV2 - Global script include for other calender types. This is part of On-Call Scheduling.

    OCRotation - buildRotas()

    Builds the on-call coverage based on your groups, rotas, and rosters. This is used by the OCRotationV2 - getSpans method.

    표 1. Parameters
    Name Type Description
    None
    표 2. Returns
    Type Description
    Void

    OCRotation - getEndDate()

    Returns the end date for the time period for which you want to retrieve on-call coverage.

    표 3. Parameters
    Name Type Description
    None
    표 4. Returns
    Type Description
    String End date for the time period for which you want to retrieve on-call coverage.

    OCRotation - getGroupIds()

    Returns a comma separated list of group sys_id (sys_user_group) values for an on-call schedule.

    표 5. Parameters
    Name Type Description
    None
    표 6. Returns
    Type Description
    String Comma separated list of group sys_id (sys_user_group) values for an on-call schedule.

    OCRotation - getRosterIds()

    Returns the rosters according to the selected rotas.

    표 7. Parameters
    Name Type Description
    None
    표 8. Returns
    Type Description
    String Rosters according to the selected rotas.

    OCRotation - getRotaGr(String rotaIds, String groupIds, String rosterIds, String userIds)

    Returns a GlideRecord for the cmn_rota table filtered by groups, rota, users, and roster.

    표 9. Parameters
    Name Type Description
    rotaIds String Comma separated list of rota sys_id (cmn_rota) values for an on-call schedule.
    groupIds String Comma separated list of group sys_id (sys_user_group) values for an on-call schedule.
    rosterIds String Comma separated list of roster sys_id (cmn_rota_roster) values for an on-call schedule.
    userIds String Comma separated list of user sys_id (sys_user) values for an on-call schedule.
    표 10. Returns
    Type Description
    GlideRecord A GlideRecord for the cmn_rota table filtered by groups, rota, users, and roster.

    OCRotation - getRotaIds()

    Returns the rotas for the groups on your calendar.

    표 11. Parameters
    Name Type Description
    None
    표 12. Returns
    Type Description
    String Rotas for the groups on your calendar.

    OCRotation - getStartDate()

    Returns the start date for the time period for which you want to retrieve on-call coverage.

    표 13. Parameters
    Name Type Description
    None
    표 14. Returns
    Type Description
    String Start date for the time period for which you want to retrieve on-call coverage.

    OCRotation - getTimezone()

    Returns the timezone that your on-call calendar will use.

    표 15. Parameters
    Name Type Description
    None
    표 16. Returns
    Type Description
    String Timezone that your on-call calendar will use. For example, Europe/Madrid and US/Pacific.

    OCRotation - getUserIDs()

    This will filter the schedules return by users. Get comma separated list of user sys_id (sys_user) values used to filter on-call schedules.

    표 17. Parameters
    Name Type Description
    None
    표 18. Returns
    Type Description
    String Comma separated list of user sys_id (sys_user) values used to filter on-call schedules.

    OCRotation - setEndDate(String endDate, Boolean inclusive)

    Set the end date for the time period for which you want to retrieve on-call coverage. If the end date is not set, then the last day of the next month is applied by default. Use in conjunction with OCRotationV2 - getSpans.

    표 19. Parameters
    Name Type Description
    endDate String [Optional] End date of the on-call schedule.
    inclusive Boolean [Optional] When true, the end date is included in the time span. If not specified, this value defaults to true.
    표 20. Returns
    Type Description
    Void

    OCRotation - setGroupIds(String groupIds)

    Filters the schedules return by groups. Set comma separated list of group sys_id (sys_user_group) values for an on-call schedule. Use in conjunction with OCRotationV2 - getSpans.

    표 21. Parameters
    Name Type Description
    groupIds String Comma separated list of group sys_id (sys_user_group) values for an on-call schedule.
    표 22. Returns
    Type Description
    Void

    OCRotation - setRosterIds(String rosterIds)

    Sets the rosters according to the selected rotas. Use in conjunction with OCRotationV2 - getSpans.

    표 23. Parameters
    Name Type Description
    RosterIds String Rosters according to the selected rotas.
    표 24. Returns
    Type Description
    void

    OCRotation - setRotaIds(String rotaIds)

    Sets the rotas for the groups on your calendar. Use in conjunction with OCRotationV2 - getSpans.

    표 25. Parameters
    Name Type Description
    RotaIds String Rotas for the groups on your calendar.
    표 26. Returns
    Type Description
    Void

    OCRotation - setStartDate(String startDate)

    Sets the start date for the time period for which you want to retrieve on-call coverage. If the start date is not set, then the first day of the previous month is applied by default. Use in conjunction with OCRotationV2 - getSpans.

    표 27. Parameters
    Name Type Description
    startDate String [Optional] Start date for the time period for which you want to retrieve on-call coverage.
    표 28. Returns
    Type Description
    void

    OCRotation - setTimezone(String timezone)

    Sets the timezone that your on-call calendar will use. Use in conjunction with OCRotationV2 - getSpans.

    표 29. Parameters
    Name Type Description
    Timezone String Timezone that your on-call calendar will use. For example, Europe/Madrid and US/Pacific.
    표 30. Returns
    Type Description
    Void

    OCRotation - setUserIds(String userIds)

    Sets comma separated list of user sys_id (sys_user) values used to filter on-call schedules. Use in conjunction with OCRotationV2 - getSpans.

    표 31. Parameters
    Name Type Description
    UserIds String Comma separated list of user sys_id (sys_user) values used to filter on-call schedules.
    표 32. Returns
    Type Description
    Void