The CIUtils script include is a utility class that provides methods for working with configuration items (CI).

By default, when traversing CI relationships the system uses a max depth of 10. You can override this value by modifying the glide.relationship.max_depth property.

The maximum number of items returns is 1000. You can override this value by modifying the glide.relationship.threshold property.

The CIUtils class is available to server-side scripts.

CIUtils - servicesAffectedByCI(String CI_sys_id)

Determines which business services are affected by the specific configuration item (CI).

Table 1. Parameters
Name Type Description
CI_sys_id String The sys_id of a configuration item (cmdb_ci) to check.
Table 2. Returns
Type Description
Array An array of sys_id values for cmdb_ci records downstream of (or affected by) the specified item.

Example

This example displays the names of the services affected by the CI items with the name = lnux100.

var CIUtil = new CIUtils();
 
//get a server record
var server = new GlideRecord("cmdb_ci_server");
server.addQuery("name", "lnux100");
server.query();
if (server.next()) {
  //get the affected services, array of ids
  var serviceIds = CIUtil.servicesAffectedByCI(server.getUniqueValue());
  for (var i=0; i < serviceIds.length; i++) {
    //get the service record
    var service = new GlideRecord("cmdb_ci_service");
    service.get(serviceIds[i]);
    gs.print(service.getDisplayValue());
  }
}
Output: 
Client Services
IT Services
Bond Trading

CIUtils - servicesAffectedByTask(GlideRecord task)

Determines which business services are affected by the specified task.

Table 3. Parameters
Name Type Description
task GlideRecord Task GlideRecord, for example incident, change_request, or problem.
Table 4. Returns
Type Description
Array List of sys_id values for CIs downstream of (or affected by) the configuration item referenced by the task's cmdb_ci field.

Example

This example displays the names of the services affected by the incident INC00050.

var CIUtil = new CIUtils();
 
//get an incident record
var inc = new GlideRecord("incident");
inc.addQuery("number", "INC00050");
inc.query();
if (inc.next()) {
  //get the affected services, array of ids
  var serviceIds = CIUtil.servicesAffectedByTask(inc);
  for (var i=0; i < serviceIds.length; i++) {
    //get the service record
    var service = new GlideRecord("cmdb_ci_service");
    service.get(serviceIds[i]);
    gs.print(service.getDisplayValue());
  }
}
Output: 
IT Services
Email
Windows Mobile
Electronic Messaging
Outlook Web Access (OWA)
Blackberry