<h2>CI relations formatter</h2><br/><div style="overflow-x:auto"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><meta content="text/html; charset=UTF-8" /><meta name="copyright" content="(C) Copyright 2024" /><meta name="DC.rights.owner" content="(C) Copyright 2024" /><meta name="generator" content="DITA-OT" /><meta name="DC.type" content="concept" /><meta name="DC.title" content="CI relations formatter" /><meta name="abstract" content="The default CI form includes a CI relations formatter from which you can examine a CI and its relationships in various views. From the CI relations formatter, you can also launch the CI relationship editor for the CI." /><meta name="description" content="The default CI form includes a CI relations formatter from which you can examine a CI and its relationships in various views. From the CI relations formatter, you can also launch the CI relationship editor for the CI." /><meta name="DC.subject" content="NG CI relations formatter" /><meta name="keywords" content="NG CI relations formatter" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/concept/c_CIRelationships.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/general/reference/r_ServiceNowPlatform.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/concept/c_ITILConfigurationManagement.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/reference/r_SuggestedRelationshipModel.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/task/t_AddANewSuggestedRelationship.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/concept/relationship-governance.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/concept/c_RelationshipEditor.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/concept/c_RelationQualifier.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/concept/c_CIRelationshipSecurity.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/task/t_CreateACIRelationRollup.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/concept/domain-separation-relationship-formatter-editor.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/task/t_CreateRelationshipFilter.html" /><meta name="DC.relation" scheme="URI" content="../../../product/configuration-management/task/exclude-relationship.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/form-administration/reference/r_LegacyCIRelationsFormatter.html" /><meta name="DC.relation" scheme="URI" content="../administer/form-administration/task/t_CreateAFormatter.dita/t_CreateAFormatter.html" /><meta name="DC.relation" scheme="URI" content="../task/t_CreateRelationshipFilter.html" /><meta name="DC.creator" content="ServiceNow" /><meta name="DC.date.created" content="2022-08-04" /><meta name="DC.date.modified" content="2022-08-04" /><meta name="DC.format" content="XHTML" /><meta name="DC.identifier" content="c_CIRelationsFormatterNG" /><link rel="stylesheet" type="text/css" href="../../../CSS/commonltr.css" /><title>CI relations formatter</title></head><body id="c_CIRelationsFormatterNG"> <div class="breadcrumb"><a class="link" href="../../../administer/general/reference/r_ServiceNowPlatform.html" title="Digitize your workflows and run them at scale by using the core capabilities of the Now Platform. When you activate and configure these features, you can create custom business logic, manage and secure data, and build alternate user interfaces.">Now Platform capabilities</a> > <a class="link" href="../../../product/configuration-management/concept/c_ITILConfigurationManagement.html" title="With the ServiceNow Configuration Management Database (CMDB) application, build logical representations of assets, services, and the relationships between them that comprise the infrastructure of your organization. Details about these components are stored in the CMDB which you can use to monitor the infrastructure, helping ensure integrity, stability, and continuous service operation.">Configuration Management Database (CMDB)</a> > </div> <h1 class="title topictitle1" id="ariaid-title1">CI relations formatter</h1> <div class="body conbody"><p class="shortdesc">The default CI form includes a CI relations formatter from which you can examine a CI and its relationships in various views. From the CI relations formatter, you can also launch the CI relationship editor for the CI.</p> <p class="p">If the domain separation plugin is activated, then only relationships in which the logged on user is authorized to view both CIs, are displayed.</p> <p class="p">The CI relations formatter contains a list of related CIs and a toolbar with controls for viewing the relationships between the current CI and related CIs. You can configure the controls in this formatter to modify varying aspects of the view. For more information about formatters, see <a class="xref" href="../administer/form-administration/task/t_CreateAFormatter.dita/t_CreateAFormatter.html" target="_blank" rel="noopener noreferrer">Create a formatter and add it to the form</a>.</p> <div class="note"><span class="notetitle">Note:</span> <ul class="ul" id="c_CIRelationsFormatterNG__ul_llg_bz2_31b"><li class="li">If an endpoint is a child in one relationship and the same endpoint is a parent in another relationship, then that endpoint is hidden and does not appear in the relations formatter view. Similarly, relationship qualifier chains are also hidden and do not appear in the relationship formatter view.<ul class="ul" id="c_CIRelationsFormatterNG__ul_nxh_kqc_qdb"><li class="li">Example: CI1 > endpoint > CI2 <p class="p">In this example, CI1 is related to CI2 through relationships with endpoint. A single relationship appears in the relations formatter:</p> <p class="p">CI1 > CI2 (These relationships appear as a direct relationship without endpoint, because endpoint is a parent in one relationship and a child in another relationship)</p> </li><li class="li">Example: CI1 > endpoint1 > CI2 > endpoint2<p class="p">Two relationships appear in the relations formatter:</p> <p class="p">CI1 > CI2 (endpoint1 is hidden because it is a parent in one relationship and a child in another relationship)</p> <p class="p">CI1 > CI2 > endpoint2 (appears as level 2 relationship – endpoint1 is hidden and endpoint2 appears as it a child and not a parent in any other relationship)</p> </li></ul> </li><li class="li">On instances that do not meet the internet browser requirements for the CI relations formatter, the default CI form includes the legacy CI relations formatter instead. For more information, see <a class="xref" href="../../../administer/form-administration/reference/r_LegacyCIRelationsFormatter.html" title="On instances that do not meet the internet browser requirements for the latest CI relations formatter, the default CI form includes the legacy CI relations formatter instead.">Legacy CI relations formatter</a>.</li><li class="li">CIs not extended from the Configuration Item [cmdb_ci] table, are not displayed in Dependency Views maps and in CI relation formatters.</li><li class="li">The <span class="keyword parmname">Applicative Flow To::Application Flow From</span> relationship is a special relationship type used only between Service Mapping endpoints. This relationship type is not intended for use in the CMDB as a relationship between CIs and therefore it is not displayed in the relations formatter.</li></ul> </div> <div class="p"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="c_CIRelationsFormatterNG__table_v4g_n21_1s" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 1. </span>Controls for viewing related CIs</span></caption><colgroup><col /><col /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry nocellnorowborder" style="vertical-align:top;" id="d130086e113">Control</th><th class="entry cell-norowborder" style="vertical-align:top;" id="d130086e116">Definition</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry nocellnorowborder" style="vertical-align:top;" headers="d130086e113 "><img class="image icon" id="c_CIRelationsFormatterNG__image_mff_t5k_nt" src="../image/FormatterAddCIRelationship.png" alt="Add CI relationship icon" /> <p class="p">Add CI relationship</p> </td><td class="entry cell-norowborder" style="vertical-align:top;" headers="d130086e116 ">Starts the relationship editor to manually create CI relationships. For more information, see <a class="xref" href="../task/t_CreateCIRelationship.html" title="Use the relationship editor to view, create, or modify CI relationships. You can open the relationship editor from the CI Relations formatter.">Create or edit a CI relationship</a>.</td></tr><tr class="row"><td class="entry nocellnorowborder" style="vertical-align:top;" headers="d130086e113 "><img class="image icon" id="c_CIRelationsFormatterNG__image_ilh_55k_nt" src="../image/FormatterShowBSMView.png" alt="Show dependency views icon" /> <p class="p">Show dependency views</p> </td><td class="entry cell-norowborder" style="vertical-align:top;" headers="d130086e116 ">Launches a Dependency Views map in another window or tab. The CI is the central node in the map, with a configurable number of levels above and below that node in the hierarchy. Map indicators next to the nodes indicate the number of tasks, incidents, problems, changes, or outages related to that node. Right-click to expand collapsed nodes or display a list of related tasks or problems. For more information, see <a class="xref" href="../../business-service-management-map-ng/concept/c_NextGenBSMMaps.html" title="ServiceNow Dependency Views maps graphically display CIs that support application or business services and the relationships between the CIs.">Dependency Views map</a>.</td></tr><tr class="row"><td class="entry row-nocellborder" style="vertical-align:top;" headers="d130086e113 ">Search for CI</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e116 ">Filters the CIs included in the display.</td></tr></tbody></table> </div> </div> <p class="p">Click the <span class="ph uicontrol">Settings</span> (<img class="image" id="c_CIRelationsFormatterNG__image_jyf_x5k_nt" src="../image/FormatterSettings.png" alt="Settings." />) icon to configure additional view settings that filter the data displayed. Settings are preserved through logging out and logging back in.</p> <div class="p"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="c_CIRelationsFormatterNG__table_zsl_qw4_ms" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 2. </span>Related items settings</span></caption><colgroup><col /><col /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry nocellnorowborder" style="vertical-align:top;" id="d130086e213">Setting</th><th class="entry cell-norowborder" style="vertical-align:top;" id="d130086e216">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry nocellnorowborder" style="vertical-align:top;" headers="d130086e213 ">Show Relations in Flat/Tree Layout</td><td class="entry cell-norowborder" style="vertical-align:top;" headers="d130086e216 "><p class="p">To view a flat list of related CIs that are grouped by relationship type in alphabetical order, click <span class="ph uicontrol">Flat</span> (default value).</p> <p class="p">To view groups of related CIs in a hierarchical tree, click<span class="ph uicontrol">Tree</span>. If you select the tree view, you cannot configure any other settings for viewing related CIs. A single list of upstream and downstream relationships is displayed.</p> </td></tr><tr class="row"><td class="entry nocellnorowborder" style="vertical-align:top;" headers="d130086e213 ">Show Relations in Split/Merge Layout</td><td class="entry cell-norowborder" style="vertical-align:top;" headers="d130086e216 "><p class="p">To view a single list that includes both upstream and downstream relationships, click <span class="ph uicontrol">Merge</span> (default value). Relationships are grouped by relationship type.</p> <p class="p">To view separate lists for upstream and downstream relationships, click <span class="ph uicontrol">Split</span>.</p> </td></tr><tr class="row"><td class="entry nocellnorowborder" style="vertical-align:top;" headers="d130086e213 ">Filter Relations by Max Level</td><td class="entry cell-norowborder" style="vertical-align:top;" headers="d130086e216 "><p class="p">Select the number of downstream and upstream levels in the hierarchy to include when displaying CIs in a flat view.</p> <p class="p">Default value is 3.</p> </td></tr><tr class="row"><td class="entry nocellnorowborder" style="vertical-align:top;" headers="d130086e213 ">Filter Relations by Relationship Type</td><td class="entry cell-norowborder" style="vertical-align:top;" headers="d130086e216 "><p class="p">Select the types of relationships to view.</p> <p class="p">Default value is 'All Relationship Types'.</p> </td></tr><tr class="row"><td class="entry row-nocellborder" style="vertical-align:top;" headers="d130086e213 ">Filter Relations by CMDB View</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e216 ">Filter by tables specified in CMDB views, if any relationship filters exist.</td></tr></tbody></table> </div> </div> <div class="p">The relations formatter uses the following icons to provide additional information about changes, problems, and outages related to CIs in the relationship: <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="c_CIRelationsFormatterNG__table_kvd_g22_ss" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 3. </span>Icons related to CIs</span></caption><colgroup><col /><col /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d130086e316">Icon</th><th class="entry cellrowborder" style="vertical-align:top;" id="d130086e319">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e316 "><img class="image icon" id="c_CIRelationsFormatterNG__image_o1p_s32_ss" src="../image/FormatterRelationshipClosedChange.png" alt="Recently closed changes icon" /></td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e319 ">Recently closed changes</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e316 "><img class="image icon" id="c_CIRelationsFormatterNG__image_uwy_s32_ss" src="../image/FormatterRelationshipClosedChange.png" alt="Planned changes icon" /></td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e319 ">Planned changes</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e316 "><img class="image icon" id="c_CIRelationsFormatterNG__image_hzp_t32_ss" src="../image/FormatterRelationshipOpenChange.png" alt="Currently open changes icon" /></td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e319 ">Currently open changes</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e316 "><img class="image icon" id="c_CIRelationsFormatterNG__image_pnh_w32_ss" src="../image/FormatterRelationshipClosedOutage.png" alt="Recently closed outages icon" /></td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e319 ">Recently closed outages</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e316 "><img class="image icon" id="c_CIRelationsFormatterNG__image_dtx_x32_ss" src="../image/FormatterRelationshipProblem.png" alt="Problems icon" /></td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e319 ">Problems</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e316 "><img class="image icon" id="c_CIRelationsFormatterNG__image_ph3_z32_ss" src="../image/FormatterRelationshipIncident.png" alt="Incidents icon" /></td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e319 ">Incidents</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e316 "><img class="image icon" id="c_CIRelationsFormatterNG__image_alj_bj2_ss" src="../image/FormatterRelationshipPlannedOutage.png" alt="Planned outages icon" /></td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e319 ">Planned outages</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e316 "><img class="image icon" id="c_CIRelationsFormatterNG__image_x1g_cj2_ss" src="../image/FormatterRelationshipOpenOutage.png" alt="Currently open outages icon" /></td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e319 ">Currently open outages</td></tr></tbody></table> </div> </div> <p class="p">In large networks, a list of related CIs might be excessively long, which can slow performance when a CI form is rendered. You can configure these properties to control the amount of data that is displayed. To find a property, enter sys_properties.list in the left navigation filter and search for the property.</p> <div class="p"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="c_CIRelationsFormatterNG__table_z34_syd_5s" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 4. </span>Properties related to performance</span></caption><colgroup><col /><col /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d130086e456">Property</th><th class="entry cellrowborder" style="vertical-align:top;" id="d130086e459">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e456 ">glide.ecmdb.find_relationship_issues</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e459 ">Hides or displays an icon in the CI relations formatter that links to open issues for the CI. This property defaults to true (displays the icon).</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e456 ">glide.ui.max_relation_levels</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e459 ">Specifies the maximum level for displaying CIs in flat view before reaching the maximum relations limit. The default value is 5.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e456 ">glide.ui.max_relations</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d130086e459 "> <p class="p">Specifies the maximum number of related CIs to display.</p> <div class="p">When exceeded:<ul class="ul" id="c_CIRelationsFormatterNG__ul_zjp_xmp_jyb"><li class="li">A notification appears indicating that the limit has been reached, and that not all relations are displayed. The default value is 1000.</li><li class="li">Flat layout reverts to the tree layout view.</li></ul> </div> </td></tr></tbody></table> </div> </div> </div> <div class="related-links"> <ul class="ullinks"><li class="link ulchildlink"><strong><a href="../../../product/configuration-management/concept/domain-separation-relationship-formatter-editor.html">Domain separation and the relations formatter and the CI relationship editor</a></strong><br /> Domain separation is supported in the relations formatter and the CI relationship editor. <span class="ph">Domain separation enables you to separate data, processes, and administrative tasks into logical groupings called domains. You can control several aspects of this separation, including which users can see and access data.</span></li><li class="link ulchildlink"><strong><a href="../../../product/configuration-management/task/t_CreateRelationshipFilter.html">Create or edit a relationship filter</a></strong><br /> Create a custom relationship filter to display CI relationships from selected tables in the CI relations formatter.</li><li class="link ulchildlink"><strong><a href="../../../product/configuration-management/task/exclude-relationship.html">Exclude relationships from the relations formatter view</a></strong><br /> Create a list of relationships that should not appear in the relations formatter view on CI forms.</li><li class="link ulchildlink"><strong><a href="../../../administer/form-administration/reference/r_LegacyCIRelationsFormatter.html">Legacy CI relations formatter</a></strong><br /> On instances that do not meet the internet browser requirements for the latest CI relations formatter, the default CI form includes the legacy CI relations formatter instead.</li></ul> <div class="familylinks"> <div class="parentlink"><strong>Parent Topic:</strong> <a class="link" href="../../../product/configuration-management/concept/c_CIRelationships.html" title="The CMDB, in contrast to a static asset list, helps you track not only the configuration items (CIs) within your system, but also the relationships between those items.">CI relationships in the CMDB</a></div> </div> <div class="linklist relinfo relconcepts"><strong>Related concepts</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../../../product/configuration-management/concept/relationship-governance.html" title="Relationship governance rules is a set of relationship rules used to ensure consistency and validity in modeling relationships between configuration items (CIs) in the CMDB. Use relationship governance rules to prevent the selection of relationship types or directions that are not allowed between specific CI types.">Relationship governance rules</a></li><li class="linklist"><a class="link" href="../../../product/configuration-management/concept/c_RelationshipEditor.html" title="Use the relationship editor to view, create, modify, or delete CI relationships. Open the relationship editor from the CI Relations formatter.">CI relationship editor</a></li><li class="linklist"><a class="link" href="../../../product/configuration-management/concept/c_RelationQualifier.html" title="A relation qualifier, which is a CI of the Qualifier [cmdb_ci_qualifier] type, stores important information about the CI relationships.">Relation qualifier</a></li><li class="linklist"><a class="link" href="../../../product/configuration-management/concept/c_CIRelationshipSecurity.html" title="When applying security to CI relationships, it is important to apply the access controls both to the CI Relationship (cmdb_rel_ci) table and to create an operation editCIRelations to the * table as well.">CI relationship security</a></li></ul></div> <div class="linklist relinfo reltasks"><strong>Related tasks</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../../../product/configuration-management/task/t_AddANewSuggestedRelationship.html" title="Add a suggested relationship for a class. The list of suggested relationships for a class is available when you create a new relationship for a CI of that class.">Add a suggested relationship</a></li><li class="linklist"><a class="link" href="../../../product/configuration-management/task/t_CreateACIRelationRollup.html" title="A CI relation rollup allows you to sum, count, max, min, or mean a relationship type. You can create CI relation rollups.">Create a CI relation rollup</a></li><li class="linklist"><a class="link" href="../task/t_CreateRelationshipFilter.html" title="Create a custom relationship filter to display CI relationships from selected tables in the CI relations formatter.">Create or edit a relationship filter</a></li></ul></div> <div class="linklist relinfo relref"><strong>Related reference</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../../../product/configuration-management/reference/r_SuggestedRelationshipModel.html" title="The system keeps a table (Suggested Relationship [cmdb_rel_type_suggest]) of relationship types that are appropriate for a CI type, based on its class. You can manage suggested relationships by navigating to Configuration > Suggested Relationships , or in the CI Class Manager.">Suggested class relationships</a></li></ul></div> <div class="linklist relinfo"><strong>Related topics</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../administer/form-administration/task/t_CreateAFormatter.dita/t_CreateAFormatter.html" target="_blank" rel="noopener noreferrer">Create a formatter and add it to the form</a></li></ul></div> </div> </body></html></div>