Create a CI type for Service Mapping

Every application in your organization must have a corresponding configuration item (CI) type which allows Service Mapping to discover and process this application correctly.

Before you begin

Role required: sm_admin

About this task

Service Mapping comes with a wide range of preconfigured CI types that cover most commonly used applications. If you organization uses a less known or proprietary application that does not have a corresponding CI type in Service Mapping, you must create it as described in this procedure.

A CI type is a generic notion that is used by several ServiceNow applications, but there are some attributes that are peculiar for Service Mapping.
Note: Some ServiceNow applications refer to CI types as CI classes.
A CI type (or class) contains several important definitions that apply to all CIs belonging to it:
  • CI attributes are added as fields to the CMDB tables.
  • There are special attributes (identifiers) that help Service Mapping to differentiate between new and existing CIs. For example, if there is an Apache Web Server CI type defined in CMDB, and Service Mapping discovers an Apache Web Server CI, it is processes it using identifiers and recognizes it as a updated version of the Apache Web Server CI that already exists in the system, not a new Apache Web Server CI.
  • There are reconciliation rules that help the ServiceNow platform to consolidate CI properties received from different applications correctly. These rules are necessary for organizations where discovery is performed by more than one application. Reconciliation rules define how properties of the same CI discovered by different discovery sources are brought together. For example, Service Mapping discovers the version and home directory attributes of an Apache Web Server CI, while Discovery discovers the version and patch level attributes for the same Apache Web Server CI. The ServiceNow platform applies the reconciliation rule and as a result Service Mapping does not overwrite the attributes found by Discovery.
  • Preconfigured CI types that come with the ServiceNow platform form a hierarchy where some CI types serve as parents to others who automatically receive their parent's attributes in addition to parameters you configure specifically for them. CI type hierarchy is used widely for configuring CI behavior, relationships, and display. Child CI types inherit their parents properties. In this example, the Apache Web Server CI is a child of the Web Server CI and inherits many attributes from its parent, such as name, version, model ID.


  1. Create a new CI type as described in Create a table using the following parameters:
    Table 1. New table form
    Field Description
    Label CI type name. For example, Apache Web Server.
    Name The table name. For example, cmdb_ci_apache_web_server.
    Extends table The table name of the parent CI type.
    The most commonly used parent CI types are:
    • cmdb_ci - basic
    • cmdb_ci_database - for databases
    • cmdb_ci_app_server - for application servers
    • cmdb_ci_infra_service - for infrastructure services
    • cmdb_ci_endpoint_inclusion - for endpoints of inclusion type
    • cmdb_ci_appl - for applications
    • cmdb_ci_web_server - for web servers
    • cmdb_ci_lb - for load balancers
    • cmdb_ci_endpoint - for entry points
  2. Perform the procedure in Create or edit a CI identification rule to configure how Service Mapping determines if a discovered CI is an upgraded CI already existing in the ServiceNow platform or a brand new CI.
    Warning: If there is no CI identification rule for a CI type, Service Mapping discovers CIs belonging to this type, but cannot interpret the results of the discovery process. In this case the ServiceNow platform rejects the discovery results for these CIs and their information is not updated.
    1. On the Identifiers page, configure the parameters as follows:
      Table 2. Identifier form
      Field Description
      Name Use a meaningful name.
      Applies to Enter the CI type.
      Active Select the check box.
      Independent Clear the check box.
    2. Configure the identifier entry parameters as follows:
      Table 3. Identifier entry form
      Field Description
      Criterion attributes Select Class.
      Allow null attribute Select the check box.
      Optional condition Set a condition if necessary
      Priority If there are more than one identifier entry, add priority to determine the order in which Service Mapping applies these entries. If none of the identification criteria matches the discovered CI, this CI is new.
  3. Perform the procedure in Create or edit a CI reconciliation rule to configure the ServiceNow platform so it can consolidate CI properties received from different applications correctly.
    Configure the following Service Mapping-related parameters correctly:
    Table 4. Reconciliation Definition form
    Field Description
    Data source Select ServiceWatch.
    Applies to Select the relevant CI type.
    Optional condition Set a condition if necessary
    Note: Make sure to configure reconciliation rules for all data sources.
  4. Perform the procedure in Create a containment rule to define the hierarchy for the new CI type. Clear the Reverse Relationship Direction check box while performing this configuration.

What to do next

Create an empty pattern