ChangeCollisionHelper - Global

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

    • The ChangeCollisionHelper script include provides helper methods found in the Change Management - Collision Detector (com.snc.change.collision) plugin.

    Use these methods in server side scripts, or when using Ajax calls on the client. You must have the Change Management - Collision Detector plugin installed to use these methods.

    ChangeCollisionHelper - addCiToChangeAffectedCis(String ci, String changeId)

    Adds the CI to the change's affected CI list.

    표 1. Parameters
    Name Type Description
    ci String The sys_id of the configuration item
    changeId String The change record's sys_id
    표 2. Returns
    Type Description
    void

    ChangeCollisionHelper - getAffectedCisByChangeId(String changeId)

    Returns the Affected CI sys_ids for the given change.

    표 3. Parameters
    Name Type Description
    changeId String A change record's sys_id
    표 4. Returns
    Type Description
    Array An array of sys_ids of affected CIs.

    ChangeCollisionHelper - getBlackoutsByDate(GlideDateTime startDate, GlideDateTime endDate)

    Returns any blackout that overlap the period defined by startDate and endDate.

    표 5. Parameters
    Name Type Description
    startDate GlideDateTime The beginning date
    endDate GlideDateTime The ending date
    표 6. Returns
    Type Description
    Array An array of blackouts (blackoutId:stringSpan).

    ChangeCollisionHelper - getChangesWithAffectedCi(String ci, GlideDateTime startDate, GlideDateTime endDate)

    Returns changes scheduled in the timespan (defined by startDate and endDate) that have the given CI in their Affected CIs list.

    표 7. Parameters
    Name Type Description
    ci String The configuration item's sys_id
    startDate GlideDateTime The beginning date
    endDate GlideDateTime The ending date of the time span
    표 8. Returns
    Type Description
    Array An array of change record's sys_ids

    ChangeCollisionHelper - getChangesWithCi(String ci, GlideDateTime startDate, GlideDateTime endDate)

    Returns the changes that are in the timespan (startDate, endDate) and that are linked to the given CI.

    표 9. Parameters
    Name Type Description
    ci String The configuration item's sys_id
    startDate GlideDateTime The beginning date
    endDate GlideDateTime The ending date of the time span
    표 10. Returns
    Type Description
    Array An array of sys_ids for change records

    ChangeCollisionHelper - getCiMaintenanceSchedule(String ci)

    Returns the Maintenance Schedule for a CI.

    표 11. Parameters
    Name Type Description
    ci String The configuration item's sys_id
    표 12. Returns
    Type Description
    void

    ChangeCollisionHelper - getDependants(String ci)

    Returns all the CIs that depend on the given CI.

    표 13. Parameters
    Name Type Description
    ci String A configuration item's sys_id
    표 14. Returns
    Type Description
    Array An array of CIs

    ChangeCollisionHelper - getDependencies(String ci)

    Returns all the CIs that the given CI depends on.

    표 15. Parameters
    Name Type Description
    ci String The configuration item's sys_id
    표 16. Returns
    Type Description
    Array An array of CIs

    ChangeCollisionHelper - isCiInAffectedCis(String ci, String changeId)

    Check if an CI is already in the change's affected CIs list.

    표 17. Parameters
    Name Type Description
    ci String The sys_id of the configuration item
    changeId String The change record's sys_id
    표 18. Returns
    Type Description
    Boolean True if the CI already is in the change's affected CI list.

    ChangeCollisionHelper - isDateInCiMaintenanceWindows( GlideDateTime startDate, GlideDateTime endDate, String maintenanceWindow)

    Checks if the time span defined by startDate and endDate falls in the CI's maintenance window.

    표 19. Parameters
    Name Type Description
    startDate GlideDateTime The beginning date
    endDate GlideDateTime The ending date
    maintenanceWindow String The configuration item's sys_id
    표 20. Returns
    Type Description
    Boolean True if the time span is in the CI's maintenance window