CIUtils - Global

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).

Tableau 1. Parameters

Name	Type	Description
CI_sys_id	String	The sys_id of a configuration item (cmdb_ci) to check.

Tableau 2. Returns

Type	Description
Array	An array of sys_id values for cmdb_ci records downstream of (or affected by) the specified item.

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.

Tableau 3. Parameters

Name	Type	Description
task	GlideRecord	Task GlideRecord, for example incident, change_request, or problem.

Tableau 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.

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