Defining CI labels for a class
You can define the label that appears below each Configuration Item (CI) icon to help you identify that CI. In the BMC Atrium Explorer display pane, a label appears below each CI icon to help you identify that CI. The text of the label is the value of an attribute of the CI class. By default, BMC Atrium Explorer uses the
ShortDescription attribute of that CI, depending on its CI class, as listed in #Default attributes for CI labels.
When choosing new attributes to use for CI labels, select:
- Attributes that are likely to have clear values. Some attributes might have no values or values that are not descriptive of the CI.
- Attributes that allow you to identify CIs with fewer characters, because the default limit in BMC Atrium Explorer for CI labels is 32 characters. For example, avoid using the
Descriptionattribute, because the full description is likely to exceed the display limit. You can change the character limit as part of the BMC Atrium Explorer options, available in the BMC Atrium Explorer toolbar.
To define a CI label for a class
- Use the following direct access URL to open the BMC_UIComponent form:
- Create or modify an instance of
BMC_UIComponent, entering values for the following attributes.
When searching for existing
BMC_UIComponentinstances of a class, specify the
ClassLabelAttributefor the ComponentType field as part of your search criteria.
ClassId— Type BMC_UICOMPONENT.
ComponentType— Select ClassLabelAttribute.
ComponentRelatedClassId— The ID of the class to which this entry applies. The class ID is case sensitive, and might not be the same as the class name. For example, the class with a name of
BMC_BaseElementhas a class ID of BMC_ASSETBASE. For more information about the class ID of a specific class, see the BMC Atrium CMDB Data Model Help.
ComponentString— The attributes to use for CI labels, listed in order of preference. Separate attributes with a comma and a space. For example, enter
Description, Categoryto specify
Descriptionas the first attribute and
Categoryas the second attribute.
ComponentLocale— The locale for which this label is applied. When a client requests a locale for which there is no label defined, the en_US threshold is used.
CMDBRowLevelSecurity— Select the Public group.
- Save your changes.
New and changed CI labels are available to BMC Atrium Explorer within ten minutes. To make them available sooner, restart the mid tier. After waiting ten minutes or restarting the mid tier, reopen BMC Atrium Explorer.
Default attributes for CI labels
The type of CI determines its label:
- CIs that represent logical resources use the
- CIs that tend to have long, encoded names use the
Classes with a Name attribute label
Classes with a ShortDescription attribute label
A subclass uses the CI label settings of its superclass. For example, because the
BMC_System class uses the
ShortDescription attribute for CI labels, the
BMC_ComputerSystem class also uses the
Classes have a prioritized list of attributes for CI labels to ensure that every CI has a label in BMC Atrium Explorer. If the first attribute is empty, then BMC Atrium Explorer uses the second attribute, and so on. If all listed attributes are empty, then BMC Atrium Explorer displays the class name as the CI label. This ensures that the CI label is never empty.
You can configure different attributes to use for CI labels of a class by creating an instance of the BMC_UIComponent form for that class. By default, classes that use the
ShortDescription attribute for CI labels do so because they inherit that setting from a
BMC_UIComponent form entry for the
BMC_BaseElement class. Classes that use the
Name attribute have their own BMC_UIComponent form entries.