Create CI types for Service Mapping and Discovery

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 7 min. de leitura

    • Create CI types (or CI classes) for applications and devices, which Service Mapping and Discovery do not support by default.

    Antes de Iniciar

    Role required: service_mapping_admin, personalize_dictionary, or admin

    Verify that there is no existing CI type for this application or device.

    Por Que e Quando Desempenhar Esta Tarefa

    All applications and hosts in your organization must have a corresponding configuration item (CI) type, which is necessary for discovering and processing applications and hosts correctly.
    Nota:
    The Discovery and the CMDB interface refers to CI types as CI classes.

    A wide range of preconfigured CI types that cover most commonly used applications are available to you. If your organization uses a less known or proprietary application that does not have a corresponding CI type, you must create it.

    A CI type is a generic notion that is used by several ServiceNow applications, but there are some attributes that are specific to Service Mapping and Discovery.

    A CI type (or class) contains several important definitions that apply to all CIs belonging to it, such as:
    • CI attributes are added as fields to the CMDB tables.
    • Identifiers help Service Mapping and Discovery to differentiate between new and existing CIs. For example, if there is an Apache Web Server CI type defined in the CMDB, and Service Mapping and Discovery both discover an Apache Web Server CI, it processes it using identifiers. It then recognizes it as an 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 attributes received from different applications correctly. These rules are necessary for organizations where more than one application participates in the discovery process. Reconciliation rules define how attributes of the same CI discovered by different discovery sources are merged. 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 AI Platform applies the reconciliation rule and as a result Service Mapping does not overwrite the attributes found by Discovery.
    • Related items, both CIs and non-CIs, serve as a reference and provide additional information about the CI. For example, you can define a serial number, a port and an network APR table as related items for a hardware server. The system does not use these items for identification. After you configure related items for the CI type, you can use horizontal discovery for CIs of this type together with their related items. For information, see Discover related items together with the main CI.
      Nota:
      Non-CIs are items that do not extend the Configuration Item [cmdb_ci] table. Examples of non-CIs are ports, serial numbers, or Network ARP tables.
    • CMDB stores CI class in the form of a hierarchy where some CI classes are parents to other CI classes, who automatically derive their parent's attributes in addition to attributes you configure specifically for child CI classes. CI class hierarchy is used widely for configuring CI behavior, relationships, and display. In this example, the Apache Web Server CI is a child of the Web Server CI and derives many attributes from its parent, such as name, version, model ID. By default, child CI classes inherit identifiers from their parent CI classes.

    In addition to these CI type definitions, the horizontal discovery process uses a CI classification to define to which CI type a CI belongs. Create a device CI classification if you create a CI type for devices using SNMP and a process CI classification for an application CI type.

    Procedimento

    1. Navigate to All > Configuration > CI Class Manager.
    2. To use an existing CI type as a parent for the new CI type, click Hierarchy to display the CI Classes list.
    3. Click the context menu for the required CI type and select Add Child Class.
    4. to store the CI type attributes:
      Tabela 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.

      Use a name similar to the other CMDB classes (for example, u_cmdb_ci_laptop).
      Extends table The table name of the parent CI type.

      All CI types are extensions of the Configuration Item [cmdb_ci] table or its child tables. For example, if the new class is Laptops, which is a subclass of Computers, select the cmdb_ci_computer table. If the new class is a top-level class, select the cmdb_ci table.

      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 entry points of the 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
    5. Configure how the instance determines if a discovered CI is an upgraded CI existing in the instance or a brand new CI.
      See Create or edit a CI identification rule for detailed procedure.
      Aviso:
      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 AI Platform rejects the discovery results for these CIs and their information is not updated.
      1. On the Identifiers page, configure the parameters as follows:
        Tabela 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:
        Tabela 3. Identifier entry form
        Field Description
        Criterion attributes Select the attribute that you want to use for identifying the CI. For example, Class, Installation directory, or Serial number.
        Allow null attribute Select the check box.
        Priority If there is 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.
    6. Opcional: Configure references to other CIs or non-CIs as related items for the CI type.
      Tabela 4. Related Entry form
      Field Description
      Active Check box that specifies that the related entry is active.
      Related table A related table that references the CI that is being matched.
      Referenced field A referenced field in Related table that should store the referenced CI. This field always references the cmdb_ci table, or a descendent of the cmdb_ci table.
      Priority Priority of the related entry for the specified Related table. Rules with lower priority numbers are given higher priority while matching a related item for specific related table. Related entries for the specified related table with identical priorities are applied randomly.

      You can keep gaps between the priority numbers, so you can assign the unused priority numbers to new entries without modifying the existing priority order.
      Criterion attributes The set of attributes to uniquely identify the related item. Attributes can belong to the current class, or to a parent class.
      Nota:
      It is possible to add reference fields as a criterion attribute. However, such fields might not always be effective:
      • Reference fields store sys_ids that point to a record in another table, and thus is considered a weak criterion attribute (in terms of uniqueness) for the current table.
      • The system detects and then replaces invalid values in a reference field with 'Unknown'. For example, an invalid Model ID value is replaced with the value 'Unknown'. Also, if several CIs end up having that same reference field set to 'Unknown', then these CIs become duplicate CIs.

      Select the lock icon to view, add, or remove attributes from the identification rule.
      Allow null attribute If at least one criterion attribute in the related table is not null, allow to attempt matching with an identifier entry even if there are criterion attributes which are null.
      Filter conditions Add conditions to construct a filter to narrow the set of records that will be searched for a matching related item.
    7. Opcional: Configure the instance to consolidate CI attributes received from different data sources correctly.
      See Create or edit a CI reconciliation rule.

      Configure the following Service Mapping related parameters correctly:

      Tabela 5. Reconciliation Definition form
      Field Description
      Data source Select ServiceWatch.
      Applies to Select the relevant CI type.
      Optional condition Set a condition if necessary.
      Nota:
      If you do not create a CI reconciliation rule, data discovered by patterns is used to update CI attributes.
    8. Configure the CI classification for your CI type:
      Nota:
      There is no need to create CI classifications for hosts because these classifications are included in the base system.
    9. For CI types that represent inclusions, define the hierarchy for the new CI type.

      Clear the Reverse Relationship Direction check box while performing this configuration.

      See Create dependent relationships.
    10. If necessary, customize icons that represent CIs in maps.
      See Create or modify map icons.