This documentation supports the 21.02 version of BMC Helix CMDB.

To view an earlier version, select the version from the Product version menu.

Associating a CI to an incident

By automatic assignment of a Configuration Item (CI) to an incident, an organisation can manage IT infrastructure incidents better while saving time and effort. This use case describes how to associate a CI related to an incident. An organisation can automate the management of IT infrastructure incidents while saving time and effort that goes into manually searching and assigning CI to an incident. 

Scenario for associating a CI to an incident


The Calbro Services company needs to automatically identify and assign a CI to an incident.

Consider a scenario where one of the servers in the IT infrastructure is not responding. This outage impacts the Payroll application and slows down the consumer banking service. Before users begin calling in to report a problem, the server failure must be discovered, communicated to the service desk, diagnosed, and resolved.

BMC Helix Integration Service creates an incident with CI lookup and passes it to BMC Helix ITSM. BMC Helix ITSM then passes these queries as a CMDB REST API to CMDB. If the query is complex, the predefined complex queries that are mapped to various classes by default in the CMDB Class Query Mapping are used by the REST API to perform the search for the CI. The CI that is returned from this search is assigned to the incident.

The Class Query Mapping in BMC Helix CMDB maps complex queries to classes so that when a complex search REST API is requested, it can use these mapped queries to conduct a search within that class.

Workflow for associating a CI to an incident

  1. A monitoring tool through integration sends an incident with CI lookup to BMC Helix ITSM.
    For BMC Helix ITSM to be able to access to CMDB, you must first perform the procedure as described in Providing ITSM with access to CMDB.
  2. If it is a simple lookup, BMC Helix ITSM sends it to CMDB and finds the CI.
  3. BMC Helix ITSM returns the incident along with that CI.
  4. If an exact match for the CI is not found in CMDB, a complex search is performed.
  5. CMDB REST API performs the complex lookup using the default class queries mapping in CMDB, and returns a CI.
  6. BMC Helix ITSM associates the CI with the incident.

Benefits of associating a CI to an incident

Whenever an event within an organization results in the creation of an incident, BMC Helix ITSM automatically associates a CI with the incident.  Using this information, an incident manager can know the CI that could be the probable cause of the incident. As a result of this, time and effort is saved in manually searching the CI that is associated with the incident. This can help an organization to resolve an incident faster. 

Related topics

Mapping complex queries to a class

Use case: Automatic incident management Open link

Setting up Proactive Service Resolution to enable automatic incident management Open link

Providing ITSM with access to CMDB

Was this page helpful? Yes No Submitting... Thank you