Principal Class
Summarize
Summary of Principal Class
A Principal Class in ServiceNow CMDB identifies the most critical Configuration Item (CI) classes essential for foundational data health and governance. These classes are prioritized for tracking, health monitoring, certification, lifecycle management, and focused class list views. Designating Principal Classes helps organizations concentrate CMDB operations on CIs that significantly impact day-to-day IT operations and business services.
Show less
Principal Classes are crucial for operational processes such as change, incident, problem, and quality management, representing key infrastructure components with meaningful service impact. This designation applies only to the current class and is not inherited by child classes.
Managing Principal Classes
The Principal Class filter is used to manage and prioritize these classes within your organization. You add or remove classes from this filter to reflect which CIs should be designated as principal. In out-of-the-box instances, this filter starts empty and requires configuration based on your environment’s needs.
Guidelines for Designation
- Stability and Business Impact: Choose stable, well-understood classes with direct business operational impact.
- Core Infrastructure Priority: Select classes representing the backbone of your IT environment.
- Stakeholder Consultation: Engage infrastructure, application, and security teams to validate selections.
- Regular Review: Periodically reassess principal classes to maintain relevance as your IT environment evolves.
Practical Uses Across the CMDB
- CI Lists and Dashboards: Filters restrict views to principal classes, enabling focused monitoring.
- Service Graph and CMDB Workspace: Principal Class filters can be applied in Discovery sources and CMDB 360 dashboards to enhance visibility.
- CMDB Success Advisor: Uses principal classes to generate prioritized recommendations and KPIs for foundational data health.
- Hardware Asset Management Integration: HAM-related model categories are marked as principal classes for aligned tracking.
- Now Assist for CMDB: Provides suggestions and automation for consistent principal class setup across environments.
Task Types and Filtering
The system property com.snc.task.principalclassfilter defines which task types (default includes incident, problem, and change tasks) apply principal class filtering on the cmdbci field. This ensures that CI lookups in these tasks show only CIs belonging to principal classes, reducing noise and improving data relevance during incident, problem, and change management.
Maintaining the Principal Class Filter
Regularly update the Principal Class filter to ensure it reflects the most critical CIs for your organization’s operational focus. This management enables prioritized tracking, certification, lifecycle management, and clearer class list views aligned to business priorities.
A Principal Class is a designation for those CMDB classes that are most critical for foundational data health and governance in the organization. Those classes are then prioritized for tracking, health, certification, lifecycle management, and class list views.
Designating certain CMDB classes as principal classes is a strategic way to focus your CMDB and governance on the CIs that matter most to day-to-day operations. Principal classes identify the classes that are in scope for operational processes—such as change, incident, problem, and quality management. Those classes represent the most critical infrastructure components with meaningful service impact. Limiting some CMDB functions to this set of most essential classes can help organizations improve data quality and ownership, reduce noise in reporting and impact analysis, and more consistently measure health, compliance, and operational risk where it counts.
The Principal Class setting applies only to the current class and is not derived by child classes. For details about the CMDB class hierarchy, see CMDB schema model.
Principal Class filter
To manage Principal Classes in your organization, add those classes that are designated as Principal Class to the Principal Class filter. You can then manage the list by adding or deleting classes from the Principal Class filter as needed. In a base system, the Principal Class filter doesn't contain any classes. For more information, see Update the list of classes in the Principal Class filter.
General guidelines for designating a class as principal
- Consider stability and business impact: Choose those classes that are stable, well-understood, and have a direct impact on business operations.
- Prioritize core infrastructure: When in doubt, select those classes that represent the backbone of your IT environment.
- Consult stakeholders: Engage with infrastructure, application, and security teams to validate your selections.
- Review regularly: As your environment evolves, periodically review and update principal classes to ensure continued relevance.
For more information, see the Guidance on designating principal classes in the CMDB [KB2707240] article in the Now Support Knowledge Base.
Uses of the Principal Class filter across the CMDB
- In CI lists and dashboards: The Principal Class filter restricts CIs to only those in the filter, so you can focus on those CIs that require attention. For more information about list view filters, see Save and use filters in a list view.
- Service Graph Workspace and CMDB Workspace: You can apply the Principal Class filter in the Discovery sources card in the CMDB 360 dashboard. For more information, see CMDB 360 experience in CMDB Workspace and in Service Graph Workspace.
- CMDB success advisor: CMDB success advisor dashboards rely on principal classes to generate recommendations and KPIs. You can set principal classes in CMDB success advisor for Data Foundations to track the foundational data health of your CMDB. This alignment ensures that insights reflect actual business priorities. For more information, see CMDB success advisor.
- HAM (Hardware Asset Management) integration: When model categories are added to the CMDB success advisor for HAM, they are marked as principal classes if they weren't already and will appear in the CMDB success advisor for Data Foundations if already set up. For more information, see Using CMDB success advisor for HAM, Hardware Asset Management , and CMDB CI Class Models app.
- Principal CI class agent in Now Assist for CMDB: This agent suggests classes to be set as principal classes, and then automates setup for consistency across environments. For more information, see Getting advice from Now Assist on CMDB governance.
Task types for Principal Class
The com.snc.task.principal_class_filter system property is a comma-separated list of task types. The system applies principal class filtering only on the cmdb_ci field of CIs that belong to a class of a specified type. The default value for this property is "incident, incident_task, problem, problem_task, change_request, change_task".
After you designate a CI class as a principal class in the CMDB Class Information [cmdb_class_info] table, you can use the com.snc.task.principal_class_filter system property to specify which task types use principal class filtering on a CI cmdb_ci field. When you create or update those task types, the CI lookup field shows only CIs that belong to principal classes.
.