Quick start tests for Configuration Management Database (CMDB)

Release version: Zurich

Updated July 31, 2025

3 minutes to read

Summarize

Summarized using AI

Summary of Quick start tests for Configuration Management Database (CMDB)

These quick start tests help you validate the functionality of the Configuration Management Database (CMDB) after any configuration changes such as upgrades or application development. By running and customizing these tests with your instance-specific data, you ensure your CMDB remains operational and accurate.

Show full answer Show less

To use these tests, you must activate the Configuration Management (CMDB) plugin (com.snc.cmdb) and the CMDB - ATF Tests plugin (com.snc.cmdb.atf).

Test Suites and Their Purposes

CMDB BSM: Dependency Views – Tests Dependency Views APIs that retrieve maps and context menu items for CIs, ensuring you can visualize dependencies effectively (introduced in New York release).
CMDB HEALTH: CMDB Health Dashboard – Verifies basic functionality of the CMDB Health Dashboard, including health job statuses and completeness/recommended metrics, helping maintain CMDB data quality (New York release).
CMDB IRE: Identification Reconciliation Engine – Validates CI identifiers, reconciliation definitions, and rules for identification and reconciliation, enabling accurate CI identification and conflict resolution (Madrid and Paris releases).
CMDB QB: Query Builder – Checks the ability to create, read, and execute CMDB queries using roles such as cmdbquerybuilder and cmdbquerybuilderread, supporting efficient data retrieval (New York release).
CMDB REL: Relationship Editor and Formatter – Confirms the functionality to add/delete CI relationships and accurately display relationship information, essential for managing CI associations (New York release).
CMDB SDK: SDK REST API – Tests CMDB REST API operations including querying metadata, creating/updating/deleting CIs and relationships, ensuring integration and automation capabilities via APIs (New York release).

Practical Benefits

Enable quick verification of CMDB components after updates or customizations.
Ensure data integrity and operational reliability through targeted functional tests.
Support role-based access testing for query building and relationship management.
Validate REST API capabilities for programmatic CMDB management and integration.

Using these predefined test suites helps ServiceNow customers maintain a healthy, accurate, and fully functional CMDB, which is critical for IT service management and operational excellence.

Validate that Configuration Management Database (CMDB) still works after you make any configuration change such as apply an upgrade or develop an application. Copy and customize these quick start tests to pass when using your instance-specific data.

Configuration Management Database (CMDB) quick start tests require activating the Configuration Management (CMDB) plugin (com.snc.cmdb) and the CMDB - ATF Tests plugin (com.snc.cmdb.atf).

Table 1. CMDB BSM: Dependency Views test suiteTest suite to check functionality of Dependency Views APIs.
Test	Description	Release version
CMDB BSM: Dependency Views	Test functionality of Dependency Views APIs. These APIs retrieve Dependency Views map and associated map items such as context menu items, for a given CI sys_id and using itil user role.	New York

Table 2. CMDB HEALTH: CMDB Health Dashboard test suiteTest suite to check whether CMDB CMDB Health Dashboard is functional at a basic level.
Test	Description	Release version
CMDB HEALTH: Health Job Status	Checks whether any CMDB Health dashboard jobs, which were started 30 or more days ago, are still in progress.	New York
CMDB HEALTH: CMDB Health Completeness/ Recommended	Checks whether the recommended metric (included in the CMDB Health completeness KPI) is fully functional. This test validates: Creation of a health inclusion rule for the recommend metric. Creation of a recommended field that satisfies the health inclusion rule. Validate that the health inclusion rule is correctly applied to a test record with missing data in the recommended field.	New York

Table 3. CMDB IRE: Identification Reconciliation Engine test suiteTest suite to check Identification and Reconciliation Engine (IRE) functionality.
Test	Description	Release version
CMDB IRE: IRE Validation	Validate CI identifiers and reconciliation definitions and check indexes for CI identifiers.	Madrid
CMDB IRE: Reconciliation Rule	Check operations on a reconciliation rule, in CI Class Manager, using itil and itil_admin roles. Operations include create, edit, and delete a reconciliation rule. Also, check for active and not active setting, and derived rules.	Paris
CMDB IRE: Identification Rule	Check operations on an identification rule, in CI Class Manager, using itil and itil_admin roles. Operations include create, edit, and delete an identification rule. Also, check for active and not active setting, and derived rules.	Paris

Table 4. CMDB QB: Query Builder test suiteTest suite to verify CMDB Query Builder functions such as create query, read query, and execute query using two related user roles - cmdb_query_builder and cmdb_query_builder_read.
Test	Description	Release version
CMDB QB: Query Builder - cmdb_query_builder Role	Verify that cmdb_query_builder user role can save queries, and access and run all saved queries, in CMDB Query Builder.	New York
CMDB QB: Query Builder - cmdb_query_builder_read Role	Verify that cmdb_query_builder_read user role can access and run all saved queries, and cannot save any query, in CMDB Query Builder.	New York

Table 5. CMDB REL: Relationship Editor and Formatter test suiteTest suite to verify functionality of Relationship Editor and Relationship Formatter.
Test	Description	Release version
CMDB REL EDITOR:Relationship Editor	Check addition of relations to a CI and deletion of relations from a CI using itil user role.	New York
CMDB REL FORMATTER:Relationship Formatter	Check accuracy of CI information, relationship types, relationships, associated records such as change tickets, and settings such as CMDB views (relationship filters), displayed for a specific CI in relationship formatter using itil user role.	New York

Table 6. CMDB SDK: SDK REST API test suiteTest suite to verify functionality of CMDB SDK Rest APIs.
Test	Description	Release version
CMDB SDK: Query CMDB Metadata	Test querying CMDB metadata.	New York
CMDB SDK: Create a relation for a CI using REST APIs	Test creation of a relationship for a CI in the CMDB using the CMDB REST APIs.	New York
CMDB SDK: Delete a relation for a CI using REST APIs	Test deletion of a relationship for a CI using CMDB REST APIs.	New York
CMDB SDK: Create a CI using REST API	Test creation of a CI using CMDB REST APIs.	New York
CMDB SDK: Query CMDB using REST APIs	Test querying the CMDB using CMDB REST APIs.	New York
CMDB SDK: Update a CI using REST APIs	Test updating of a CI using CMDB REST APIs.	New York
CMDB SDK: Query for a CI using REST APIs	Test querying a CI using CMDB REST APIs.	New York